busctlsystemdA monkey with a typewriterZbigniewJędrzejewski-Szmekzbyszek@in.waw.plbusctl1busctlIntrospect the busbusctlOPTIONSCOMMANDNAMEDescriptionbusctl may be used to
introspect and monitor the D-Bus bus.OptionsThe following options are understood:Connect to the bus specified by
ADDRESS instead of using suitable
defaults for either the system or user bus (see
and
options).When showing the list of endpoints, show a
column containing the names of containers they belong to.
See
systemd-machined.service8.
When showing the list of endpoints, show
only "unique" names (of the form
:number.number).
The opposite of —
only "well-known" names will be shown.When showing the list of endpoints, show
only endpoints which have actually not been activated yet,
but may be started automatically if accessed.When showing messages being exchanged, show only the
subset matching MATCH.Do not print the legend,
i.e. the column headers and the
footer.When used with the capture command
specifies the maximum bus message size to capture
("snaplen"). Defaults to 4096 bytes.When used with the tree command shows a
flat list of object paths instead of a tree.When used with the call command suppresses
display of the response message.CommandsThe following commands are understood:listShow service names on the bus. This is the
default if no command is specified.statusSERVICEShow process information and credentials of a
bus service.monitorSERVICEDump messages being exchanged. If
SERVICE is specified, show messages
to or from this endpoint. Otherwise, show all messages on the
bus. Use Ctrl-C to terminate dump.captureSERVICESimilar to monitor but
writes the output in pcap format (for details see the Libpcap
File Format description. Make sure to redirect the
output to STDOUT to a file. Tools like
wireshark1
may be used to dissect and view the generated
files.treeSERVICEShows an object tree of one or more
services. If SERVICE is specified,
show object tree of the specified services only. Otherwise,
show all object trees of all services on the bus that acquired
at least one well-known name.introspectSERVICEOBJECTShow interfaces, methods, properties and
signals of the specified object (identified by its path) on
the specified service.callSERVICEOBJECTINTERFACEMETHODSIGNATUREARGUMENTInvoke a method and show the response. Takes a
service name, object path, interface name and method name. If
parameters shall be passed to the method call a signature
string is required, followed by the individual arguments,
individually formatted as textual parameters.get-propertySERVICEOBJECTINTERFACEPROPERTYRetrieve the current value one or more object
properties. Takes a service name and object path. Optionally
takes an interface name and property name. If the property
name is omited, shows all properties on the selected
interface. If the interface is also omitted shows the
properties of all interfaces. Multiple properties may be
specified at once in which case their values will be shown one
after the other.helpShow command syntax help.See Alsodbus-daemon1,
D-Bus,
kdbus,
sd-bus3,
systemd1,
systemd-bus-proxyd8,
machinectl1,
wireshark1