DBUS-TEST-TOOL(1) دستورهای کاربر DBUS-TEST-TOOL(1)

dbus-test-tool - ابزار آزمایش و بررسی ترافیک D-Bus

dbus-test-tool black-hole [--session | --system] [--name=NAME] [--no-read]

dbus-test-tool echo [--session | --system] [--name=NAME] [--sleep-ms=MS]

dbus-test-tool spam [--session | --system] [--dest=NAME] [--count=N] [--flood] [--ignore-errors] [--messages-per-conn=N] [--no-reply] [--queue=N] [--seed=SEED] [--string | --bytes | --empty] [--payload=S | --stdin | --message-stdin | --random-size]

دستور dbus-test-tool ابزاری چندمنظوره برای اشکال‌زدایی و تحلیل کارایی (پروفایلینگ) D-Bus است.

دستور dbus-test-tool black-hole به D-Bus متصل می‌شود، در صورت تمایل مالکیتی برای یک نام درخواست می‌کند، و سپس به هیچ پیامی پاسخ نمی‌دهد. این حالت در وضعیت معمول پیام‌ها را از سوکت D-Bus خود خوانده و دور می‌ریزد، اما می‌تواند به گونه‌ای پیکربندی شود که بدون خواندن پیام‌ها تا ابد متوقف شود (به خواب برود).

دستور dbus-test-tool echo به D-Bus متصل می‌شود، در صورت تمایل مالکیتی برای یک نام درخواست می‌کند، و سپس پس از یک تأخیر اختیاری، به هر فراخوانی متد یک پاسخ خالی می‌فرستد.

دستور dbus-test-tool spam به D-Bus متصل شده و فراخوانی‌های متد مکرری انجام می‌دهد که به طور معمول com.example.Spam نامیده می‌شوند.

--session

اتصال به گذرگاه نشست (Session Bus). این حالت پیش‌فرض است.

--system

اتصال به گذرگاه سیستم (System Bus).

--name=NAME

پیش از ادامه کار، مالکیت نام شناخته‌شده گذرگاه NAME (برای نمونه com.example.NoReply) را درخواست می‌کند. به طور پیش‌فرض، هیچ نامی درخواست نمی‌شود و به ابزار تنها می‌توان از طریق یک نام گذرگاه یکتا مانند :1.23 دسترسی پیدا کرد.

--no-read

از سوکت D-Bus خوانده نشود.

--name=NAME

پیش از ادامه کار، مالکیت نام شناخته‌شده گذرگاه NAME (برای نمونه com.example.Echo) را درخواست می‌کند. به طور پیش‌فرض، هیچ نامی درخواست نمی‌شود و به ابزار تنها می‌توان از طریق یک نام گذرگاه یکتا مانند :1.23 دسترسی پیدا کرد.

--sleep-ms=MS

پیش از پاسخ به یک فراخوانی متد، به مدت MS میلی‌ثانیه مسدود شود (مکث کند).

--dest=NAME

ارسال فراخوانی‌های متد به نام شناخته‌شده یا یکتای گذرگاه NAME. مقدار پیش‌فرض، دیمن گذرگاه dbus-daemon (یعنی org.freedesktop.DBus) است.

--count=N

ارسال مجموعاً N فراخوانی متد. مقدار پیش‌فرض ۱ است.

--queue=N

ارسال N فراخوانی متد پیش از انتظار برای هرگونه پاسخ، و سپس ارسال یک فراخوانی جدید به ازای هر پاسخ دریافت‌شده؛ بدین ترتیب همواره N فراخوانی متد در وضعیت «در جریان» (in flight) نگه داشته می‌شوند تا زمانی که تعداد کل پیام‌های مشخص‌شده با گزینه --count ارسال شوند. مقدار پیش‌فرض ۱ است، مگر اینکه از گزینه --flood استفاده شود.

--flood

ارسال همه پیام‌ها بدون انتظار برای پاسخ؛ معادل با استفاده از گزینه --queue همراه با یک مقدار دلخواه بسیار بزرگ برای N.

--no-reply

تنظیم فلگ «عدم نیاز به پاسخ» (no reply desired) بر روی پیام‌ها. این گزینه مستلزم --flood است، زیرا پاسخ‌هایی را که برای طول صف متناهی --queue به کار می‌روند غیرفعال می‌کند.

--messages-per-conn=N

در صورت تعیین، N فراخوانی متد را روی همان اتصال ارسال می‌کند، سپس اتصال را قطع کرده و دوباره متصل می‌شود. پیش‌فرض این است که برای تمامی فراخوانی‌های متد از همان یک اتصال استفاده شود.

--string

بار داده (payload) هر پیام یک رشته متنی UTF-8 باشد. این حالت پیش‌فرض است. رشته واقعی مورد استفاده توسط گزینه --payload یا --stdin تعیین می‌شود که مقدار پیش‌فرض آن "hello, world!" است.

--bytes

بار داده (payload) هر پیام یک آرایه بایت (byte-array) باشد. بایت‌های واقعی مورد استفاده توسط گزینه --payload یا --stdin تعیین می‌شود که مقدار پیش‌فرض آن کدگذاری اسکی (ASCII) عبارت "hello, world!" است.

--empty

پیام‌ها هیچ بار داده‌ای (payload) نداشته باشند.

--payload=S

استفاده از S به عنوان --string یا --bytes در پیام‌ها. مقدار پیش‌فرض "hello, world!" است.

--stdin

خواندن داده از ورودی استاندارد تا زمان رسیدن به پایان فایل (EOF)، و استفاده از آن به عنوان --string یا --bytes در پیام‌ها.

--message-stdin

خواندن یک پیام فراخوانی متد باینری (دودویی) کامل D-Bus از ورودی استاندارد، و استفاده از آن برای هر فراخوانی متد.

--random-size

خواندن اعداد ده‌دهی اسکی (ASCII) جداشده با نویسه‌های فاصله‌ساز از ورودی استاندارد، انتخاب تصادفی یکی از آن‌ها برای هر پیام، و ارسال پیامی که بار داده آن رشته‌ای به همان طول باشد.

--seed=SEED

استفاده از SEED به عنوان بذر (seed) برای مولد اعداد شبه‌تصادفی، به منظور تولید دنباله‌های نسبتاً تکرارپذیر از پیام‌های تصادفی.

لطفاً گزارش باگ‌ها را به سامانه ردیابی اشکال یا فهرست پستی D-Bus ارسال کنید. نگاه کنید به:

https://www.freedesktop.org/wiki/Software/dbus

نگاه کنید به:

https://dbus.freedesktop.org/doc/AUTHORS

dbus-send(1)

حق نشر © 2015 Collabora Ltd.

این صفحه راهنما تحت همان شرایط dbus-test-tool (مجوز GPL-2+) توزیع می‌شود. تا حد مجاز طبق قانون، هیچ‌گونه ضمانتی وجود ندارد.

03/02/2025 D-Bus 1.16.2