man/user-system-options.xml

   1 <?xml version="1.0"?>
   2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3           "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
   4
   5 <!--
   6   SPDX-License-Identifier: LGPL-2.1+
   7
   8   This file is part of elogind.
   9
  10   Copyright 2014 Zbigniew Jędrzejewski-Szmek
  11   Copyright 2014 Lennart Poettering
  12 -->
  13
  14 <variablelist>
  15   <!-- 0 /// With elogind there is no calling user systemd instance.
  16   <varlistentry id='user'>
  17     <term><option>&#x2D;&#x2D;user</option></term>
  18
  19     <listitem id='user-text'>
  20       <para>Talk to the service manager of the calling user,
  21       rather than the service manager of the system.</para>
  22     </listitem>
  23   </varlistentry>
  24
  25   <varlistentry id='system'>
  26     <term><option>&#x2D;&#x2D;system</option></term>
  27
  28     <listitem id='system-text'>
  29       <para>Talk to the service manager of the system. This is the
  30       implied default.</para>
  31     </listitem>
  32   </varlistentry>
  33   // 0 -->
  34
  35   <varlistentry id='host'>
  36     <term><option>-H</option></term>
  37     <term><option>--host=</option></term>
  38
  39     <listitem id='host-text'>
  40       <para>Execute the operation remotely. Specify a hostname, or a
  41       username and hostname separated by <literal>@</literal>, to
  42       connect to. The hostname may optionally be suffixed by a
  43       container name, separated by <literal>:</literal>, which
  44       connects directly to a specific container on the specified
  45       host. This will use SSH to talk to the remote machine manager
  46       instance. Container names may be enumerated with
  47       <command>machinectl -H
  48       <replaceable>HOST</replaceable></command>.</para>
  49     </listitem>
  50   </varlistentry>
  51
  52   <varlistentry id='machine'>
  53     <term><option>-M</option></term>
  54     <term><option>--machine=</option></term>
  55
  56     <listitem id='machine-text'>
  57       <para>Execute operation on a local container. Specify a
  58       container name to connect to.</para>
  59     </listitem>
  60   </varlistentry>
  61 </variablelist>