نام (NAME)

busctl - درون‌نگری و نظارت بر گذرگاه D-Bus

خلاصه دستور (SYNOPSIS)

busctl [OPTIONS...] [COMMAND] [NAME...]

توضیحات (DESCRIPTION)

busctl می‌تواند برای درون‌نگری و نظارت بر گذرگاه D-Bus استفاده شود.

دستورات (COMMANDS)

دستورات زیر پشتیبانی می‌شوند:

list

status [SERVICE]

monitor [SERVICE...]

capture [SERVICE...]

tree [SERVICE...]

introspect SERVICE OBJECT [INTERFACE]

call SERVICE OBJECT INTERFACE METHOD [SIGNATURE [ARGUMENT...]]

emit OBJECT INTERFACE SIGNAL [SIGNATURE [ARGUMENT...]]

wait [SERVICE] OBJECT INTERFACE SIGNAL

get-property SERVICE OBJECT INTERFACE PROPERTY...

set-property SERVICE OBJECT INTERFACE PROPERTY SIGNATURE ARGUMENT...

help

گزینه‌ها (OPTIONS)

گزینه‌های زیر پشتیبانی می‌شوند:

--address=ADDRESS

--show-machine

--unique

--acquired

--activatable

--match=MATCH

--size=

--list

-q, --quiet

--verbose

--xml-interface

--expect-reply=BOOL

--auto-start=BOOL

--allow-interactive-authorization=BOOL

--timeout=SECS

--limit-messages=NUMBER, -N NUMBER

--augment-creds=BOOL

--watch-bind=BOOL

--destination=SERVICE

--user

--system

-H, --host=

-M, --machine=

-C, --capsule=

-l, --full

--json=MODE

-j

--no-pager

--no-legend

-h, --help

--version

پیکربندی پارامترها و بازگرداندن نوع داده (PARAMETER AND RETURN TYPES)

دستورات call و set-property یک رشته امضا و به‌دنبال آن فهرستی از پارامترهای قالب‌بندی‌شده به‌صورت رشته را دریافت می‌کنند (برای جزئیات در مورد رشته‌های امضای D-Bus، به فصل سامانهٔ انواع در مشخصات D-Bus[2] مراجعه کنید). برای انواع ساده، هر پارامتر پس از امضا باید صرفاً مقدار پارامتر قالب‌بندی‌شده به‌صورت رشته باشد. مقادیر بولی مثبت ممکن است به‌صورت "true"، "yes"، "on" یا "1" قالب‌بندی شوند؛ مقادیر بولی منفی ممکن است به‌صورت "false"، "no"، "off" یا "0" تعیین شوند. برای آرایه‌ها، یک آرگومان عددی برای تعداد ورودی‌ها و به‌دنبال آن خود ورودی‌ها باید مشخص شود. برای مقادیر متغیر (variants)، امضای محتویات و به‌دنبال آن خود محتویات باید مشخص شود. برای دیکشنری‌ها و ساختارها (structs)، محتویات آن‌ها باید مستقیماً مشخص گردد.

به‌عنوان مثال،

s jawoll

قالب‌بندی یک رشتهٔ منفرد "jawoll" است.

as 3 hello world foobar

قالب‌بندی یک آرایهٔ رشته با سه ورودی "hello"، "world" و "foobar" است.

a{sv} 3 One s Eins Two u 2 Yes b true

قالب‌بندی یک آرایه دیکشنری است که رشته‌ها را به مقادیر متغیر نگاشت می‌کند و شامل سه ورودی است. به رشتهٔ "One" رشتهٔ "Eins" اختصاص داده شده است. به رشتهٔ "Two" عدد صحیح بدون علامت ۳۲ بیتی 2 اختصاص داده شده است. به رشتهٔ "Yes" یک مقدار بولی مثبت اختصاص داده شده است.

توجه داشته باشید که دستورات call، get-property، و introspect نیز برای داده‌های بازگردانده‌شده، خروجی را در همین قالب تولید خواهند کرد. از آنجایی که این قالب گاهی برای درک آسان بیش از حد مختصر است، دستورات call و get-property در صورت استفاده از گزینهٔ --verbose می‌توانند خروجی چندخطی با جزئیات بیشتری تولید کنند.

مثال‌ها (EXAMPLES)

مثال 1. نوشتن و خواندن یک ویژگی

دو دستور زیر ابتدا یک ویژگی را می‌نویسند و سپس آن را بازخوانی می‌کنند. ویژگی روی شیء "/org/freedesktop/systemd1" از سرویس "org.freedesktop.systemd1" یافت می‌شود. نام ویژگی "LogLevel" روی رابط "org.freedesktop.systemd1.Manager" است. ویژگی شامل یک رشتهٔ منفرد است:

# 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"

مثال 2. خروجی مختصر و مفصل

دو دستور زیر ویژگی‌ای را می‌خوانند که شامل آرایه‌ای از رشته‌ها است، و ابتدا آن را در قالب مختصر و سپس در قالب مفصل نمایش می‌دهند:

$ 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";
};

مثال 3. فراخوانی یک متد

دستور زیر متد "StartUnit" را روی رابط "org.freedesktop.systemd1.Manager" از شیء "/org/freedesktop/systemd1" مربوط به سرویس "org.freedesktop.systemd1" فراخوانی می‌کند و دو رشتهٔ "cups.service" و "replace" را به آن ارسال می‌نماید. در نتیجهٔ فراخوانی متد، یک پارامتر منفرد از نوع مسیر شیء دریافت شده و نمایش داده می‌شود:

# busctl call org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager StartUnit ss "cups.service" "replace"
o "/org/freedesktop/systemd1/job/42684"

همچنین ببینید (SEE ALSO)

dbus-daemon(1), D-Bus[3], sd-bus(3), varlinkctl(1), systemd(1), machinectl(1), wireshark(1)

نکات (NOTES)

1.

قالب فایل ضبط PCAP نسل بعدی (pcapng)

2.

فصل سامانهٔ انواع در مشخصات D-Bus

3.

D-Bus