X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fbusctl.xml;h=730a3344d6cb90610ec1d34136cc4f8cb67fff60;hb=d55192add75584f55932ad463ee6b4cc30370c63;hp=7947c8d2c86dfcc8ed07c0482774107b0afb40f1;hpb=88ae7333ee052e64607ae6678fe0e84991fe3482;p=elogind.git diff --git a/man/busctl.xml b/man/busctl.xml index 7947c8d2c..730a3344d 100644 --- a/man/busctl.xml +++ b/man/busctl.xml @@ -70,26 +70,6 @@ along with systemd; If not, see . The following options are understood: - - - - - - Execute the operation remotely. Specify a hostname, or - username and hostname separated by @, to - connect to. This will use SSH to talk to the remote systemd - instance. - - - - - - - - Execute the operation on a local container. - Specify a container name to connect to. - - @@ -153,8 +133,38 @@ along with systemd; If not, see . + + + + + 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. + + + + + @@ -171,24 +181,70 @@ along with systemd; If not, see . list - Show endpoints attached to the bus. This is - the default if no command is specified. + Show service names on the bus. This is the + default if no command is specified. + + + + tree SERVICE + + Shows 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. - monitor NAME + monitor SERVICE Dump messages being exchanged. If - NAME is specified, show messages + SERVICE is specified, show messages to or from this endpoint. Otherwise, show all messages on the bus. - status NAME + capture SERVICE + + 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 + wireshark1 + may be used to dissect and view the generated + files. + + + + status SERVICE Show process information and credentials of a - bus endpoint. + bus service. + + + + call SERVICE OBJECT INTERFACE METHOD SIGNATURE PARAMETERS + + 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. + + + + get-property SERVICE OBJECT INTERFACE PROPERTIES + + 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. @@ -209,7 +265,8 @@ along with systemd; If not, see . sd-bus3, systemd1, systemd-bus-proxyd8, - machinectl1 + machinectl1, + wireshark1