BUSCTL(1) busctl BUSCTL(1) NAMN busctl -- Introspektera bussen SYNOPSIS busctl [FLAGGOR] [KOMMANDO] [NAMN] BESKRIVNING busctl kan anvandas for att introspektera och overvaka D-Bus-bussen. KOMMANDON Foljande kommandon ar kanda: lista Visa alla partner pa bussen, efter deras tjanstenamn. som standard visas bade unika och valkanda namn, men detta kan andras med flaggorna --unique och --acquired. Detta ar standardatgarden om inget kommando anges. Tillagd i version 209. status [TJANST] Visar processinformation och kreditiv for en busstjanst (om en anges med sitt unika eller valkanda namn), en process (om en anges med sitt numeriska PID) agaren av bussen (om ingen parameter anges). Tillagd i version 209. monitor [TJANST] Skriv ut meddelanden som utbyts. Om TJANST anges, visa da meddelanden till eller ifran denna partner, identifierad med sitt valkanda eller unika namn. Visa annars alla meddelanden pa bussen. Anvand Ctrl+C for att avsluta utskriften. Tillagd i version 209. capture [TJANST] Liknar monitor men skriver utdata i pcapng-format (for detaljer, se PCAP Next Generation (pcapng) fangstfilformat[1]). Se till att omdirigera standard ut till en fil eller ett ror. Verktyg som wireshark(1) kan anvandas for att dissekera och visa de resulterande filerna. Tillagd i version 218. tree [TJANST] Visar ett objekttrad over en eller flera tjanster. Om TJANST anges, visa da objekttradet endast for den angivna tjansten. Visa annars alla objekttrad for alla tjanster pa bussen som har forvarvat atminstone ett valkant namn. Tillagd i version 218. introspect TJANST OBJEKT [GRANSSNITT] Visa granssnitt, metoder, egenskaper och signaler for det angivna objektet (identifierat via dess sokvag) pa den angivna tjansten. Om granssnittsargumentet skickas ar utdata begransad till medlemmar av det angivna granssnittet. Tillagd i version 218. call TJANST OBJEKT GRANSSNITT METOD [SIGNATUR [ARGUMENT]] Anropa en metod och visa svaret. Tar ett tjanstenamn, en objektsokvag, ett granssnittsnamn och ett metodnamn. Om parametrar skall skickas till metodanropet kravs en signaturstrang, foljd av argumenten, vart och ett formaterat som strangar. For detaljer om formateringen som anvands, se nedan. For att undertrycka utmatning av den returnerade datan, anvand flaggan --quiet. Tillagd i version 218. emit OBJEKT GRANSSNITT SIGNAL [SIGNATUR [ARGUMENT]] Skicka en signal. Tar en objektsokvag, ett granssnittsnamn och ett metodnamn. Om parametrar skall skickas kravs en signaturstrang, foljd av argumenten, vart och ett formaterat som strangar. For detaljer om formateringen som anvands, se nedan. For att ange malet for signalen, anvand flaggan --destination=. Tillagd i version 242. wait [TJANST] OBJEKT GRANSSNITT SIGNAL Vanta pa en signal. Tar en objektsokvag, ett granssnittsnamn och ett signalnamn. For att undertrycka utmatning av den returnerade datan, anvand flaggan --quiet\&. Tjanstenamnet kan utelamnas, varvid busctl kommer matcha signaler fran godtycklig sandare. Tillagd i version 257. get-property TJANST OBJEKT GRANSSNITT EGENSKAP Hamta det aktuella vardet pa en eller flera objektegenskaper. Tar ett tjanstenamn, en objektsokvag, ett granssnittsnamn och ett egenskapsnamn. Flera egenskaper kan anges samtidigt, da deras varden kommer visas efter varandra separerade av nyrader. Utdata ar som standard i ett kortfattat format. Anvand --verbose for ett mer utforligt utdataformat. Tillagd i version 218. set-property TJANST OBJEKT GRANSSNITT EGENSKAP SIGNATUR ARGUMENT Satt det aktuella vardet pa en objektegenskap. Tar ett tjanstenamn, en objektsokvag, ett granssnittsnamn och ett egenskapsnamn, en egenskapssignatur, foljt av en lista av parametrar formaterade som strangar. Tillagd i version 218. help Visa hjalp for kommandosyntaxen. Tillagd i version 209. FLAGGOR Foljande flaggor ar kanda: --address=ADRESS Anslut till bussen som anges av ADRESS istallet for att anvanda passande standardvarden for antingen systembussen eller anvandarbussen (se flaggorna --system och --user). Tillagd i version 209. --show-machine Nar en lista over partner visas, visa en kolumn som innehaller namnen pa behallarna de tillhor. Se systemd-machined.service(8). Tillagd i version 209. --unique Nar en lista over partner visas, visa endast "unika" namn (pa formen ":nummer.nummer"). Tillagd i version 209. --acquired Motsatsen till --unique -- endast "valkanda" namn kommer visas. Tillagd i version 209. --activatable Nar en lista av partner visas, visa endast partner vilka faktiskt inte har aktiverats annu, men kan startas automatiskt ifall de kontaktas. Tillagd i version 209. --match=MATCHNING Nar meddelanden som utvaxlas visas, visa endast delmangden som matchar MATCHNING. Se sd_bus_add_match(3). Tillagd i version 209. --size= Nar kommandot capture anvands, ange det maximala bussmeddelandet som skall fangas ("snaplen"). Standard ar 4096 byte. Tillagd i version 218. --list Nar kommandot tree anvands, visa en flat lista av objektsokvagar istallet for ett trad. Tillagd i version 218. -q, --quiet Nar kommandot call anvands, undertryck visning av svarsmeddelandens last. Observera att aven om denna flagga anges kommer fortfarande fel som returneras att skrivas ut och verktyget kommer indikera om det gar eller inte med processens slutkod. Tillagd i version 218. --verbose Nar kommandot call eller get-property anvands, visa utdata i ett mer utforligt format. Tillagd i version 218. --xml-interface Nar anropet introspect anvands, dumpa XML-beskrivningen som mottas fran D-Bus-anropet org.freedesktop.DBus.Introspectable.Introspect istallet for den normala utdatan. Tillagd i version 243. --expect-reply=BOOL Nar kommandot call anvands, ange huruvida busctl skall vanta pa att metodanropet avslutas, skriv ut metodens returnerade svarsdata och returnera om det gick eller inte via processens slutkod. Om detta satts till "no" kommer metodanropet att skickas men inget svar forvantas, verktyget avslutar omedelbart, och inget svar kan alltsa visas, och ingen indikation om det gick eller inte returneras via slutstatusen. For att bara undertrycka utmatningen av svarmeddelandets last, anvand --quiet ovan. Standardvardet ar "yes". Tillagd i version 218. --auto-start=BOOL Nar kommandot call eller emit anvands, ange huruvida metodanropet implicit skall aktivera den anropade tjansten ifall den inte kor annu men ar konfigureras att startas automatiskt. Standardvardet ar "yes". Tillagd i version 218. --allow-interactive-authorization=BOOL Nar kommandot call anvands, ange huruvida tjansterna kan framtvinga interaktiv auktorisering nar atgarden utfors, om sakerhetspolicyn ar konfigurerad for detta. Standardvardet ar "yes". Tillagd i version 218. --timeout=SEK Nar kommandot call anvands, ange den maximala tiden att vanta pa att ett anrop avslutas. Nar kommandot monitor anvands, fran version v257, ange den maximala tiden att vanta pa meddelanden innan automatiskt avslut. Om ingen tidsenhet anges antas sekunder. De vanliga andra enheterna forstas ocksa (ms, us, s, min, h, d, w, month, y). Observera att denna tidsgrans inte galler om --expect-reply=no anvands, nar den kombineras med kommandot call, eftersom verktyget da inte vantar pa nagot svarsmeddelande. Nar det inte anges eller satts till 0 antas standardvardet "25s" for kommandot the call, och det avaktiveras for kommandot monitor. Tillagd i version 218. --limit-messages=ANTAL, -N ANTAL Nar kommandot monitor anvands, om det anges kommer busctl avsluta nar det angivna antalet meddelanden har tagits emot och skrivits ut. Detta ar anvandbart i kombination med --match=, for att vanta pa det antivna antalet forekomster 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 fran /proc/. Nar detta ar paslaget ar mojligen den visade datan inkonsistent, eftersom de data som lases fran /proc/ kan vara mer aktuella an resten av kreditivinformationen. Standardvardet ar "yes". Tillagd i version 218. --watch-bind=BOOL Styr huruvida man skall vanta pa att det angivna AF_UNIX bussuttaget skall dyka upp i filsystemet fore man ansluter till det. Standardvardet ar av. Nar det ar aktiverat kommer verktyget att overvaka filsystemet tills uttaget skapas och sedan ansluta till det. Tillagd i version 237. --destination=TJANST Tar ett tjanstenamn. Nar kommandot emit anvands skickas en signal till den angivna tjansten. Tillagd i version 242. --user Tala med tjanstehanteraren for den anvandare som anropar, istallet for tjanstehanteraren for systemet. --system Tala med tjanstehanteraren for systemet. Detta ar det implicita standardvardet.. -H, --host= Kor atgarden pa avstand. Ange ett vardnamn, eller ett anvandarnamn och vardnamn avdelade med "@", att ansluta till. Vardnamnet kan foljas av ett suffix med en port dar ssh lyssnar, avdelat av ":", och sedan ett behallarnamn, avdelat av "/", vilket ansluter direkt till en specifik behallare pa den angivna varden. Detta kommer anvanda SSH for att tala med fjarrmaskinens hanterarinstans. Behallarnamn kan raknas upp med machinectl -H VARD. Skriv IPv6-adresser i hakparenteser. -M, --machine= Utfor agarderna pa en lokal behallare. Ange ett behallarnamn att ansluta till, eventuellt foreganget av ett anvandarnamn att ansluta som och ett avdelande tecken "@". Om specialstrangen ".host" anvands istallet for ett behallarnamn upprattas en anslutning till det lokala systemet (vilket ar anvandbart for att ansluta till en viss anvandares anvandarbuss: "--user --machine=lennart@.host"). Om syntaxen "@" inte anvands gors anslutningen som anvandaren root. Om syntaxen "@" kan antingen vanstersidan eller hogersidan utelamnas (men inte bada) i vilket fall den lokala anvandarens namn och ".host" impliceras. -C, --capsule= Utfor atgarden pa en kapsel. Ange ett kapselnamn att ansluta till. Se capsule@.service(5) for detaljer om kapslar. Tillagd i version 256. -l, --full Forkorta inte utdata med ellipser i kommandot list. Tillagd i version 245. --json=LAGE Visar utdata formaterad som JSON. Forvantar sig en av "short" (for den kortaste mojliga utdatan utan nagra reduntanta mellanslag eller nyrader), "pretty" (for en snygg version av detsamma, med indentering och nyrader) eller "off" (for att sla av JSON-utdata, standardvardet). -j Ekvivalent med --json=pretty om man kor i en terminal, och --json=short annars. --no-pager Skicka inte utdata i ett ror till en bladdrare. --no-legend Skriv inte ut rubriken, d.v.s. kolumnhuvuden och fotter med tips. -h, --help Skriv en kort hjalptext och avsluta. --version Skriv en kort versionsstrang och avsluta . PARAMETERFORMATERING Kommandona call och set-property tar en signaturstrang foljd av en lista av parametrar formaterad som en strang (for detaljer om D-Bus-signaturstrangar, se Kapitlet typsystem i D-Bus-specificationen[2]). For enkla typer skall varje parameter som foljer signaturen helt enkelt vara parameterns varde formaterat som en strang. Positiva booleska varden kan formateras som "true", "yes", "on" eller "1"; negativa booleska varden kan angess som "false", "no", "off" eller "0". For For vektorer skall ett numeriskt argument med antalet poster foljt av posterna anges. For varianter skall signaturen for innehallet anges, foljd av innehallet. For ordbocker (dictionaries) och poster skall innehallet i dem anges direkt. Till exempel, s jawoll ar formateringen av en enda strang "jawoll". as 3 hej varlden apa ar formateringen av en strangvektor med tre poster, "hej", "varlden" och "apa". a{sv} 3 Ett s Eins Tva u 2 Ja b true ar formateringen av en ordboksvektor som avbildar strangar pa varianter, bestaende av tre poster. Strangen "Ett" tilldelas strangen "Eins". Strangen "Tva" tilldelas det teckenlosa 32-bitars heltalet 2. Strangen "Ja" tilldelas en positiv boolean. Observera att kommandona call, get-property, introspect aven kommer generera utdata i detta format som den returnerade datan. Eftersom detta format ibland ar for kortfattat for att enkelt kunna forstas kan kommandona call och get-property generera en mer utforlig, flerradig utdata nar de far flaggan --verbose. EXEMPEL Exempel 1. Skriv och las en egenskap Foljande tva kommandons skriver forst en egenskap och laser sedan tillbaka den. Egenskapen finns pa objektet "/org/freedesktop/systemd1" i tjansten "org.freedesktop.systemd1". Namnet pa egenskapen ar "LogLevel" pa granssnittet "org.freedesktop.systemd1.Manager". Egenskapen innehaller en ensam strang: # 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 utforlig utskrift De foljande tva kommandona laser en egenskap som innehaller en vektor av strangar, och visar forst den pa kortfattat format, foljt av utforligt 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 Foljande kommandot anropar metoden "StartUnit" pa granssnittet "org.freedesktop.systemd1.Manager" i objektet "/org/freedesktop/systemd1" i tjansten "org.freedesktop.systemd1", och skickar tva strangar till den "cups.service" och "replace". Som ett resultat av metodanropet mottas och visas en ensam sokvag 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 AVEN dbus-daemon(1), D-Bus[3], sd-bus(3), varlinkctl(1), systemd(1), machinectl(1), wireshark(1) NOTERINGAR 1. PCAP Next Generation (pcapng) fangstfilformat 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 OVERSATTNING Den svenska oversattningen av denna manualsida skapades av Goran Uddeborg Denna oversattning ar fri dokumentation; las GNU General Public License Version 3 eller senare for upphovsrattsvillkor. Vi tar INGET ANSVAR. Om du hittar fel i oversattningen av denna manualsida, skicka ett mail till . systemd 259.1 BUSCTL(1)