X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fbusctl.xml;h=730a3344d6cb90610ec1d34136cc4f8cb67fff60;hb=d55192add75584f55932ad463ee6b4cc30370c63;hp=33420a9cbc1f4ee30b9faa9c2d4ef6e958bb967e;hpb=f5ca75f4a1f9f97a23c8bb70ee89cf669f9bb425;p=elogind.git diff --git a/man/busctl.xml b/man/busctl.xml index 33420a9cb..730a3344d 100644 --- a/man/busctl.xml +++ b/man/busctl.xml @@ -21,7 +21,8 @@ You should have received a copy of the GNU Lesser General Public License along with systemd; If not, see . --> - + busctl @@ -69,68 +70,6 @@ along with systemd; If not, see . The following options are understood: - - - - - Print a short help text and exit. - - - - - - - - Print a short version string and exit. - - - - - - - - Do not pipe output into a pager. - - - - - - - - Talk to the systemd system manager (the - default). - - - - - - - - Talk to the systemd manager of the calling - user. - - - - - - - - - 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. - - @@ -183,6 +122,53 @@ along with systemd; If not, see . subset matching MATCH. + + + + + + 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. + + + + + + + + + + + @@ -195,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. - monitor NAME + 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 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. @@ -233,7 +265,8 @@ along with systemd; If not, see . sd-bus3, systemd1, systemd-bus-proxyd8, - machinectl1 + machinectl1, + wireshark1