X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fbusctl.xml;h=730a3344d6cb90610ec1d34136cc4f8cb67fff60;hb=d55192add75584f55932ad463ee6b4cc30370c63;hp=3fdef7bd4d6d4e65c5cf381eb1f900cb8919ebb9;hpb=708c143c7cd2bbd748ac0fa993496ff44e72701c;p=elogind.git diff --git a/man/busctl.xml b/man/busctl.xml index 3fdef7bd4..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. - - @@ -171,7 +110,7 @@ along with systemd; If not, see . When showing the list of endpoints, show - only endpoints which haven't actually been activated yet, + only endpoints which have actually not been activated yet, but may be started automatically if accessed. @@ -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 - to or from this endpoint. Otherwsise, show all messages on the + 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