Codex

BUSCTL

Section: busctl (1)

Updated:

Index?action=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 (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


More Man Pages