chiark / gitweb /
tree-wide: beautify remaining copyright statements
[elogind.git] / man / user-system-options.xml
index 08639602140dfc7754a4e30291de5a0d80131b8a..f336f4d832ee2453602397a480dc377927ea9ed8 100644 (file)
@@ -2,9 +2,16 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
           "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
 
+<!--
+  SPDX-License-Identifier: LGPL-2.1+
+
+  Copyright © 2014 Zbigniew Jędrzejewski-Szmek
+-->
+
 <variablelist>
+  <!-- 0 /// With elogind there is no calling user systemd instance.
   <varlistentry id='user'>
-    <term><option>--user</option></term>
+    <term><option>&#x2D;&#x2D;user</option></term>
 
     <listitem id='user-text'>
       <para>Talk to the service manager of the calling user,
   </varlistentry>
 
   <varlistentry id='system'>
-    <term><option>--system</option></term>
+    <term><option>&#x2D;&#x2D;system</option></term>
 
     <listitem id='system-text'>
       <para>Talk to the service manager of the system. This is the
       implied default.</para>
     </listitem>
   </varlistentry>
+  // 0 -->
+
+  <varlistentry id='host'>
+    <term><option>-H</option></term>
+    <term><option>--host=</option></term>
+
+    <listitem id='host-text'>
+      <para>Execute the operation remotely. Specify a hostname, or a
+      username and hostname separated by <literal>@</literal>, to
+      connect to. The hostname may optionally be suffixed by a
+      container name, separated by <literal>:</literal>, which
+      connects directly to a specific container on the specified
+      host. This will use SSH to talk to the remote machine manager
+      instance. Container names may be enumerated with
+      <command>machinectl -H
+      <replaceable>HOST</replaceable></command>.</para>
+    </listitem>
+  </varlistentry>
+
+  <varlistentry id='machine'>
+    <term><option>-M</option></term>
+    <term><option>--machine=</option></term>
+
+    <listitem id='machine-text'>
+      <para>Execute operation on a local container. Specify a
+      container name to connect to.</para>
+    </listitem>
+  </varlistentry>
 </variablelist>