man/run0: remove @ syntax for --machine=

For run0 (as opposed to systemd-run in general), connecting to
the system bus (of localhost or container) as a different user
than root and then trying to elevate privilege from that
makes little sense:
https://github.com/systemd/systemd/issues/32997#issuecomment-2127992973

The @ syntax is mostly useful when connecting to the user bus,
which is not a use case for run0. Hence, let's remove the example.
The syntax will be properly refused in #32999.
This commit is contained in:
Mike Yuan 2024-05-27 03:23:37 +08:00 committed by Yu Watanabe
parent 006c02b371
commit 8d4fa6531b

View file

@ -204,13 +204,7 @@
<term><option>--machine=</option></term>
<listitem>
<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. 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
omitted (but not both) in which case the local user name and <literal>.host</literal> are implied.
</para>
<para>Execute operation on a local container. Specify a container name to connect to.</para>
<xi:include href="version-info.xml" xpointer="v256"/>
</listitem>