busctl - Online în cloud

PROGRAM:

NUME

busctl - Introspectați autobuzul

REZUMAT

busctl [OPȚIUNI...] [COMANDĂ] [NUME...]

DESCRIERE

busctl poate fi folosit pentru a introspecta și a monitoriza autobuzul D-Bus.

OPŢIUNI

Se înțeleg următoarele opțiuni:

--adresa=ADRESA
Conectați-vă la autobuzul specificat de ADRESA în loc să folosiți valori implicite adecvate pentru oricare
magistrala de sistem sau de utilizator (vezi --sistem și --utilizator Opțiuni).

--mașină de spectacol
Când afișați lista de colegi, afișați o coloană care conține numele containerelor pe care le au
apartine. Vedea systemd-machined.service(8).

--unic
Când afișați lista de colegi, afișați numai nume „unice” (de forma
":număr.număr").

--achizitionat
Opusul --unic — vor fi afișate doar nume „cunoscute”.

--activabil
Când afișați lista de colegi, afișați numai colegii care de fapt nu au fost activați
încă, dar poate fi pornit automat dacă este accesat.

--match=MECI
Când afișați mesajele în curs de schimb, afișați doar subsetul care se potrivește MECI.

--dimensiune=
Când este utilizat cu captura comanda, specifică dimensiunea maximă a mesajului magistrală de capturat
(„snaplen”). Implicit la 4096 de octeți.

--listă
Când este utilizat cu copac comanda, afișează o listă plată de căi de obiecte în loc de un arbore.

--Liniște
Când este utilizat cu apel comanda, suprimă afișarea sarcinii utile a mesajului de răspuns.
Rețineți că, chiar dacă această opțiune este specificată, erorile returnate vor fi în continuare tipărite și
instrumentul va indica succesul sau eșecul cu codul de ieșire a procesului.

--verbos
Când este utilizat cu apel or obţine-proprietate comanda, afișează rezultatul într-un mod mai detaliat
format.

--așteptați-răspuns=BOOL
Când este utilizat cu apel comanda, specifică dacă busctl va aștepta finalizarea
apelul metodei, scoate datele de răspuns ale metodei returnate și returnează succesul sau
eșec prin codul de ieșire a procesului. Dacă acesta este setat la „nu”, apelul de metodă va fi
emis dar nu se așteaptă niciun răspuns, instrumentul se închide imediat și, prin urmare, nu
răspunsul poate fi afișat și niciun succes sau eșec nu este returnat prin codul de ieșire. La
suprimați numai ieșirea sarcinii utile a mesajului de răspuns, utilizați --Liniște de mai sus. Implicit la
"da".

--auto-start=BOOL
Când este utilizat cu apel comanda, specifică dacă apelul la metodă ar trebui implicit
activați serviciul apelat, dacă nu rulează încă, dar este configurat să fie
pornit automat. Implicit, „da”.

--allow-interactive-authorization=BOOL
Când este utilizat cu apel comanda, specifică dacă serviciile se pot aplica
autorizare interactivă în timpul executării operațiunii, dacă politica de securitate este
configurat pentru aceasta. Implicit, „da”.

--timeout=SECS
Când este utilizat cu apel comanda, specifică timpul maxim de așteptare pentru apelarea metodei
completare. Dacă nu este specificată nicio unitate de timp, se presupune secunde. Celelalte unități obișnuite sunt
înțeles, de asemenea (ms, us, s, min, h, d, w, month, y). Rețineți că acest timeout nu
aplica daca --expect-reply=nu este utilizat, deoarece instrumentul nu așteaptă niciun mesaj de răspuns
apoi. Când nu este specificat sau când este setat la 0, se presupune implicit „25s”.

--augment-creds=BOOL
Controlează dacă datele de acreditări sunt raportate de listă or Starea va fi completat cu
date din /proc. Când aceasta este activată, datele afișate sunt posibil inconsecvente, așa cum
datele citite din / proc ar putea fi mai recentă decât restul acreditării
informație. Implicit, „da”.

--utilizator
Discutați cu managerul de servicii al utilizatorului care apelează, mai degrabă decât cu managerul de servicii al
sistemul.

