'\" t
.TH "BUSCTL" "1" "" "systemd 261.2" "busctl"
.\" -----------------------------------------------------------------
.\" * 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)"
busctl \- درون‌نگری و نظارت بر گذرگاه D-Bus
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBbusctl\fR\ 'u
\fBbusctl\fR [OPTIONS...] [COMMAND] [\fINAME\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBbusctl\fR
می‌تواند برای درون‌نگری و نظارت بر گذرگاه D\-Bus استفاده شود\&.
.SH "دستورات (COMMANDS)"
.PP
دستورات زیر پشتیبانی می‌شوند:
.PP
\fBlist\fR
.RS 4
نمایش تمامی همتایان (peers) روی گذرگاه بر اساس نام سرویس آن‌ها\&. به‌طور پیش‌فرض، هر دو نام‌های یکتا (unique) و شناخته‌شده (well\-known) را نمایش می‌دهد، اما این رفتار می‌تواند با سوییچ‌های
\fB\-\-unique\fR
و
\fB\-\-acquired\fR
تغییر کند\&. در صورت عدم تعیین دستور، این عملیات پیش‌فرض است\&.
.sp
افزوده شده در نگارش 209\&.
.RE
.PP
\fBstatus\fR [\fISERVICE\fR]
.RS 4
اطلاعات پردازش و اعتبارنامه‌های یک سرویس گذرگاه (در صورتی که با نام یکتا یا شناخته‌شده‌اش مشخص شده باشد)، یک پردازش (در صورتی که با PID عددی‌اش مشخص شده باشد)، یا مالک گذرگاه (در صورت عدم تعیین پارامتر) را نمایش می‌دهد\&.
.sp
افزوده شده در نگارش 209\&.
.RE
.PP
\fBmonitor\fR [\fISERVICE\fR...]
.RS 4
پیام‌های در حال مبادله را استخراج و نمایش می‌دهد (dump می‌کند)\&. اگر
\fISERVICE\fR
مشخص شده باشد، پیام‌های ارسالی به این همتا یا دریافتی از آن را که با نام شناخته‌شده یا یکتایش شناسانده شده، نمایش می‌دهد\&. در غیر این صورت، تمام پیام‌های روی گذرگاه را نمایش می‌دهد\&. برای پایان دادن به نمایش از
Ctrl+C
استفاده کنید یا با گزینهٔ
\fB\-\-limit\-messages=\fR
آن را محدود نمایید\&.
.sp
افزوده شده در نگارش 209\&.
.RE
.PP
\fBcapture\fR [\fISERVICE\fR...]
.RS 4
مشابه
\fBmonitor\fR
است اما خروجی را در قالب pcapng می‌نویسد (برای جزئیات، به
\m[blue]\fBقالب فایل ضبط PCAP نسل بعدی (pcapng)\fR\m[]\&\s-2\u[1]\d\s+2 مراجعه کنید)\&. حتماً خروجی استاندارد را به یک فایل یا لوله (pipe) هدایت کنید\&. ابزارهایی مانند
\fBwireshark\fR(1)
می‌توانند برای تحلیل و مشاهده فایل‌های حاصل استفاده شوند\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fBtree\fR [\fISERVICE\fR...]
.RS 4
درخت شیء (object tree) یک یا چند سرویس را نمایش می‌دهد\&. اگر
\fISERVICE\fR
مشخص شده باشد، فقط درخت شیء سرویس‌های مشخص‌شده را نمایش می‌دهد\&. در غیر این صورت، درخت شیء تمام سرویس‌های روی گذرگاه را که حداقل یک نام شناخته‌شده به دست آورده‌اند، نمایش می‌دهد\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fBintrospect\fR \fISERVICE\fR \fIOBJECT\fR [\fIINTERFACE\fR]
.RS 4
رابط‌ها، متدها، ویژگی‌ها و سیگنال‌های شیء مشخص‌شده (شناسایی‌شده با مسیر آن) روی سرویس مشخص‌شده را نمایش می‌دهد\&. در صورت ارسال آرگومان رابط، خروجی به اعضای رابط مشخص‌شده محدود می‌شود\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fBcall\fR \fISERVICE\fR \fIOBJECT\fR \fIINTERFACE\fR \fIMETHOD\fR [\fISIGNATURE\fR\ [\fIARGUMENT\fR...]]
.RS 4
یک متد را فراخوانی کرده و پاسخ را نمایش می‌دهد\&. یک نام سرویس، مسیر شیء، نام رابط و نام متد را می‌گیرد\&. اگر قرار است پارامترهایی به فراخوانی متد ارسال شوند، یک رشته امضا (signature string) الزامی است که پس از آن آرگومان‌ها که به‌صورت جداگانه در قالب رشته قالب‌بندی شده‌اند می‌آیند\&. برای جزئیات قالب‌بندی استفاده‌شده، به بخش زیر مراجعه کنید\&. برای جلوگیری از نمایش داده‌های بازگردانده‌شده، از گزینهٔ
\fB\-\-quiet\fR
استفاده کنید\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fBemit\fR \fIOBJECT\fR \fIINTERFACE\fR \fISIGNAL\fR [\fISIGNATURE\fR\ [\fIARGUMENT\fR...]]
.RS 4
یک سیگنال ساطع (منتشر) می‌کند\&. یک مسیر شیء، نام رابط و نام متد را می‌گیرد\&. اگر قرار است پارامترهایی ارسال شوند، یک رشته امضا الزامی است که پس از آن آرگومان‌ها که به‌صورت جداگانه در قالب رشته قالب‌بندی شده‌اند می‌آیند\&. برای جزئیات قالب‌بندی استفاده‌شده، به بخش زیر مراجعه کنید\&. برای تعیین مقصد سیگنال، از گزینهٔ
\fB\-\-destination=\fR
استفاده کنید\&.
.sp
افزوده شده در نگارش 242\&.
.RE
.PP
\fBwait\fR [\fISERVICE\fR] \fIOBJECT\fR \fIINTERFACE\fR \fISIGNAL\fR
.RS 4
منتظر یک سیگنال می‌ماند\&. یک مسیر شیء، نام رابط و نام سیگنال را می‌گیرد\&. برای انتظار برای بیش از یک سیگنال قبل از خروج، از گزینهٔ
\fB\-\-limit\-messages=\fR
استفاده کنید\&. برای جلوگیری از نمایش داده‌های بازگردانده‌شده، از گزینهٔ
\fB\-\-quiet\fR
استفاده کنید\&. نام سرویس را می‌توان نادیده گرفت، که در این صورت
\fBbusctl\fR
سیگنال‌های ارسالی از هر فرستنده‌ای را مطابقت خواهد داد\&.
.sp
افزوده شده در نگارش 257\&.
.RE
.PP
\fBget\-property\fR \fISERVICE\fR \fIOBJECT\fR \fIINTERFACE\fR \fIPROPERTY\fR...
.RS 4
مقدار فعلی یک یا چند ویژگی شیء را بازیابی می‌کند\&. یک نام سرویس، مسیر شیء، نام رابط و نام ویژگی را می‌گیرد\&. چند ویژگی را می‌توان به‌طور همزمان مشخص کرد که در این صورت مقادیر آن‌ها یکی پس از دیگری و جداشده با خطوط جدید نمایش داده می‌شوند\&. خروجی به‌طور پیش‌فرض در قالب مختصر است\&. برای قالب خروجی با جزئیات بیشتر از
\fB\-\-verbose\fR
استفاده کنید\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fBset\-property\fR \fISERVICE\fR \fIOBJECT\fR \fIINTERFACE\fR \fIPROPERTY\fR \fISIGNATURE\fR \fIARGUMENT\fR...
.RS 4
مقدار فعلی ویژگی یک شیء را تنظیم می‌کند\&. یک نام سرویس، مسیر شیء، نام رابط، نام ویژگی، امضای ویژگی و به‌دنبال آن فهرستی از پارامترهای قالب‌بندی‌شده به‌صورت رشته را می‌گیرد\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fBhelp\fR
.RS 4
راهنمای ساختار نحوی دستورات را نمایش می‌دهد\&.
.sp
افزوده شده در نگارش 209\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-address=\fR\fB\fIADDRESS\fR\fR
.RS 4
به گذرگاه مشخص‌شده با
\fIADDRESS\fR
متصل می‌شود، به‌جای اینکه از پیش‌فرض‌های مناسب برای گذرگاه سیستم یا کاربر استفاده کند (گزینه‌های
\fB\-\-system\fR
و
\fB\-\-user\fR
را ببینید)\&.
.sp
افزوده شده در نگارش 209\&.
.RE
.PP
\fB\-\-show\-machine\fR
.RS 4
هنگام نمایش فهرست همتایان، ستونی شامل نام کانتینرهایی که به آن‌ها تعلق دارند را نمایش می‌دهد\&. به
\fBsystemd-machined.service\fR(8)
مراجعه کنید\&.
.sp
افزوده شده در نگارش 209\&.
.RE
.PP
\fB\-\-unique\fR
.RS 4
هنگام نمایش فهرست همتایان، فقط نام‌های "یکتا" (به فرم
":\fInumber\fR\&.\fInumber\fR")
را نمایش می‌دهد\&.
.sp
افزوده شده در نگارش 209\&.
.RE
.PP
\fB\-\-acquired\fR
.RS 4
نقطهٔ مقابل
\fB\-\-unique\fR
\(em فقط نام‌های "شناخته‌شده" نمایش داده می‌شوند\&.
.sp
افزوده شده در نگارش 209\&.
.RE
.PP
\fB\-\-activatable\fR
.RS 4
هنگام نمایش فهرست همتایان، فقط همتایانی را نمایش می‌دهد که در واقع هنوز فعال نشده‌اند، اما در صورت دسترسی ممکن است به‌طور خودکار آغاز به کار کنند\&.
.sp
افزوده شده در نگارش 209\&.
.RE
.PP
\fB\-\-match=\fR\fB\fIMATCH\fR\fR
.RS 4
هنگام نمایش پیام‌های در حال مبادله، فقط زیرمجموعه‌ای را که با
\fIMATCH\fR
مطابقت دارد نمایش می‌دهد\&. به
\fBsd_bus_add_match\fR(3)
مراجعه کنید\&.
.sp
افزوده شده در نگارش 209\&.
.RE
.PP
\fB\-\-size=\fR
.RS 4
هنگامی که همراه با دستور
\fBcapture\fR
استفاده شود، حداکثر اندازهٔ پیام گذرگاه را برای ضبط تعیین می‌کند ("snaplen")\&. پیش‌فرض 4096 بایت است\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fB\-\-list\fR
.RS 4
هنگامی که همراه با دستور
\fBtree\fR
استفاده شود، یک فهرست تخت از مسیرهای اشیاء را به‌جای درخت نمایش می‌دهد\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
هنگامی که همراه با دستور
\fBcall\fR
استفاده شود، نمایش بار دادهٔ پیام پاسخ را فرومی‌نشاند\&. توجه داشته باشید که حتی در صورت تعیین این گزینه، خطاهای بازگردانده‌شده همچنان چاپ می‌شوند و ابزار موفقیت یا شکست را با کد خروج پردازش نشان می‌دهد\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fB\-\-verbose\fR
.RS 4
هنگامی که همراه با دستورهای
\fBcall\fR
یا
\fBget\-property\fR
استفاده شود، خروجی را در قالبی با جزئیات بیشتر نمایش می‌دهد\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fB\-\-xml\-interface\fR
.RS 4
هنگامی که با فراخوانی
\fBintrospect\fR
استفاده شود، توصیف XML دریافت شده از فراخوانی D\-Bus
\fBorg\&.freedesktop\&.DBus\&.Introspectable\&.Introspect\fR
را به‌جای خروجی عادی استخراج و نمایش می‌دهد\&.
.sp
افزوده شده در نگارش 243\&.
.RE
.PP
\fB\-\-expect\-reply=\fR\fB\fIBOOL\fR\fR
.RS 4
هنگامی که همراه با دستور
\fBcall\fR
استفاده شود، مشخص می‌کند آیا
\fBbusctl\fR
باید منتظر تکمیل فراخوانی متد بماند، داده‌های پاسخ متد بازگردانده‌شده را خروجی دهد، و موفقیت یا شکست را از طریق کد خروج پردازش بازگرداند یا خیر\&. اگر این مقدار روی
"no"
تنظیم شود، فراخوانی متد صادر می‌شود اما هیچ پاسخی انتظار نمی‌رود، ابزار بلافاصله خاتمه می‌یابد و بنابراین پاسخی قابل نمایش نخواهد بود و هیچ موفقیتی یا شکستی از طریق کد خروج بازگردانده نمی‌شود\&. برای صرفاً جلوگیری از نمایش بار دادهٔ پیام پاسخ، از گزینهٔ
\fB\-\-quiet\fR
در بالا استفاده کنید\&. پیش‌فرض
"yes"
است\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fB\-\-auto\-start=\fR\fB\fIBOOL\fR\fR
.RS 4
هنگامی که همراه با دستور
\fBcall\fR
یا
\fBemit\fR
استفاده شود، مشخص می‌کند که آیا فراخوانی متد باید سرویس فراخوانی‌شده را به‌طور ضمنی فعال کند، در صورتی که هنوز در حال اجرا نباشد اما برای شروع خودکار پیکربندی شده باشد\&. پیش‌فرض
"yes"
است\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fB\-\-allow\-interactive\-authorization=\fR\fB\fIBOOL\fR\fR
.RS 4
هنگامی که همراه با دستور
\fBcall\fR
استفاده شود، مشخص می‌کند که آیا در صورت پیکربندی سیاست امنیتی برای این منظور، سرویس‌ها می‌توانند در حین اجرای عملیات مجوزدهی تعاملی را اعمال کنند یا خیر\&. پیش‌فرض
"yes"
است\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fB\-\-timeout=\fR\fB\fISECS\fR\fR
.RS 4
هنگامی که همراه با دستور
\fBcall\fR
استفاده شود، حداکثر زمان انتظار برای تکمیل فراخوانی متد را تعیین می‌کند\&. هنگامی که همراه با دستور
\fBmonitor\fR
استفاده شود، از نسخه v257، حداکثر زمان انتظار برای پیام‌ها را قبل از خروج خودکار تعیین می‌کند\&. اگر واحد زمانی مشخص نشده باشد، ثانیه در نظر گرفته می‌شود\&. سایر واحدهای معمول نیز قابل فهم هستند (ms، us، s، min، h، d، w، month، y)\&. توجه داشته باشید در صورتی که گزینهٔ
\fB\-\-expect\-reply=no\fR
همراه با دستور
\fBcall\fR
استفاده شود این مهلت زمانی اعمال نخواهد شد، زیرا ابزار منتظر دریافت هیچ پیام پاسخی نمی‌ماند\&. در صورت عدم تعیین یا تنظیم روی 0، مقدار پیش‌فرض
"25s"
برای دستور
\fBcall\fR
در نظر گرفته می‌شود، و برای دستور
\fBmonitor\fR
غیرفعال است\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fB\-\-limit\-messages=\fR\fB\fINUMBER\fR\fR, \fB\-N \fR\fB\fINUMBER\fR\fR
.RS 4
هنگامی که همراه با دستور
\fBmonitor\fR
استفاده شود، در صورت فعال بودن باعث می‌شود
\fBbusctl\fR
پس از دریافت و چاپ تعداد پیام مشخص‌شده خارج شود\&. این در ترکیب با
\fB\-\-match=\fR،
برای انتظار برای تعداد رخداد مشخصی از پیام‌های خاص D\-Bus مفید است\&. در حالی که اگر مشخص نشده باشد یا روی مقدار ویژهٔ
"infinity"
تنظیم شود، پیش‌فرض ادامهٔ نظارت بدون محدودیت است\&.
.sp
هنگامی که همراه با دستور
\fBwait\fR
استفاده شود، باعث می‌شود
\fBbusctl\fR
پس از دریافت و چاپ تعداد مشخصی از سیگنال‌های DBus خارج شود\&. تنظیم آن روی مقدار ویژهٔ
"infinity"
باعث پایداری
\fBbusctl\fR
برای دریافت و چاپ پیوستهٔ سیگنال‌ها بدون محدودیت می‌شود\&. در صورت عدم تعیین، پیش‌فرض خروج فوری پس از دریافت و چاپ اولین سیگنال است\&.
.sp
افزوده شده در نگارش 257\&.
.RE
.PP
\fB\-\-augment\-creds=\fR\fB\fIBOOL\fR\fR
.RS 4
کنترل می‌کند که آیا داده‌های اعتبارنامه گزارش‌شده توسط
\fBlist\fR
یا
\fBstatus\fR
باید با داده‌های حاصل از
/proc/
تکمیل شوند یا خیر\&. هنگامی که این گزینه فعال باشد، داده‌های نمایش داده شده احتمالاً ناسازگار هستند، زیرا داده‌های خوانده‌شده از
/proc/
ممکن است تازه‌تر از بقیه اطلاعات اعتبارنامه باشند\&. پیش‌فرض
"yes"
است\&.
.sp
افزوده شده در نگارش 218\&.
.RE
.PP
\fB\-\-watch\-bind=\fR\fB\fIBOOL\fR\fR
.RS 4
کنترل می‌کند که آیا قبل از اتصال به سوکت گذرگاه
\fBAF_UNIX\fR
مشخص‌شده، منتظر ظاهر شدن آن در سیستم فایل بماند یا خیر\&. پیش‌فرض خاموش است\&. هنگامی که فعال باشد، ابزار سیستم فایل را تا زمان ایجاد سوکت نظارت کرده و سپس به آن متصل می‌شود\&.
.sp
افزوده شده در نگارش 237\&.
.RE
.PP
\fB\-\-destination=\fR\fB\fISERVICE\fR\fR
.RS 4
یک نام سرویس را می‌گیرد\&. هنگامی که همراه با دستور
\fBemit\fR
استفاده شود، یک سیگنال به سرویس مشخص‌شده ارسال می‌شود\&.
.sp
افزوده شده در نگارش 242\&.
.RE
.PP
\fB\-\-user\fR
.RS 4
به‌جای مدیر سرویس‌های سیستم، با مدیر سرویس‌های کاربر فراخواننده ارتباط برقرار می‌کند\&.
.RE
.PP
\fB\-\-system\fR
.RS 4
با مدیر سرویس‌های سیستم ارتباط برقرار می‌کند\&. این حالت پیش‌فرض ضمنی است\&.
.RE
.PP
\fB\-H\fR, \fB\-\-host=\fR
.RS 4
عملیات را از راه دور اجرا می‌کند\&. برای اتصال، یک نام میزبان یا یک نام کاربری و نام میزبان جداشده با
"@"
را مشخص کنید\&. نام میزبان می‌تواند به‌طور اختیاری با یک درگاه که ssh روی آن گوش می‌دهد، جداشده با
":"،
و سپس نام یک کانتینر، جداشده با
"/"
دنبال شود که مستقیماً به یک کانتینر خاص روی میزبان مشخص‌شده متصل می‌شود\&. این کار از SSH برای ارتباط با نمونهٔ مدیر ماشین راه دور استفاده می‌کند\&. نام‌های کانتینر را می‌توان با
\fBmachinectl \-H \fR\fB\fIHOST\fR\fR
فهرست کرد\&. نشانی‌های IPv6 را داخل کروشه قرار دهید\&.
.RE
.PP
\fB\-M\fR, \fB\-\-machine=\fR
.RS 4
عملیات را روی یک کانتینر محلی اجرا می‌کند\&. نام کانتینری را برای اتصال مشخص کنید، که به‌طور اختیاری با یک نام کاربری برای اتصال و نویسهٔ جداکنندهٔ
"@"
پیشوند می‌شود\&. اگر رشتهٔ ویژهٔ
"\&.host"
به‌جای نام کانتینر استفاده شود، اتصالی به سیستم محلی برقرار می‌شود (که برای اتصال به گذرگاه کاربری یک کاربر خاص مفید است:
"\-\-user \-\-machine=lennart@\&.host")\&.
اگر نحو
"@"
استفاده نشود، اتصال به‌عنوان کاربر ریشه برقرار می‌شود\&. اگر نحو
"@"
استفاده شود، می‌توان سمت چپ یا سمت راست را نادیده گرفت (اما نه هر دو را) که در این صورت نام کاربر محلی و
"\&.host"
ضمنی در نظر گرفته می‌شوند\&.
.RE
.PP
\fB\-C\fR, \fB\-\-capsule=\fR
.RS 4
عملیات را روی یک کپسول اجرا می‌کند\&. نام کپسولی را برای اتصال مشخص کنید\&. برای جزئیات در مورد کپسول‌ها به
\fBcapsule@.service\fR(5)
مراجعه کنید\&.
.sp
افزوده شده در نگارش 256\&.
.RE
.PP
\fB\-l\fR, \fB\-\-full\fR
.RS 4
خروجی دستور
\fBlist\fR
را خلاصه نمی‌کند\&.
.sp
افزوده شده در نگارش 245\&.
.RE
.PP
\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
خروجی را در قالب JSON نمایش می‌دهد\&. یکی از مقادیر زیر را می‌پذیرد:
"short"
(برای کوتاه‌ترین خروجی ممکن بدون هیچ فاصله یا شکست خط اضافی)،
"pretty"
(برای نگارش آراسته‌شده از همان خروجی، همراه با تورفتگی و شکست خط) یا
"off"
(برای خاموش کردن خروجی JSON، که حالت پیش‌فرض است)\&.
.RE
.PP
\fB\-j\fR
.RS 4
معادل
\fB\-\-json=pretty\fR
در صورت اجرا روی یک ترمینال، و
\fB\-\-json=short\fR
در غیر این صورت است\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند (pager) هدایت نمی‌کند\&.
.RE
.PP
\fB\-\-no\-legend\fR
.RS 4
راهنما را چاپ نمی‌کند، یعنی سرستون‌ها و پانوشت با نکات راهنما چاپ نمی‌شوند\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشتهٔ کوتاه نسخه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "پیکربندی پارامترها و بازگرداندن نوع داده (PARAMETER AND RETURN TYPES)"
.PP
دستورات
\fBcall\fR
و
\fBset\-property\fR
یک رشته امضا و به‌دنبال آن فهرستی از پارامترهای قالب‌بندی‌شده به‌صورت رشته را دریافت می‌کنند (برای جزئیات در مورد رشته‌های امضای D\-Bus، به
\m[blue]\fBفصل سامانهٔ انواع در مشخصات D\-Bus\fR\m[]\&\s-2\u[2]\d\s+2 مراجعه کنید)\&. برای انواع ساده، هر پارامتر پس از امضا باید صرفاً مقدار پارامتر قالب‌بندی‌شده به‌صورت رشته باشد\&. مقادیر بولی مثبت ممکن است به‌صورت
"true"،
"yes"،
"on" یا
"1" قالب‌بندی شوند؛ مقادیر بولی منفی ممکن است به‌صورت
"false"،
"no"،
"off" یا
"0" تعیین شوند\&. برای آرایه‌ها، یک آرگومان عددی برای تعداد ورودی‌ها و به‌دنبال آن خود ورودی‌ها باید مشخص شود\&. برای مقادیر متغیر (variants)، امضای محتویات و به‌دنبال آن خود محتویات باید مشخص شود\&. برای دیکشنری‌ها و ساختارها (structs)، محتویات آن‌ها باید مستقیماً مشخص گردد\&.
.PP
به‌عنوان مثال،
.sp
.if n \{\
.RS 4
.\}
.nf
s jawoll
.fi
.if n \{\
.RE
.\}
.sp
قالب‌بندی یک رشتهٔ منفرد
"jawoll" است\&.
.PP
.if n \{\
.RS 4
.\}
.nf
as 3 hello world foobar
.fi
.if n \{\
.RE
.\}
.sp
قالب‌بندی یک آرایهٔ رشته با سه ورودی
"hello"،
"world"
و
"foobar" است\&.
.PP
.if n \{\
.RS 4
.\}
.nf
a{sv} 3 One s Eins Two u 2 Yes b true
.fi
.if n \{\
.RE
.\}
.sp
قالب‌بندی یک آرایه دیکشنری است که رشته‌ها را به مقادیر متغیر نگاشت می‌کند و شامل سه ورودی است\&. به رشتهٔ
"One"
رشتهٔ
"Eins"
اختصاص داده شده است\&. به رشتهٔ
"Two"
عدد صحیح بدون علامت ۳۲ بیتی 2 اختصاص داده شده است\&. به رشتهٔ
"Yes"
یک مقدار بولی مثبت اختصاص داده شده است\&.
.PP
توجه داشته باشید که دستورات
\fBcall\fR،
\fBget\-property\fR،
و
\fBintrospect\fR
نیز برای داده‌های بازگردانده‌شده، خروجی را در همین قالب تولید خواهند کرد\&. از آنجایی که این قالب گاهی برای درک آسان بیش از حد مختصر است، دستورات
\fBcall\fR
و
\fBget\-property\fR
در صورت استفاده از گزینهٔ
\fB\-\-verbose\fR
می‌توانند خروجی چندخطی با جزئیات بیشتری تولید کنند\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&1.\ \&نوشتن و خواندن یک ویژگی\fR
.PP
دو دستور زیر ابتدا یک ویژگی را می‌نویسند و سپس آن را بازخوانی می‌کنند\&. ویژگی روی شیء
"/org/freedesktop/systemd1"
از سرویس
"org\&.freedesktop\&.systemd1"
یافت می‌شود\&. نام ویژگی
"LogLevel"
روی رابط
"org\&.freedesktop\&.systemd1\&.Manager"
است\&. ویژگی شامل یک رشتهٔ منفرد است:
.sp
.if n \{\
.RS 4
.\}
.nf
# busctl set\-property org\&.freedesktop\&.systemd1 /org/freedesktop/systemd1 org\&.freedesktop\&.systemd1\&.Manager LogLevel s debug
# busctl get\-property org\&.freedesktop\&.systemd1 /org/freedesktop/systemd1 org\&.freedesktop\&.systemd1\&.Manager LogLevel
s "debug"
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&2.\ \&خروجی مختصر و مفصل\fR
.PP
دو دستور زیر ویژگی‌ای را می‌خوانند که شامل آرایه‌ای از رشته‌ها است، و ابتدا آن را در قالب مختصر و سپس در قالب مفصل نمایش می‌دهند:
.sp
.if n \{\
.RS 4
.\}
.nf
$ busctl get\-property org\&.freedesktop\&.systemd1 /org/freedesktop/systemd1 org\&.freedesktop\&.systemd1\&.Manager Environment
as 2 "LANG=en_US\&.UTF\-8" "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin"
$ busctl get\-property \-\-verbose org\&.freedesktop\&.systemd1 /org/freedesktop/systemd1 org\&.freedesktop\&.systemd1\&.Manager Environment
ARRAY "s" {
        STRING "LANG=en_US\&.UTF\-8";
        STRING "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin";
};
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&3.\ \&فراخوانی یک متد\fR
.PP
دستور زیر متد
"StartUnit"
را روی رابط
"org\&.freedesktop\&.systemd1\&.Manager"
از شیء
"/org/freedesktop/systemd1"
مربوط به سرویس
"org\&.freedesktop\&.systemd1"
فراخوانی می‌کند و دو رشتهٔ
"cups\&.service"
و
"replace"
را به آن ارسال می‌نماید\&. در نتیجهٔ فراخوانی متد، یک پارامتر منفرد از نوع مسیر شیء دریافت شده و نمایش داده می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
# busctl call org\&.freedesktop\&.systemd1 /org/freedesktop/systemd1 org\&.freedesktop\&.systemd1\&.Manager StartUnit ss "cups\&.service" "replace"
o "/org/freedesktop/systemd1/job/42684"
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBdbus-daemon\fR(1), \m[blue]\fBD\-Bus\fR\m[]\&\s-2\u[3]\d\s+2, \fBsd-bus\fR(3), \fBvarlinkctl\fR(1), \fBsystemd\fR(1), \fBmachinectl\fR(1), \fBwireshark\fR(1)
.SH "نکات (NOTES)"
.IP " 1." 4
قالب فایل ضبط PCAP نسل بعدی (pcapng)
.RS 4
\%https://github.com/pcapng/pcapng
.RE
.IP " 2." 4
فصل سامانهٔ انواع در مشخصات D-Bus
.RS 4
\%https://dbus.freedesktop.org/doc/dbus-specification.html#type-system
.RE
.IP " 3." 4
D-Bus
.RS 4
\%https://www.freedesktop.org/wiki/Software/dbus
.RE