Man page - busctl(1)

Packages contains this manual

Available languages:

en sv uk zh_TW zh_CN de

Manual

BUSCTL

NAMN
SYNOPSIS
BESKRIVNING
KOMMANDON
FLAGGOR
PARAMETERFORMATERING
EXEMPEL
SE ÄVEN
NOTERINGAR
ÖVERSÄTTNING

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

Visa alla partner pÄ bussen, efter deras tjÀnstenamn. som standard visas bÄde unika och vÀlkÀnda namn, men detta kan Àndras med flaggorna --unique och --acquired . Detta Àr standardÄtgÀrden om inget kommando anges.

Tillagd i version 209.

status [ TJÄNST ]

Visar processinformation och kreditiv för en busstjÀnst (om en anges med sitt unika eller vÀlkÀnda namn), en process (om en anges med sitt numeriska PID) Àgaren av bussen (om ingen parameter anges).

Tillagd i version 209.

monitor [ TJÄNST 
]

Skriv ut meddelanden som utbyts. Om TJÄNST anges, visa dĂ„ meddelanden till eller ifrĂ„n denna partner, identifierad med sitt vĂ€lkĂ€nda eller unika namn. Visa annars alla meddelanden pĂ„ bussen. AnvĂ€nd Ctrl+C för att avsluta utskriften.

Tillagd i version 209.

capture [ TJÄNST 
]

Liknar monitor men skriver utdata i pcapng-format (för detaljer, se PCAP Next Generation (pcapng) fÄngstfilformat [1] ). Se till att omdirigera standard ut till en fil eller ett rör. Verktyg som wireshark (1) kan anvÀndas för att dissekera och visa de resulterande filerna.

Tillagd i version 218.

tree [ TJÄNST 
]

Visar ett objekttrĂ€d över en eller flera tjĂ€nster. Om TJÄNST anges, visa dĂ„ objekttrĂ€det endast för den angivna tjĂ€nsten. Visa annars alla objekttrĂ€d för alla tjĂ€nster pĂ„ bussen som har förvĂ€rvat Ă„tminstone ett vĂ€lkĂ€nt namn.

Tillagd i version 218.

introspect TJÄNST OBJEKT [ GRÄNSSNITT ]

Visa grÀnssnitt, metoder, egenskaper och signaler för det angivna objektet (identifierat via dess sökvÀg) pÄ den angivna tjÀnsten. Om grÀnssnittsargumentet skickas Àr utdata begrÀnsad till medlemmar av det angivna grÀnssnittet.

Tillagd i version 218.

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

Anropa en metod och visa svaret. Tar ett tjÀnstenamn, en objektsökvÀg, ett grÀnssnittsnamn och ett metodnamn. Om parametrar skall skickas till metodanropet krÀvs en signaturstrÀng, följd av argumenten, vart och ett formaterat som strÀngar. För detaljer om formateringen som anvÀnds, se nedan. För att undertrycka utmatning av den returnerade datan, anvÀnd flaggan --quiet .

Tillagd i version 218.

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

Skicka en signal. Tar en objektsökvÀg, ett grÀnssnittsnamn och ett metodnamn. Om parametrar skall skickas krÀvs en signaturstrÀng, följd av argumenten, vart och ett formaterat som strÀngar. För detaljer om formateringen som anvÀnds, se nedan. För att ange mÄlet för signalen, anvÀnd flaggan --destination= .

Tillagd i version 242.

wait [ TJÄNST ] OBJEKT GRÄNSSNITT SIGNAL

VÀnta pÄ en signal. Tar en objektsökvÀg, ett grÀnssnittsnamn och ett signalnamn. För att undertrycka utmatning av den returnerade datan, anvÀnd flaggan --quiet \&. TjÀnstenamnet kan utelÀmnas, varvid busctl kommer matcha signaler frÄn godtycklig sÀndare.

Tillagd i version 257.

get-property TJÄNST OBJEKT GRÄNSSNITT EGENSKAP 


HÀmta det aktuella vÀrdet pÄ en eller flera objektegenskaper. Tar ett tjÀnstenamn, en objektsökvÀg, ett grÀnssnittsnamn och ett egenskapsnamn. Flera egenskaper kan anges samtidigt, dÄ deras vÀrden kommer visas efter varandra separerade av nyrader. Utdata Àr som standard i ett kortfattat format. AnvÀnd --verbose för ett mer utförligt utdataformat.

Tillagd i version 218.

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


SÀtt det aktuella vÀrdet pÄ en objektegenskap. Tar ett tjÀnstenamn, en objektsökvÀg, ett grÀnssnittsnamn och ett egenskapsnamn, en egenskapssignatur, följt av en lista av parametrar formaterade som strÀngar.

Tillagd i version 218.