--sistem
Discutați cu managerul de service al sistemului. Acesta este implicit implicit.

-H, --gazdă=
Executați operația de la distanță. Specificați un nume de gazdă sau un nume de utilizator și un nume de gazdă
separate prin „@”, pentru a vă conecta. Numele de gazdă poate fi opțional sufixat cu a
numele containerului, separat prin „:”, care se conectează direct la un anumit container pe
gazda specificată. Aceasta va folosi SSH pentru a vorbi cu instanța de gestionare a mașinii de la distanță.
Numele containerelor pot fi enumerate cu machinectl -H HOST.

-M, --mașină=
Executați operația pe un container local. Specificați un nume de container la care să vă conectați.

--no-pager
Nu conductați ieșirea într-un pager.

--no-legendă
Nu tipăriți legenda, adică anteturile coloanei și subsolul cu indicii.

-h, --Ajutor
Imprimați un scurt text de ajutor și ieșiți.

--versiune
Imprimați un șir de versiune scurtă și ieșiți.

COMANDE

Următoarele comenzi sunt înțelese:

listă
Arată-le tuturor colegilor din autobuz, după numele serviciului lor. În mod implicit, arată atât unic, cât și
nume binecunoscute, dar acest lucru poate fi schimbat cu --unic și --achizitionat comutatoare.
Aceasta este operația implicită dacă nu este specificată nicio comandă.

Starea [SERVICIU]
Afișați informațiile de proces și acreditările unui serviciu de autobuz (dacă unul este specificat de acesta
nume unic sau bine-cunoscut), un proces (dacă unul este specificat prin PID-ul său numeric) sau
proprietarul magistralei (dacă nu este specificat niciun parametru).

monitorizează [SERVICIU...]
Mesajele de descărcare sunt schimbate. Dacă SERVICIU este specificat, afișați mesaje către sau de la acesta
peer, identificat prin numele său bine-cunoscut sau unic. În caz contrar, afișați toate mesajele de pe
autobuz. Folosiți Ctrl-C pentru a termina descărcarea.

