busctl
Introspect and monitor the D-Bus message bus
TLDR
Show all peers on the bus
$ busctl list
Show all peers on the user session bus$ busctl --user list
Show process information for a service or PID$ busctl status [service|pid]
Monitor messages on the bus$ busctl monitor [service1] [service2] ...
Capture bus traffic in pcap format$ busctl capture [service] > [bus-traffic.pcap]
Show object tree of services$ busctl tree [service1] [service2] ...
Introspect an object's interfaces$ busctl introspect [service] [path/to/object]
Get property value from an object$ busctl get-property [service] [path/to/object] [interface_name] [property_name]
Call a method on an object$ busctl call [service] [path/to/object] [interface_name] [method_name]
SYNOPSIS
busctl [command] [options] [arguments]
DESCRIPTION
busctl introspects and monitors the D-Bus message bus. D-Bus is an inter-process communication system used extensively in Linux for communication between system services and desktop applications.
The tool can list services, monitor message traffic, inspect object hierarchies, and invoke methods on D-Bus objects.
PARAMETERS
--system
Connect to system bus (default).--user
Connect to user session bus.--address ADDRESS
Connect to the bus specified by ADDRESS.-j, --json=MODE
Output in JSON format. MODE is short, pretty, or off.--verbose
Show verbose output for call or get-property commands.--expect-reply=BOOL
Whether to wait for method call completion. Defaults to yes.--auto-start=BOOL
Whether method calls should auto-start the target service. Defaults to yes.--list
Show a flat list instead of a tree with the tree command.--unique
Show only unique bus names (e.g., :1.42).--acquired
Show only well-known bus names.--activatable
Show only activatable services not yet started.--no-pager
Disable pager.--no-legend
Do not print column headers and footers.
SUBCOMMANDS
list
List all peers on the busstatus
Show process info for a service or PIDmonitor
Watch message trafficcapture
Capture bus traffic in pcap formattree
Show object hierarchyintrospect
Examine object interfacesget-property
Read a property valueset-property
Set a property valuecall
Invoke a methodemit
Emit a signalwait-signal
Wait for a specific signal
SEE ALSO
dbus-send(1), dbus-monitor(1), gdbus(1), systemctl(1)
