busctl - En ligne dans le Cloud

PROGRAMME:

Nom

busctl - Introspection du bus

SYNOPSIS

busctl [OPTIONS...] [COMMANDE] [Nom...]

DESCRIPTION

busctl peut être utilisé pour introspecter et surveiller le bus D-Bus.

OPTIONS

Les options suivantes sont comprises :

--adresse=ADRESSE
Connectez-vous au bus spécifié par ADRESSE au lieu d'utiliser des valeurs par défaut appropriées pour
le bus système ou utilisateur (voir --système ainsi que --utilisateur option).

--show-machine
Lorsque vous affichez la liste des pairs, affichez une colonne contenant les noms des conteneurs qu'ils
appartenir à. Voir systemd-usiné.service (8).

--unique
Lors de l'affichage de la liste des pairs, n'afficher que les noms « uniques » (de la forme
":nombre.nombre").

--acquis
L'opposé de --unique — seuls les noms « connus » seront affichés.

--activable
Lors de l'affichage de la liste des pairs, n'afficher que les pairs qui n'ont effectivement pas été activés
encore, mais peut être démarré automatiquement en cas d'accès.

--match=MATCH
Lors de l'affichage des messages en cours d'échange, n'afficher que le sous-ensemble correspondant MATCH.

--taille=
Lorsqu'il est utilisé avec capturer commande, spécifie la taille maximale du message de bus à capturer
("snaplen"). La valeur par défaut est de 4096 octets.

--liste
Lorsqu'il est utilisé avec arbre commande, affiche une liste plate de chemins d'objets au lieu d'un arbre.

--silencieux
Lorsqu'il est utilisé avec Appelez-nous commande, supprime l'affichage de la charge utile du message de réponse.
Notez que même si cette option est spécifiée, les erreurs renvoyées seront toujours imprimées et
l'outil indiquera le succès ou l'échec avec le code de sortie du processus.

--verbeux
Lorsqu'il est utilisé avec Appelez-nous or obtenir-propriété commande, affiche la sortie dans un plus détaillé
le format.

--expect-réponse=BOOL
Lorsqu'il est utilisé avec Appelez-nous commande, spécifie si busctl attendra la fin de
l'appel de méthode, afficher les données de réponse de méthode renvoyées et renvoyer le succès ou
échec via le code de sortie du processus. S'il est défini sur "non", l'appel de méthode sera
émis mais aucune réponse n'est attendue, l'outil se termine immédiatement, et donc aucun
La réponse peut être affichée et aucun succès ou échec n'est renvoyé via le code de sortie. À
supprimer uniquement la sortie de la charge utile du message de réponse, utilisez --silencieux dessus. Par défaut à
"Oui".

--démarrage automatique=BOOL
Lorsqu'il est utilisé avec Appelez-nous commande, spécifie si l'appel de méthode doit implicitement
activer le service appelé, s'il n'est pas encore en cours d'exécution mais est configuré pour être
démarré automatiquement. La valeur par défaut est « oui ».

--allow-interactive-authorization=BOOL
Lorsqu'il est utilisé avec Appelez-nous commande, spécifie si les services peuvent appliquer
autorisation interactive lors de l'exécution de l'opération, si la politique de sécurité est
configuré pour cela. La valeur par défaut est « oui ».

--timeout=SECS
Lorsqu'il est utilisé avec Appelez-nous commande, spécifie le temps maximum d'attente pour l'appel de méthode
achèvement. Si aucune unité de temps n'est spécifiée, prend en compte les secondes. Les autres unités habituelles sont
compris aussi (ms, us, s, min, h, d, w, month, y). Notez que ce délai d'attente ne
appliquer si --expect-reply=non est utilisé, car l'outil n'attend aucun message de réponse
alors. Lorsqu'il n'est pas spécifié ou lorsqu'il est défini sur 0, la valeur par défaut de « 25s » est prise en compte.

--augment-crédits=BOOL
Contrôle si les données d'identification rapportées par liste or statuts sera augmenté de
données de /proc. Lorsque cette option est activée, les données affichées sont peut-être incohérentes, car
les données lues depuis / proc peut être plus récent que le reste des informations d'identification
informations. La valeur par défaut est « oui ».

