NAMN¶

busctl — Introspektera bussen

SYNOPSIS¶

busctl [FLAGGOR…] [KOMMANDO] [NAMN…]

BESKRIVNING¶

busctl kan användas för att introspektera och övervaka D-Bus-bussen.

KOMMANDON¶

Följande kommandon är kända:

list

status [TJÄNST]

monitor [TJÄNST…]

capture [TJÄNST…]

tree [TJÄNST…]

introspect TJÄNST OBJEKT [GRÄNSSNITT]

call TJÄNST OBJEKT GRÄNSSNITT METOD [SIGNATUR [ARGUMENT…]]

emit OBJEKT GRÄNSSNITT SIGNAL [SIGNATUR [ARGUMENT…]]

wait [TJÄNST] OBJEKT GRÄNSSNITT SIGNAL

get-property TJÄNST OBJEKT GRÄNSSNITT EGENSKAP…

set-property TJÄNST OBJEKT GRÄNSSNITT EGENSKAP SIGNATUR ARGUMENT…

help

FLAGGOR¶

Följande flaggor är kända:

--address=ADRESS

--show-machine

--unique

--acquired

--activatable

--match=MATCHNING

--size=

--list

-q, --quiet

--verbose

--xml-interface

--expect-reply=BOOL

--auto-start=BOOL

--allow-interactive-authorization=BOOL

--timeout=SEK

--limit-messages=ANTAL, -N ANTAL

--augment-creds=BOOL

--watch-bind=BOOL

--destination=TJÄNST

--user

--system

-H, --host=

-M, --machine=

-C, --capsule=

-l, --full

--json=LÄGE

-j

--no-pager

--no-legend

-h, --help

--version

PARAMETERFORMATERING¶

Kommandona call och set-property tar en signatursträng följd av en lista av parametrar formaterad som en sträng (för detaljer om D-Bus-signatursträngar, se Kapitlet typsystem i D-Bus-specificationen[2]). För enkla typer skall varje parameter som följer signaturen helt enkelt vara parameterns värde formaterat som en sträng. Positiva booleska värden kan formateras som ”true”, ”yes”, ”on” eller ”1”; negativa booleska värden kan angess som ”false”, ”no”, ”off” eller ”0”. For För vektorer skall ett numeriskt argument med antalet poster följt av posterna anges. För varianter skall signaturen för innehållet anges, följd av innehållet. För ordböcker (dictionaries) och poster skall innehållet i dem anges direkt.

Till exempel,

s jawoll

är formateringen av en enda sträng ”jawoll”.

as 3 hej världen apa

är formateringen av en strängvektor med tre poster, ”hej”, ”världen” och ”apa”.

a{sv} 3 Ett s Eins Två u 2 Ja b true

är formateringen av en ordboksvektor som avbildar strängar på varianter, bestående av tre poster. Strängen ”Ett” tilldelas strängen ”Eins”. Strängen ”Två” tilldelas det teckenlösa 32-bitars heltalet 2. Strängen ”Ja” tilldelas en positiv boolean.

Observera att kommandona call, get-property, introspect även kommer generera utdata i detta format som den returnerade datan. Eftersom detta format ibland är för kortfattat för att enkelt kunna förstås kan kommandona call och get-property generera en mer utförlig, flerradig utdata när de får flaggan --verbose.

EXEMPEL¶

Exempel 1. Skriv och läs en egenskap

Följande två kommandons skriver först en egenskap och läser sedan tillbaka den. Egenskapen finns på objektet ”/org/freedesktop/systemd1” i tjänsten ”org.freedesktop.systemd1”. Namnet på egenskapen är ”LogLevel” på gränssnittet ”org.freedesktop.systemd1.Manager”. Egenskapen innehåller en ensam sträng:

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

Exempel 2. Kortfattad och utförlig utskrift

De följande två kommandona läser en egenskap som innehåller en vektor av strängar, och visar först den på kortfattat format, följt av utförligt 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";
};

Exempel 3. Anrop av en metod

Följande kommandot anropar metoden ”StartUnit” på gränssnittet ”org.freedesktop.systemd1.Manager” i objektet ”/org/freedesktop/systemd1” i tjänsten ”org.freedesktop.systemd1”, och skickar två strängar till den ”cups.service” och ”replace”. Som ett resultat av metodanropet mottas och visas en ensam sökväg till ett objekt:

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

SE ÄVEN¶

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

NOTERINGAR¶

1.

PCAP Next Generation (pcapng) fångstfilformat

2.

Typsystemkapitlet i D-Bus-specifikationen

3.

D-Bus

ÖVERSÄTTNING¶

Den svenska översättningen av denna manualsida skapades av Göran Uddeborg <goeran@uddeborg.se>

Denna översättning är fri dokumentation; läs GNU General Public License Version 3 eller senare för upphovsrättsvillkor. Vi tar INGET ANSVAR.

Om du hittar fel i översättningen av denna manualsida, skicka ett mail till Tp-sv@listor.tp-sv.se.