busctl - Online nel cloud

PROGRAMMA:

NOME

busctl - Introspezione del bus

SINOSSI

busctl [OPZIONI...] [COMANDO] [NOME...]

DESCRIZIONE

busctl può essere utilizzato per analizzare e monitorare il bus D-Bus.

VERSIONI

Si intendono le seguenti opzioni:

--indirizzo=INDIRIZZO
Collegati al bus specificato da INDIRIZZO invece di usare impostazioni predefinite adatte per entrambi
il bus di sistema o utente (vedi --sistema ed --utente opzioni).

--macchina da spettacolo
Quando mostri l'elenco dei peer, mostra una colonna contenente i nomi dei contenitori che essi
appartiene a. Vedere systemd-machined.service(8).

--unico
Quando mostri l'elenco dei peer, mostra solo i nomi "unici" (della forma
":numero.numero").

--acquisite
Il contrario di --unico — verranno mostrati solo i nomi "noti".

--attivabile
Quando mostri l'elenco dei peer, mostra solo i peer che non sono stati effettivamente attivati
ancora, ma può essere avviato automaticamente in caso di accesso.

--corrispondenza=PARTITA
Quando mostri i messaggi scambiati, mostra solo il sottoinsieme corrispondente PARTITA.

--dimensione=
Se utilizzato con il catturare comando, specifica la dimensione massima del messaggio bus da catturare
("snaplin"). Il valore predefinito è 4096 byte.

--elenco
Se utilizzato con il albero comando, mostra un elenco semplice di percorsi di oggetti invece di un albero.

--silenzioso
Se utilizzato con il chiamata comando, sopprime la visualizzazione del payload del messaggio di risposta.
Si noti che anche se viene specificata questa opzione, gli errori restituiti verranno comunque stampati e
lo strumento indicherà l'esito positivo o negativo con il codice di uscita del processo.

--verboso
Se utilizzato con il chiamata or ottenere-proprietà comando, mostra l'output in modo più dettagliato
formato.

--expect-risposta=BOOL
Se utilizzato con il chiamata comando, specifica se busctl aspetterà il completamento di
la chiamata al metodo, emette i dati di risposta del metodo restituiti e restituisce il successo o
errore tramite il codice di uscita del processo. Se questo è impostato su "no", la chiamata al metodo sarà
emesso ma non è prevista alcuna risposta, lo strumento termina immediatamente e quindi no
può essere mostrata la risposta e non viene restituito alcun esito positivo o negativo tramite il codice di uscita. Per
sopprimere solo l'output del payload del messaggio di risposta, utilizzare --silenzioso sopra. Il valore predefinito è
"sì".

--avvio automatico=BOOL
Se utilizzato con il chiamata comando, specifica se la chiamata al metodo deve implicitamente
attivare il servizio chiamato, se non è ancora in esecuzione ma è configurato per essere
avviato automaticamente. Il valore predefinito è "sì".

--allow-autorizzazione-interattiva=BOOL
Se utilizzato con il chiamata comando, specifica se i servizi possono imporre
autorizzazione interattiva durante l'esecuzione dell'operazione, se la politica di sicurezza è
configurato per questo. Il valore predefinito è "sì".

--timeout=SECS
Se utilizzato con il chiamata comando, specifica il tempo massimo di attesa per la chiamata al metodo
completamento. Se non viene specificata alcuna unità di tempo, assume i secondi. Le solite altre unità sono
compreso (ms, us, s, min, h, d, w, month, y). Nota che questo timeout no
applicare se --expect-risposta=no viene utilizzato, poiché lo strumento non attende alcun messaggio di risposta
poi. Quando non è specificato o è impostato su 0, si assume il valore predefinito di "25s".

--augment-credits=BOOL
Controlla se i dati delle credenziali riportati da stratagemma or status deve essere aumentata con
dati da /proc. Quando è attivato, i dati mostrati potrebbero essere incoerenti, in quanto
i dati letti da / proc potrebbe essere più recente del resto della credenziale
informazione. Il valore predefinito è "sì".

