]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man/run0: remove @ syntax for --machine=
authorMike Yuan <me@yhndnzj.com>
Sun, 26 May 2024 19:23:37 +0000 (03:23 +0800)
committerYu Watanabe <watanabe.yu+github@gmail.com>
Mon, 27 May 2024 00:40:47 +0000 (09:40 +0900)
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.

man/run0.xml

index 7b4b430985c9cf4c3008a34994bc23eef7ff8cd6..d7460d9d8c8657af122a2239234b61c019f93115 100644 (file)
         <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>