--utilisateur
Parlez au gestionnaire de services de l'utilisateur appelant plutôt qu'au gestionnaire de services de
le système.

--système
Parlez au responsable de service du système. Il s'agit de la valeur implicite par défaut.

-H, --hôte=
Exécutez l'opération à distance. Spécifiez un nom d'hôte, ou un nom d'utilisateur et un nom d'hôte
séparés par "@", pour se connecter. Le nom d'hôte peut éventuellement être suffixé par un
nom du conteneur, séparé par ":", qui se connecte directement à un conteneur spécifique sur
l'hôte spécifié. Cela utilisera SSH pour parler à l'instance de gestionnaire de machine distante.
Les noms de conteneurs peuvent être énumérés avec machinectl -H HÔTE.

-M, --machine=
Exécutez l'opération sur un conteneur local. Spécifiez un nom de conteneur auquel vous connecter.

--pas de téléavertisseur
Ne dirigez pas la sortie vers un pager.

--pas de légende
N'imprimez pas la légende, c'est-à-dire les en-têtes de colonnes et le pied de page avec des conseils.

-h, --Aidez-moi
Imprimez un court texte d'aide et quittez.

--version
Imprime une chaîne de version courte et quitte.

COMMANDES

Les commandes suivantes sont comprises :

liste
Afficher tous les pairs dans le bus, par leurs noms de service. Par défaut, affiche à la fois unique et
noms bien connus, mais cela peut être modifié avec le --unique ainsi que --acquis interrupteurs.
Il s'agit de l'opération par défaut si aucune commande n'est spécifiée.

