diff options
| author | Lennart Poettering <lennart@poettering.net> | 2020-12-14 13:23:00 +0100 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2020-12-15 18:01:01 +0100 |
| commit | ba4a31b7a61cc730b7cbc10948d4f1d6d78d93c7 (patch) | |
| tree | adc7a93a996cb1c549cacce6e998fd230e3b778a /man/user-system-options.xml | |
| parent | 1b630835dff5e13046dfd266629f8ff244dc7fb0 (diff) | |
| download | systemd-ba4a31b7a61cc730b7cbc10948d4f1d6d78d93c7.tar.gz | |
man: document new ability to connect to user of container
Diffstat (limited to 'man/user-system-options.xml')
| -rw-r--r-- | man/user-system-options.xml | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/man/user-system-options.xml b/man/user-system-options.xml index 728118e60c..e2c19b2982 100644 --- a/man/user-system-options.xml +++ b/man/user-system-options.xml @@ -45,8 +45,14 @@ <term><option>--machine=</option></term> <listitem id='machine-text'> - <para>Execute operation on a local container. Specify a - container name to connect to.</para> + <para>Execute operation on a local container. Specify a container name to connect to, optionally + prefixed by a user name to connect as and a separating <literal>@</literal> character. If the special + string <literal>.host</literal> is used in place of the container name, a connection to the local + system is made (which is useful to connect to a specific user's user bus: <literal>--user + --machine=lennart@.host</literal>). If the <literal>@</literal> syntax is not used, the connection is + made as root user. If the <literal>@</literal> syntax is used either the left hand side or the right hand + side may be ommitted (but not both) in which case the local user name and <literal>.host</literal> are + implied.</para> </listitem> </varlistentry> </variablelist> |