--utente
Parlare con il responsabile del servizio dell'utente chiamante, piuttosto che con il responsabile del servizio di
il sistema.

--sistema
Parlare con il responsabile del servizio del sistema. Questa è l'impostazione predefinita implicita.

-H, --host=
Eseguire l'operazione da remoto. Specifica un nome host o un nome utente e un nome host
separati da "@", a cui connettersi. Il nome host può facoltativamente essere suffisso da a
nome del contenitore, separato da ":", che si collega direttamente a un contenitore specifico su
l'ospite specificato. Questo utilizzerà SSH per parlare con l'istanza del gestore della macchina remota.
I nomi dei contenitori possono essere enumerati con macchina ctl -H HOST.

-M, --macchina=
Eseguire l'operazione su un contenitore locale. Specificare un nome di contenitore a cui connettersi.

--no-cercapersone
Non reindirizzare l'output in un cercapersone.

--no-leggenda
Non stampare la legenda, ovvero le intestazioni di colonna e il piè di pagina con suggerimenti.

-h, --Aiuto
Stampa un breve testo di aiuto ed esci.

--versione
Stampa una stringa di versione breve ed esci.

COMANDI

Si intendono i seguenti comandi:

stratagemma
Mostra tutti i peer sul bus, con i loro nomi di servizio. Per impostazione predefinita, mostra sia univoco che
nomi ben noti, ma questo può essere cambiato con il --unico ed --acquisite interruttori.
Questa è l'operazione predefinita se non viene specificato alcun comando.

status [SERVIZIO]
Mostra le informazioni sul processo e le credenziali di un servizio di autobus (se ne è specificato uno)
nome univoco o noto), un processo (se specificato dal suo PID numerico) o il
proprietario del bus (se non è specificato alcun parametro).

monitore [SERVIZIO...]
Dump messaggi scambiati. Se SERVIZIO è specificato, mostra i messaggi da o verso questo
peer, identificato dal suo nome noto o univoco. Altrimenti, mostra tutti i messaggi sul
autobus. Usa Ctrl-C per terminare il dump.

catturare [SERVIZIO...]
Simile a monitore ma scrive l'output in formato pcap (per i dettagli, vedere il libpcap
Compila il Formato[1] descrizione. Assicurati di reindirizzare l'output a STDOUT in un file.
Strumenti come Wireshark(1) può essere utilizzato per sezionare e visualizzare i file generati.

albero [SERVIZIO...]
Mostra un albero di oggetti di uno o più servizi. Se SERVIZIO è specificato, mostra oggetto
albero dei soli servizi specificati. Altrimenti, mostra tutti gli alberi di oggetti di tutti i servizi
sull'autobus che ha acquisito almeno un nome noto.

introspettiva SERVIZIO OGGETTO [INTERFACCIA]
Mostra interfacce, metodi, proprietà e segnali dell'oggetto specificato (identificato
dal suo percorso) sul servizio specificato. Se viene passato l'argomento dell'interfaccia, l'output
è limitato ai membri dell'interfaccia specificata.

chiamata SERVIZIO OGGETTO INTERFACCIA METODO [FIRMA [ARGOMENTO...]]
Invocare un metodo e mostrare la risposta. Prende il nome di un servizio, il percorso dell'oggetto, l'interfaccia
nome e nome del metodo. Se i parametri devono essere passati alla chiamata del metodo, una firma
string è obbligatorio, seguito dagli argomenti, formattati individualmente come stringhe. Per
dettagli sulla formattazione utilizzata, vedere di seguito. Per sopprimere l'output dei dati restituiti,
Usa il --silenzioso opzione.