captura [SERVICIU...]
similar monitorizează dar scrie rezultatul în format pcap (pentru detalii, consultați Libpcap
Fișier Format[1] descriere. Asigurați-vă că redirecționați ieșirea către STDOUT către un fișier.
Instrumente de genul Wireshark(1) poate fi folosit pentru a diseca și vizualiza fișierele generate.

copac [SERVICIU...]
Afișează un arbore de obiecte cu unul sau mai multe servicii. Dacă SERVICIU este specificat, arată obiectul
arborele numai a serviciilor specificate. În caz contrar, afișați toate arborele de obiecte ale tuturor serviciilor
în autobuzul care a căpătat cel puţin un nume cunoscut.

introspectiv SERVICIU OBIECT [INTERFAȚĂ]
Afișați interfețele, metodele, proprietățile și semnalele obiectului specificat (identificat
prin calea sa) pe serviciul specificat. Dacă argumentul interfeței este transmis, ieșirea
este limitat la membrii interfeței specificate.

apel SERVICIU OBIECT INTERFAȚĂ METODA [SEMNĂTURĂ [ARGUMENT...]]
Invocați o metodă și afișați răspunsul. Preia un nume de serviciu, cale de obiect, interfață
numele și numele metodei. Dacă parametrii vor fi transferați apelului de metodă, o semnătură
este necesar șir, urmat de argumente, formatate individual ca șiruri. Pentru
detalii despre formatarea utilizată, vezi mai jos. Pentru a suprima ieșirea datelor returnate,
utilizați --Liniște opțiune.

obţine-proprietate SERVICIU OBIECT INTERFAȚĂ PROPRIETATE...
Preluați valoarea curentă a uneia sau mai multor proprietăți ale obiectului. Ia un nume de serviciu,
calea obiectului, numele interfeței și numele proprietății. Proprietăți multiple pot fi specificate la
o dată, caz în care valorile lor vor fi afișate una după alta, separate prin
linii noi. Ieșirea este, implicit, în format concis. Utilizare --verbos pentru mai mult
format de ieșire elaborat.

set-proprietate SERVICIU OBIECT INTERFAȚĂ PROPRIETATE SEMNĂTURĂ ARGUMENT...
Setați valoarea curentă a proprietății unui obiect. Preia un nume de serviciu, calea obiectului,
numele interfeței, numele proprietății, semnătura proprietății, urmate de o listă de parametri
formatate ca șiruri de caractere.

ajutor
Afișați ajutorul pentru sintaxa comenzii.

PARAMETRI FORMATAREA

apel și set-proprietate comenzile au un șir de semnătură urmat de o listă de
parametri formatați ca șir (pentru detalii despre șirurile de semnătură D-Bus, consultați Tip
sistem capitol of il Autobuz D specificație[2]). Pentru tipurile simple, fiecare parametru urmează
semnătura ar trebui să fie pur și simplu valoarea parametrului formatată ca șir. Boolean pozitiv
valorile pot fi formatate ca „adevărat”, „da”, „activat” sau „1”; valorile booleene negative pot fi
specificat ca „fals”, „nu”, „dezactivat” sau „0”. Pentru matrice, un argument numeric pentru număr
se precizează numărul de înregistrări urmate de înregistrări. Pentru variante, semnătura
conținutul va fi specificat, urmat de conținut. Pentru dicționare și structuri,
conținutul acestora se specifică direct.

De exemplu,

maxilarul lui

este formatarea unui singur șir „jawoll”.

ca 3 alo lume foobar

este formatarea unei matrice de șiruri cu trei intrări, „hello”, „world” și „foobar”.

a{sv} 3 One s Eins Two u 2 Da b adevărat

este formatarea unui tablou de dicționar care mapează șiruri de caractere la variante, constând din trei
intrări. Șirului „One” i se atribuie șirul „Eins”. Șirului „Doi” i se atribuie
Număr întreg fără semn pe 32 de biți 2. Șirului „Da” i se atribuie un boolean pozitiv.

Rețineți că apel, obţine-proprietate, introspectiv comenzile vor genera, de asemenea, ieșire în aceasta
format pentru datele returnate. Deoarece acest format este uneori prea concis pentru a fi ușor
înțeles, cel apel și obţine-proprietate comenzile pot genera mai multe linii mai detaliate
ieșire când a trecut --verbos opțiune.

EXEMPLE

Exemplu 1. Scrie și Citeste a Proprietate

Următoarele două comenzi scriu mai întâi o proprietate și apoi o citesc înapoi. Proprietatea este
găsit pe obiectul „/org/freedesktop/systemd1” al serviciului „org.freedesktop.systemd1”.
Numele proprietății este „LogLevel” în „org.freedesktop.systemd1.Manager”
interfata. Proprietatea conține un singur șir:

# busctl set-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel s depanare
# busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel
s "depanare"

Exemplu 2. Concis și prolix producție

Următoarele două comenzi citesc o proprietate care conține o matrice de șiruri de caractere și mai întâi
arătați-l în format concis, urmat de format verboz:

$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Mediu
ca 2 „LANG=en_US.UTF-8” „PATH=/ usr / local / sbin:/ / Local / bin usr:/ usr / sbin:/ usr / bin"
$ busctl get-property --verbose org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Environment
MATRICE „s” {
ȘIRUL „LANG=en_US.UTF-8”;
ȘIR „PATH=/ usr / local / sbin:/ / Local / bin usr:/ usr / sbin:/ usr / bin";
};

Exemplu 3. Invocarea a Metodă

Următoarea comandă invocă metoda „StartUnit” pe
interfața „org.freedesktop.systemd1.Manager” a obiectului „/org/freedesktop/systemd1” al
serviciul „org.freedesktop.systemd1” și îi transmite două șiruri „cups.service” și
"a inlocui". Ca rezultat al apelului de metodă, este primit un singur parametru de cale obiect și
afișate:

# busctl apel org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager StartUnit ss „cups.service” „înlocuiește”
o „/org/freedesktop/systemd1/job/42684”

Utilizați busctl online folosind serviciile onworks.net