'\" t
.\"     Title: dbus-test-tool
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/02/2025
.\"    Manual: دستورهای کاربر
.\"    Source: D-Bus 1.16.2
.\"  Language: Persian
.\"
.TH "DBUS\-TEST\-TOOL" "1" "03/02/2025" "D\-Bus 1.16.2" "دستورهای کاربر"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
dbus-test-tool \- ابزار آزمایش و بررسی ترافیک D-Bus
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBdbus\-test\-tool\fR\ 'u
\fBdbus\-test\-tool\fR black\-hole [\-\-session | \-\-system] [\-\-name=\fINAME\fR] [\-\-no\-read]
.HP \w'\fBdbus\-test\-tool\fR\ 'u
\fBdbus\-test\-tool\fR echo [\-\-session | \-\-system] [\-\-name=\fINAME\fR] [\-\-sleep\-ms=\fIMS\fR]
.HP \w'\fBdbus\-test\-tool\fR\ 'u
\fBdbus\-test\-tool\fR spam [\-\-session | \-\-system] [\-\-dest=\fINAME\fR] [\-\-count=\fIN\fR] [\-\-flood] [\-\-ignore\-errors] [\-\-messages\-per\-conn=\fIN\fR] [\-\-no\-reply] [\-\-queue=\fIN\fR] [\-\-seed=\fISEED\fR] [\-\-string | \-\-bytes | \-\-empty] [\-\-payload=\fIS\fR | \-\-stdin | \-\-message\-stdin | \-\-random\-size]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBdbus\-test\-tool\fR
ابزاری چندمنظوره برای اشکال‌زدایی و تحلیل کارایی (پروفایلینگ) D\-Bus است.
.PP
دستور
\fBdbus\-test\-tool black\-hole\fR
به D\-Bus متصل می‌شود، در صورت تمایل مالکیتی برای یک نام درخواست می‌کند، و سپس به هیچ پیامی پاسخ نمی‌دهد. این حالت در وضعیت معمول پیام‌ها را از سوکت D\-Bus خود خوانده و دور می‌ریزد، اما می‌تواند به گونه‌ای پیکربندی شود که بدون خواندن پیام‌ها تا ابد متوقف شود (به خواب برود).
.PP
دستور
\fBdbus\-test\-tool echo\fR
به D\-Bus متصل می‌شود، در صورت تمایل مالکیتی برای یک نام درخواست می‌کند، و سپس پس از یک تأخیر اختیاری، به هر فراخوانی متد یک پاسخ خالی می‌فرستد.
.PP
دستور
\fBdbus\-test\-tool spam\fR
به D\-Bus متصل شده و فراخوانی‌های متد مکرری انجام می‌دهد که به طور معمول
\fBcom\&.example\&.Spam\fR
نامیده می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های عمومی (Common options)"
.PP
\fB\-\-session\fR
.RS 4
اتصال به گذرگاه نشست (Session Bus). این حالت پیش‌فرض است.
.RE
.PP
\fB\-\-system\fR
.RS 4
اتصال به گذرگاه سیستم (System Bus).
.RE
.SS "حالت سیاهچاله (black\-hole mode)"
.PP
\fB\-\-name=\fR\fINAME\fR
.RS 4
پیش از ادامه کار، مالکیت نام شناخته‌شده گذرگاه
\fINAME\fR
(برای نمونه
\fBcom\&.example\&.NoReply\fR)
را درخواست می‌کند. به طور پیش‌فرض، هیچ نامی درخواست نمی‌شود و به ابزار تنها می‌توان از طریق یک نام گذرگاه یکتا مانند
\fB:1\&.23\fR
دسترسی پیدا کرد.
.RE
.PP
\fB\-\-no\-read\fR
.RS 4
از سوکت D\-Bus خوانده نشود.
.RE
.SS "حالت پژواک (echo mode)"
.PP
\fB\-\-name=\fR\fINAME\fR
.RS 4
پیش از ادامه کار، مالکیت نام شناخته‌شده گذرگاه
\fINAME\fR
(برای نمونه
\fBcom\&.example\&.Echo\fR)
را درخواست می‌کند. به طور پیش‌فرض، هیچ نامی درخواست نمی‌شود و به ابزار تنها می‌توان از طریق یک نام گذرگاه یکتا مانند
\fB:1\&.23\fR
دسترسی پیدا کرد.
.RE
.PP
\fB\-\-sleep\-ms=\fR\fIMS\fR
.RS 4
پیش از پاسخ به یک فراخوانی متد، به مدت
\fIMS\fR
میلی‌ثانیه مسدود شود (مکث کند).
.RE
.SS "حالت ارسال انبوه (spam mode)"
.PP
\fB\-\-dest=\fR\fINAME\fR
.RS 4
ارسال فراخوانی‌های متد به نام شناخته‌شده یا یکتای گذرگاه
\fINAME\fR.
مقدار پیش‌فرض، دیمن گذرگاه
\fBdbus\-daemon\fR
(یعنی
\fBorg\&.freedesktop\&.DBus\fR)
است.
.RE
.PP
\fB\-\-count=\fR\fIN\fR
.RS 4
ارسال مجموعاً
\fIN\fR
فراخوانی متد. مقدار پیش‌فرض ۱ است.
.RE
.PP
\fB\-\-queue=\fR\fIN\fR
.RS 4
ارسال
\fIN\fR
فراخوانی متد پیش از انتظار برای هرگونه پاسخ، و سپس ارسال یک فراخوانی جدید به ازای هر پاسخ دریافت‌شده؛ بدین ترتیب همواره
\fIN\fR
فراخوانی متد در وضعیت «در جریان» (in flight) نگه داشته می‌شوند تا زمانی که تعداد کل پیام‌های مشخص‌شده با گزینه
\fB\-\-count\fR
ارسال شوند. مقدار پیش‌فرض ۱ است، مگر اینکه از گزینه
\fB\-\-flood\fR
استفاده شود.
.RE
.PP
\fB\-\-flood\fR
.RS 4
ارسال همه پیام‌ها بدون انتظار برای پاسخ؛ معادل با استفاده از گزینه
\fB\-\-queue\fR
همراه با یک مقدار دلخواه بسیار بزرگ برای
\fIN\fR.
.RE
.PP
\fB\-\-no\-reply\fR
.RS 4
تنظیم فلگ «عدم نیاز به پاسخ» (no reply desired) بر روی پیام‌ها. این گزینه مستلزم
\fB\-\-flood\fR
است، زیرا پاسخ‌هایی را که برای طول صف متناهی
\fB\-\-queue\fR
به کار می‌روند غیرفعال می‌کند.
.RE
.PP
\fB\-\-messages\-per\-conn=\fR\fIN\fR
.RS 4
در صورت تعیین،
\fIN\fR
فراخوانی متد را روی همان اتصال ارسال می‌کند، سپس اتصال را قطع کرده و دوباره متصل می‌شود. پیش‌فرض این است که برای تمامی فراخوانی‌های متد از همان یک اتصال استفاده شود.
.RE
.PP
\fB\-\-string\fR
.RS 4
بار داده (payload) هر پیام یک رشته متنی UTF\-8 باشد. این حالت پیش‌فرض است. رشته واقعی مورد استفاده توسط گزینه
\fB\-\-payload\fR
یا
\fB\-\-stdin\fR
تعیین می‌شود که مقدار پیش‌فرض آن "hello, world!" است.
.RE
.PP
\fB\-\-bytes\fR
.RS 4
بار داده (payload) هر پیام یک آرایه بایت (byte-array) باشد. بایت‌های واقعی مورد استفاده توسط گزینه
\fB\-\-payload\fR
یا
\fB\-\-stdin\fR
تعیین می‌شود که مقدار پیش‌فرض آن کدگذاری اسکی (ASCII) عبارت "hello, world!" است.
.RE
.PP
\fB\-\-empty\fR
.RS 4
پیام‌ها هیچ بار داده‌ای (payload) نداشته باشند.
.RE
.PP
\fB\-\-payload=\fR\fIS\fR
.RS 4
استفاده از
\fIS\fR
به عنوان
\fB\-\-string\fR
یا
\fB\-\-bytes\fR
در پیام‌ها. مقدار پیش‌فرض "hello, world!" است.
.RE
.PP
\fB\-\-stdin\fR
.RS 4
خواندن داده از ورودی استاندارد تا زمان رسیدن به پایان فایل (EOF)، و استفاده از آن به عنوان
\fB\-\-string\fR
یا
\fB\-\-bytes\fR
در پیام‌ها.
.RE
.PP
\fB\-\-message\-stdin\fR
.RS 4
خواندن یک پیام فراخوانی متد باینری (دودویی) کامل D\-Bus از ورودی استاندارد، و استفاده از آن برای هر فراخوانی متد.
.RE
.PP
\fB\-\-random\-size\fR
.RS 4
خواندن اعداد ده‌دهی اسکی (ASCII) جداشده با نویسه‌های فاصله‌ساز از ورودی استاندارد، انتخاب تصادفی یکی از آن‌ها برای هر پیام، و ارسال پیامی که بار داده آن رشته‌ای به همان طول باشد.
.RE
.PP
\fB\-\-seed=\fR\fISEED\fR
.RS 4
استفاده از
\fISEED\fR
به عنوان بذر (seed) برای مولد اعداد شبه‌تصادفی، به منظور تولید دنباله‌های نسبتاً تکرارپذیر از پیام‌های تصادفی.
.RE
.SH "گزارش باگ‌ها (BUGS)"
.PP
لطفاً گزارش باگ‌ها را به سامانه ردیابی اشکال یا فهرست پستی D\-Bus ارسال کنید\&. نگاه کنید به:
.PP
<https://www.freedesktop.org/wiki/Software/dbus>
.SH "نویسنده (AUTHOR)"
.PP
نگاه کنید به:
.PP
<https://dbus.freedesktop.org/doc/AUTHORS>
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBdbus\-send\fR(1)
.SH "حق نشر (COPYRIGHT)"
.br
حق نشر \(co 2015 Collabora Ltd.
.br
.PP
این صفحه راهنما تحت همان شرایط dbus\-test\-tool (مجوز GPL\-2+) توزیع می‌شود\&. تا حد مجاز طبق قانون، هیچ‌گونه ضمانتی وجود ندارد\&.
.sp