diff --git a/man/sd_bus_default.xml b/man/sd_bus_default.xml index 6d5a90de72..d9102a36ce 100644 --- a/man/sd_bus_default.xml +++ b/man/sd_bus_default.xml @@ -165,13 +165,17 @@ not set, a suitable default for the default system D-Bus instance will be used. - sd_bus_open_system_remote() connects to - the system bus on the specified host using - ssh1. host - consists of an optional user name followed by the - @ symbol, and the hostname. - + sd_bus_open_system_remote() connects to the system bus on + the specified host using + ssh1. + host consists of an optional user name followed by the + @ symbol, and the hostname, optionally followed by a + : and a machine name. If the machine name is given, a connection + is created to the system bus in the specified container on the remote machine, and + otherwise a connection to the system bus on the specified host is created. + + Note that entering a container is a privileged operation, and will likely only + work for the root user on the remote machine. sd_bus_open_system_machine() connects to the system bus in the specified machine,