help

Visa hjÀlp för kommandosyntaxen.

Tillagd i version 209.

FLAGGOR

Följande flaggor Àr kÀnda:

--address= ADRESS

Anslut till bussen som anges av ADRESS istÀllet för att anvÀnda passande standardvÀrden för antingen systembussen eller anvÀndarbussen (se flaggorna --system och --user ).

Tillagd i version 209.

--show-machine

NÀr en lista över partner visas, visa en kolumn som innehÄller namnen pÄ behÄllarna de tillhör. Se systemd-machined.service (8).

Tillagd i version 209.

--unique

NĂ€r en lista över partner visas, visa endast ”unika” namn (pĂ„ formen ”: nummer . nummer ”).

Tillagd i version 209.

--acquired

Motsatsen till --unique — endast ”vĂ€lkĂ€nda” namn kommer visas.

Tillagd i version 209.

--activatable

NÀr en lista av partner visas, visa endast partner vilka faktiskt inte har aktiverats Ànnu, men kan startas automatiskt ifall de kontaktas.

Tillagd i version 209.

--match= MATCHNING

NÀr meddelanden som utvÀxlas visas, visa endast delmÀngden som matchar MATCHNING . Se sd_bus_add_match (3).

Tillagd i version 209.

--size=

NÀr kommandot capture anvÀnds, ange det maximala bussmeddelandet som skall fÄngas ("snaplen"). Standard Àr 4096 byte.

Tillagd i version 218.

--list

NÀr kommandot tree anvÀnds, visa en flat lista av objektsökvÀgar istÀllet för ett trÀd.

Tillagd i version 218.

-q , --quiet

NÀr kommandot call anvÀnds, undertryck visning av svarsmeddelandens last. Observera att Àven om denna flagga anges kommer fortfarande fel som returneras att skrivas ut och verktyget kommer indikera om det gÄr eller inte med processens slutkod.

Tillagd i version 218.

--verbose

NÀr kommandot call eller get-property anvÀnds, visa utdata i ett mer utförligt format.

Tillagd i version 218.

--xml-interface

NÀr anropet introspect anvÀnds, dumpa XML-beskrivningen som mottas frÄn D-Bus-anropet org.freedesktop.DBus.Introspectable.Introspect istÀllet för den normala utdatan.

Tillagd i version 243.

--expect-reply= BOOL

NĂ€r kommandot call anvĂ€nds, ange huruvida busctl skall vĂ€nta pĂ„ att metodanropet avslutas, skriv ut metodens returnerade svarsdata och returnera om det gick eller inte via processens slutkod. Om detta sĂ€tts till ”no” kommer metodanropet att skickas men inget svar förvĂ€ntas, verktyget avslutar omedelbart, och inget svar kan alltsĂ„ visas, och ingen indikation om det gick eller inte returneras via slutstatusen. För att bara undertrycka utmatningen av svarmeddelandets last, anvĂ€nd --quiet ovan. StandardvĂ€rdet Ă€r ”yes”.

Tillagd i version 218.

--auto-start= BOOL

NĂ€r kommandot call eller emit anvĂ€nds, ange huruvida metodanropet implicit skall aktivera den anropade tjĂ€nsten ifall den inte kör Ă€nnu men Ă€r konfigureras att startas automatiskt. StandardvĂ€rdet Ă€r ”yes”.

Tillagd i version 218.

--allow-interactive-authorization= BOOL

NĂ€r kommandot call anvĂ€nds, ange huruvida tjĂ€nsterna kan framtvinga interaktiv auktorisering nĂ€r Ă„tgĂ€rden utförs, om sĂ€kerhetspolicyn Ă€r konfigurerad för detta. StandardvĂ€rdet Ă€r ”yes”.

Tillagd i version 218.

--timeout= SEK

NĂ€r kommandot call anvĂ€nds, ange den maximala tiden att vĂ€nta pĂ„ att ett anrop avslutas. NĂ€r kommandot monitor anvĂ€nds, frĂ„n version v257, ange den maximala tiden att vĂ€nta pĂ„ meddelanden innan automatiskt avslut. Om ingen tidsenhet anges antas sekunder. De vanliga andra enheterna förstĂ„s ocksĂ„ (ms, us, s, min, h, d, w, month, y). Observera att denna tidsgrĂ€ns inte gĂ€ller om --expect-reply=no anvĂ€nds, nĂ€r den kombineras med kommandot call , eftersom verktyget dĂ„ inte vĂ€ntar pĂ„ nĂ„got svarsmeddelande. NĂ€r det inte anges eller sĂ€tts till 0 antas standardvĂ€rdet ”25s” för kommandot the call , och det avaktiveras för kommandot monitor .

Tillagd i version 218.

