BEZEICHNUNG¶

busctl - Den Bus prüfen

ÜBERSICHT¶

busctl [OPTIONEN…] [BEFEHL] [NAME…]

BESCHREIBUNG¶

busctl kann zum Prüfen und Überwachen des D-Bus-Busses verwandt werden.

BEFEHLE¶

Die folgenden Befehle werden verstanden:

list

status [DIENST]

monitor [DIENST…]

capture [DIENST…]

tree [DIENST…]

introspect DIENST OBJEKT [SCHNITTSTELLE]

call DIENST OBJEKT SCHNITTSTELLE METHODE [SIGNATUR [ARGUMENT…]]

emit OBJEKT SCHNITTSTELLE SIGNAL [SIGNATURE [ARGUMENT…]]

wait [DIENST] OBJEKT SCHNITTSTELLE SIGNAL

get-property DIENST OBJEKT SCHNITTSTELLE EIGENSCHAFT…

set-property DIENST OBJEKT SCHNITTSTELLE EIGENSCHAFT SIGNATUR ARGUMENT…

help

OPTIONEN¶

Die folgenden Optionen werden verstanden:

--address=ADRESSE

--show-machine

--unique

--acquired

--activatable

--match=TREFFER

--size=

--list

-q, --quiet

--verbose

--xml-interface

--json=MODUS

-j

--expect-reply=LOGISCH

--auto-start=LOGISCH

--allow-interactive-authorization=LOGISCH

--timeout=SEK

--limit-messages=ANZAHL, -N ANZAHL

--augment-creds=LOGISCH

--watch-bind=LOGISCH

--destination=DIENST

--user

--system

-H, --host=

-M, --machine=

-C, --capsule=

-l, --full

--no-pager

--no-legend

-h, --help

--version

PARAMETERFORMATIERUNG¶

Die Befehle call und set-property akzeptieren eine Signaturzeichenkette, gefolgt von einer Liste von als Zeichenketten formatierten Parametern (für Details über D-Bus-Signaturzeichenketten siehe das Typesystemkapitel der D-Bus-Spezifikation[2]). Für einfache Typen sollte jeder der Signatur folgenden Parameter einfach der als Zeichenkette formatierte Parameter sein. Positive logische Werte können als »true«, yes«, »on« oder »1«, negative logische Werte können als »false«, »no«, »off« oder »0« angegeben sein. Für Felder soll ein numerisches Argument für die Anzahl der Einträge gefolgt von den Einträgen angegeben werden. Für Varianten soll die Signatur der Einträge, gefolgt von den Inhalten, angegeben werden. Für Wörterbücher und Strukturen sollen die Einträge direkt angegeben werden.

Beispielsweise ist

s jawoll

die Formatierung einer einzelnen Zeichenkette »jawoll«.

as 3 Hallo Welt foobar

ist die Formatierung eines Zeichenkettenfeldes mit den drei Einträgen »Hallo«, »Welt« und »foobar«.

a{sv} 3 Eins s One Zwei u 2 Ja b true

ist die Formatierung eines Wörterbuchfeldes, das Zeichenketten auf Varianten abbildet und aus drei Einträgen besteht. Der Zeichenkette »Eins« wird »One« zugeordnet. Der Zeichenkette »Zwei« wird die vorzeichenfreie 32-Bit-Ganzzahl 2 zugeordnet. Der Zeichenkette »Ja« wird ein positiver logischer Wert zugeordnet.

Beachten Sie, dass die Befehle call, get-property, introspect auch Ausgaben für die zurückgelieferten Daten in diesem Format erstellen. Da dieses Format manchmal zu knapp und daher nicht immer leicht verständlich ist, können die Befehle call und get-property eine ausführlichere, mehrzeilige Ausgabe, wenn die Option --verbose übergeben wird, erzeugen.

BEISPIELE¶

Beispiel 1. Eine Eigenschaft lesen und schreiben

Die folgenden zwei Befehle schreiben zuerst eine Eigenschaft und lesen sie dann zurück. Die Eigenschaft wird im Objekt »/org/freedesktop/systemd1« des Dienstes »org.freedesktop.systemd1« gefunden. Der Name der Eigenschaft ist »LogLevel« auf der Schnittstelle »org.freedesktop.systemd1.Manager«. Die Eigenschaft enthält eine einzelne Zeichenkette:

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

Beispiel 2. Knappe und ausführliche Ausgabe

Die folgenden zwei Befehle lesen eine Eigenschaft, die ein Feld von Zeichenketten enthält, und zeigen sie zuerst in einem knappen, gefolgt von einem ausführlichen Format:

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

Beispiel 3. Eine Methode aufrufen

Die folgenden Befehle rufen die Methode »StartUnit« auf der Schnittstelle »org.freedesktop.systemd1.Manager« des Objektes »/org/freedesktop/systemd1« des Dienstes »org.freedesktop.systemd1« auf und übergeben ihr zwei Zeichenketten »cups.service« und »replace«. Als Ergebnis des Methodenaufrufs wird ein einzelnes Pfadparameterobjekt empfangen und angezeigt:

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

SIEHE AUCH¶

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

ANMERKUNGEN¶

1.

Dateierfassungsformat PCAP Nächste Generation (pcapng)

2.

Typsystemkapitel der D-Bus-Spezifikation

3.

D-Bus

ÜBERSETZUNG¶

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.