busctl — Introspect the bus
busctl [OPTIONS...] [COMMAND] [
busctl may be used to introspect and monitor the D-Bus bus.
The following options are understood:
Connect to the bus specified by
ADDRESS instead of using suitable
defaults for either the system or user bus (see
When showing the list of endpoints, show a column containing the names of containers they belong to. See systemd-machined.service(8).
When showing the list of endpoints, show
only "unique" names (of the form
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
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.
Execute the operation remotely. Specify a hostname, or a
username and hostname separated by "
connect to. The hostname may optionally be suffixed by a
container name, separated by "
connects directly to a specific container on the specified
host. This will use SSH to talk to the remote machine manager
instance. Container names may be enumerated with
Do not pipe output into a pager.
The following commands are understood:
Show service names on the bus. This is the default if no command is specified.
Shows an object tree of one or more
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.
Dump messages being exchanged. If
SERVICE is specified, show messages
to or from this endpoint. Otherwise, show all messages on the
Similar 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 wireshark(1) may be used to dissect and view the generated files.
Show process information and credentials of a bus service.
Invoke 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 parameters, individually formatted as textual arguments.
Retrieve 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.
Show command syntax help.