--limit-messages= ANTAL , -N ANTAL

NÀr kommandot monitor anvÀnds, om det anges kommer busctl avsluta nÀr det angivna antalet meddelanden har tagits emot och skrivits ut. Detta Àr anvÀndbart i kombination med --match= , för att vÀnta pÄ det antivna antalet förekomster av ett visst D-Bus-meddelande.

Tillagd i version 257.

--augment-creds= BOOL

Styr huruvida kreditivdata rapporterade av list eller status skall kompletteras med data frĂ„n /proc/. NĂ€r detta Ă€r pĂ„slaget Ă€r möjligen den visade datan inkonsistent, eftersom de data som lĂ€ses frĂ„n /proc/ kan vara mer aktuella Ă€n resten av kreditivinformationen. StandardvĂ€rdet Ă€r ”yes”.

Tillagd i version 218.

--watch-bind= BOOL

Styr huruvida man skall vÀnta pÄ att det angivna AF_UNIX bussuttaget skall dyka upp i filsystemet före man ansluter till det. StandardvÀrdet Àr av. NÀr det Àr aktiverat kommer verktyget att övervaka filsystemet tills uttaget skapas och sedan ansluta till det.

Tillagd i version 237.

--destination= TJÄNST

Tar ett tjÀnstenamn. NÀr kommandot emit anvÀnds skickas en signal till den angivna tjÀnsten.

Tillagd i version 242.

--user

Tala med tjÀnstehanteraren för den anvÀndare som anropar, istÀllet för tjÀnstehanteraren för systemet.

--system

Tala med tjÀnstehanteraren för systemet. Detta Àr det implicita standardvÀrdet..

-H , --host=

Kör Ă„tgĂ€rden pĂ„ avstĂ„nd. Ange ett vĂ€rdnamn, eller ett anvĂ€ndarnamn och vĂ€rdnamn avdelade med ”@”, att ansluta till. VĂ€rdnamnet kan följas av ett suffix med en port dĂ€r ssh lyssnar, avdelat av ”:”, och sedan ett behĂ„llarnamn, avdelat av ”/”, vilket ansluter direkt till en specifik behĂ„llare pĂ„ den angivna vĂ€rden. Detta kommer anvĂ€nda SSH för att tala med fjĂ€rrmaskinens hanterarinstans. BehĂ„llarnamn kan rĂ€knas upp med machinectl -H VÄRD . Skriv IPv6-adresser i hakparenteser.

-M , --machine=

Utför Ă„gĂ€rderna pĂ„ en lokal behĂ„llare. Ange ett behĂ„llarnamn att ansluta till, eventuellt föregĂ„nget av ett anvĂ€ndarnamn att ansluta som och ett avdelande tecken ”@”. Om specialstrĂ€ngen ”.host” anvĂ€nds istĂ€llet för ett behĂ„llarnamn upprĂ€ttas en anslutning till det lokala systemet (vilket Ă€r anvĂ€ndbart för att ansluta till en viss anvĂ€ndares anvĂ€ndarbuss: ”--user --machine=lennart@.host”). Om syntaxen ”@” inte anvĂ€nds görs anslutningen som anvĂ€ndaren root. Om syntaxen ”@” kan antingen vĂ€nstersidan eller högersidan utelĂ€mnas (men inte bĂ„da) i vilket fall den lokala anvĂ€ndarens namn och ”.host” impliceras.

-C , --capsule=

Utför ÄtgÀrden pÄ en kapsel. Ange ett kapselnamn att ansluta till. Se capsule@.service (5) för detaljer om kapslar.

Tillagd i version 256.

-l , --full

Förkorta inte utdata med ellipser i kommandot list .

Tillagd i version 245.

--json= LÄGE

Visar utdata formaterad som JSON. FörvĂ€ntar sig en av ”short” (för den kortaste möjliga utdatan utan nĂ„gra reduntanta mellanslag eller nyrader), ”pretty” (för en snygg version av detsamma, med indentering och nyrader) eller ”off” (för att slĂ„ av JSON-utdata, standardvĂ€rdet).

-j

Ekvivalent med --json=pretty om man kör i en terminal, och --json=short annars.

--no-pager

Skicka inte utdata i ett rör till en blÀddrare.

--no-legend

Skriv inte ut rubriken, d.v.s. kolumnhuvuden och fötter med tips.

-h , --help

Skriv en kort hjÀlptext och avsluta.

--version

Skriv en kort versionsstrÀng och avsluta .

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

https://github.com/pcapng/pcapng/

2.

Typsystemkapitlet i D-Bus-specifikationen

https://dbus.freedesktop.org/doc/dbus-specification.html#type-system

3.

D-Bus

https://www.freedesktop.org/wiki/Software/dbus

Ö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 .