BUSCTL
Section: busctl (1)
Updated:
Index
Return to Main Contents
NAME
busctl - Introspect the bus
SYNOPSIS
-
busctl [OPTIONS...] [COMMAND] [NAME...]
DESCRIPTION
busctl
may be used to introspect and monitor the D-Bus bus.
OPTIONS
The following options are understood:
--address=ADDRESS
-
Connect to the bus specified by
ADDRESS
instead of using suitable defaults for either the system or user bus (see
--system
and
--user
options).
--show-machine
-
When showing the list of endpoints, show a column containing the names of containers they belong to. See
systemd-machined.service(8).
--unique
-
When showing the list of endpoints, show only "unique" names (of the form
":number.number").
--acquired
-
The opposite of
--unique
--- only "well-known" names will be shown.
--activatable
-
When showing the list of endpoints, show only endpoints which have actually not been activated yet, but may be started automatically if accessed.
--match=MATCH
-
When showing messages being exchanged, show only the subset matching
MATCH.
--no-legend
-
Do not print the legend, i.e. the column headers and the footer.
--user
-
Talk to the service manager of the calling user, rather than the service manager of the system.
--system
-
Talk to the service manager of the system. This is the implied default.
-H, --host=
-
Execute the operation remotely. Specify a hostname, or a username and hostname separated by
"@", to connect to. The hostname may optionally be suffixed by a container name, separated by
":", which 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
machinectl -H HOST.
-M, --machine=
-
Execute operation on a local container. Specify a container name to connect to.
-h, --help
-
Print a short help text and exit.
--version
-
Print a short version string and exit.
--no-pager
-
Do not pipe output into a pager.
COMMANDS
The following commands are understood:
list
-
Show endpoints attached to the bus. This is the default if no command is specified.
monitor [NAME...]
-
Dump messages being exchanged. If
NAME
is specified, show messages to or from this endpoint. Otherwise, show all messages on the bus.
status NAME
-
Show process information and credentials of a bus endpoint.
help
-
Show command syntax help.
SEE ALSO
dbus-daemon(1),
m[blue]D-Busm[][1],
m[blue]kdbusm[][2],
sd-bus(3),
systemd(1),
systemd-bus-proxyd(8),
machinectl(1)
NOTES
- 1.
-
D-Bus
-
http://freedesktop.org/wiki/Software/dbus
- 2.
-
kdbus
-
https://code.google.com/p/d-bus/
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- COMMANDS
-
- SEE ALSO
-
- NOTES
-