ottenere-proprietà SERVIZIO OGGETTO INTERFACCIA PROPRIETÀ...
Recupera il valore corrente di una o più proprietà dell'oggetto. Prende un nome di servizio,
percorso dell'oggetto, nome dell'interfaccia e nome della proprietà. È possibile specificare più proprietà in
una volta, nel qual caso i loro valori verranno mostrati uno dopo l'altro, separati da
nuove righe. L'output è, per impostazione predefinita, in formato conciso. Utilizzo --verboso per di più
formato di output elaborato.

set-proprietà SERVIZIO OGGETTO INTERFACCIA PROPRIETÀ FIRMA ARGOMENTO...
Imposta il valore corrente di una proprietà dell'oggetto. Prende il nome di un servizio, il percorso dell'oggetto,
nome dell'interfaccia, nome della proprietà, firma della proprietà, seguito da un elenco di parametri
formattati come stringhe.

Aiuto
Mostra la guida alla sintassi dei comandi.

PARAMETRO FORMATTAZIONE

I chiamata ed set-proprietà i comandi prendono una stringa di firma seguita da un elenco di
parametri formattati come stringa (per i dettagli sulle stringhe di firma D-Bus, vedere il Tipologia
sistema capitolo of , il autobus D specificazione[2]). Per i tipi semplici, ogni parametro che segue
la firma dovrebbe essere semplicemente il valore del parametro formattato come stringa. Booleano positivo
i valori possono essere formattati come "true", "yes", "on" o "1"; i valori booleani negativi possono essere
specificato come "false", "no", "off" o "0". Per gli array, un argomento numerico per il numero
di voci seguite dalle voci devono essere specificate. Per le varianti, la firma del
i contenuti devono essere specificati, seguiti dai contenuti. Per i dizionari e le strutture, il
il loro contenuto deve essere specificato direttamente.

Per esempio,

s mascella

è la formattazione di una singola stringa "jawoll".

come 3 ciao mondo foobar

è la formattazione di un array di stringhe con tre voci, "ciao", "mondo" e "foobar".

a{sv} 3 Uno s Eins Due u 2 Sì b vero

è la formattazione di un array di dizionario che associa le stringhe alle varianti, composto da tre
inserimenti. Alla stringa "Uno" viene assegnata la stringa "Eins". La stringa "Due" è assegnata al
Intero senza segno a 32 bit 2. Alla stringa "Sì" viene assegnato un valore booleano positivo.

Notare quello chiamata, ottenere-proprietà, introspettiva anche i comandi genereranno output in questo
formato per i dati restituiti. Poiché questo formato a volte è troppo conciso per essere facile
capito, il chiamata ed ottenere-proprietà i comandi possono generare un più prolisso, multilinea
uscita quando superato il --verboso opzione.

ESEMPI

Esempio 1. Scrivi ed Leggi a Immobili

I seguenti due comandi prima scrivono una proprietà e poi la rileggono. La proprietà è
trovato nell'oggetto "/org/freedesktop/systemd1" del servizio "org.freedesktop.systemd1".
Il nome della proprietà è "LogLevel" su "org.freedesktop.systemd1.Manager"
interfaccia. La proprietà contiene una singola stringa:

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

Esempio 2. Reverse ed verboso Uscita

I seguenti due comandi leggono una proprietà che contiene un array di stringhe, e prima
mostralo in formato conciso, seguito dal formato dettagliato:

$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Ambiente
come 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 Ambiente
ARRAY "s" {
STRING "LANG=en_US.UTF-8";
STRINGA "PERCORSO=/ usr / local / sbin:/ Usr / local / bin:/ usr / sbin:/ Usr / bin";
};

Esempio 3. Invocando a metodo

Il seguente comando richiama il metodo "StartUnit" sul
Interfaccia "org.freedesktop.systemd1.Manager" dell'oggetto "/org/freedesktop/systemd1" di
il servizio "org.freedesktop.systemd1" e gli passa due stringhe "cups.service" e
"sostituire". Come risultato della chiamata al metodo, viene ricevuto un singolo parametro di percorso dell'oggetto e
indicato:

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

Usa busctl online utilizzando i servizi onworks.net