statuts [SERVICE]
Afficher les informations de processus et les informations d'identification d'un service de bus (si celui-ci est spécifié par son
nom unique ou connu), un processus (s'il est spécifié par son PID numérique), ou le
propriétaire du bus (si aucun paramètre n'est spécifié).

moniteur [SERVICE...]
Vider les messages en cours d'échange. Si SERVICE est spécifié, afficher les messages vers ou depuis ce
homologue, identifié par son nom connu ou unique. Sinon, affichez tous les messages sur le
autobus. Utilisez Ctrl-C pour terminer le vidage.

capturer [SERVICE...]
Similaire à moniteur mais écrit la sortie au format pcap (pour plus de détails, voir le Libpcap
Déposez votre dernière attestation Format[1] descriptif. Assurez-vous de rediriger la sortie vers STDOUT vers un fichier.
Des outils comme Wireshark(1) peut être utilisé pour disséquer et visualiser les fichiers générés.

arbre [SERVICE...]
Affiche une arborescence d'objets d'un ou plusieurs services. Si SERVICE est spécifié, afficher l'objet
arborescence des services spécifiés uniquement. Sinon, affiche toutes les arborescences d'objets de tous les services
dans le bus qui a acquis au moins un nom connu.

introspecter SERVICE OBJET [INTERFACE]
Afficher les interfaces, les méthodes, les propriétés et les signaux de l'objet spécifié (identifié
par son chemin) sur le service spécifié. Si l'argument interface est passé, la sortie
est limité aux membres de l'interface spécifiée.

Appelez-nous SERVICE OBJET INTERFACE MÉTHODE [SIGNATURE [ARGUMENT...]]
Invoquez une méthode et affichez la réponse. Prend un nom de service, un chemin d'objet, une interface
nom et nom de la méthode. Si des paramètres doivent être passés à l'appel de méthode, une signature
string est obligatoire, suivi des arguments, formatés individuellement sous forme de chaînes. Pour
détails sur le formatage utilisé, voir ci-dessous. Pour supprimer la sortie des données renvoyées,
utiliser le --silencieux option.

obtenir-propriété SERVICE OBJET INTERFACE PROPRIÉTÉ
Récupérer la valeur actuelle d'une ou plusieurs propriétés d'objet. Prend un nom de service,
chemin de l'objet, nom de l'interface et nom de la propriété. Plusieurs propriétés peuvent être spécifiées à
une fois, auquel cas leurs valeurs seront affichées l'une après l'autre, séparées par
nouvelles lignes. La sortie est, par défaut, au format laconique. Utilisation --verbeux pour un plus
format de sortie élaboré.

ensemble-propriété SERVICE OBJET INTERFACE PROPRIÉTÉ SIGNATURE ARGUMENT
Définit la valeur actuelle d'une propriété d'objet. Prend un nom de service, un chemin d'objet,
nom de l'interface, nom de la propriété, signature de la propriété, suivi d'une liste de paramètres
formaté sous forme de chaînes.

aider
Afficher l'aide sur la syntaxe des commandes.

PARAMÈTRE MISE EN PAGE

La Appelez-nous ainsi que ensemble-propriété les commandes prennent une chaîne de signature suivie d'une liste de
paramètres formatés en chaîne (pour plus de détails sur les chaînes de signature D-Bus, voir le Type
combustion propre chapitre of le Autobus D spécification[2]). Pour les types simples, chaque paramètre suivant
la signature doit simplement être la valeur du paramètre formatée en chaîne. booléen positif
les valeurs peuvent être formatées comme "true", "yes", "on" ou "1" ; des valeurs booléennes négatives peuvent être
spécifié comme "false", "no", "off" ou "0". Pour les tableaux, un argument numérique pour le nombre
des entrées suivies des entrées doivent être spécifiées. Pour les variantes, la signature du
le contenu doit être spécifié, suivi du contenu. Pour les dictionnaires et les structures, le
leur contenu doit être directement spécifié.

Par exemple,

s mâchoire

est le formatage d'une seule chaîne "jawoll".

comme 3 hello world foobar

est le formatage d'un tableau de chaînes avec trois entrées, "hello", "world" et "foobar".

a{sv} 3 Un s Eins Deux u 2 Oui b vrai

est le formatage d'un tableau de dictionnaire qui mappe des chaînes à des variantes, composé de trois
entrées. La chaîne « One » est affectée de la chaîne « Eins ». La chaîne « Deux » se voit attribuer le
Entier 32 bits non signé 2. La chaîne "Oui" est affectée d'un booléen positif.

Notez que le Appelez-nous, obtenir-propriété, introspecter les commandes généreront également une sortie dans ce
format des données renvoyées. Étant donné que ce format est parfois trop laconique pour être facilement
compris, le Appelez-nous ainsi que obtenir-propriété les commandes peuvent générer un texte plus détaillé et multiligne
sortie lorsque passé le --verbeux option.

EXEMPLES

Exemple 1. Écrire ainsi que Lire a Biens immobiliers

Les deux commandes suivantes écrivent d'abord une propriété, puis la relisent. La propriété est
trouvé sur l'objet "/org/freedesktop/systemd1" du service "org.freedesktop.systemd1".
Le nom de la propriété est "LogLevel" sur le "org.freedesktop.systemd1.Manager"
interface. La propriété contient une seule chaîne :

# busctl set-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel s débogage
# busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel
s "déboguer"

Exemple 2. inverse ainsi que Verbeux Sortie

Les deux commandes suivantes lisent une propriété qui contient un tableau de chaînes, et d'abord
affichez-le au format laconique, suivi du format détaillé :

$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Environnement
comme 2 "LANG=en_US.UTF-8" "CHEMIN=/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin"
$ busctl get-property --verbose org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Environnement
TABLEAU "s" {
STRING "LANG=en_US.UTF-8" ;
CHAINE "CHEMIN=/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin";
};

Exemple 3. Invoquer a Method

La commande suivante appelle la méthode "StartUnit" sur le
Interface "org.freedesktop.systemd1.Manager" de l'objet "/org/freedesktop/systemd1" de
le service "org.freedesktop.systemd1", et lui passe deux chaînes "cups.service" et
"remplacer". À la suite de l'appel de méthode, un seul paramètre de chemin d'objet est reçu et
montré:

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

Utilisez busctl en ligne en utilisant les services onworks.net