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   elogind is free software; you can redistribute it and/or modify it
  14   under the terms of the GNU Lesser General Public License as published by
  15   the Free Software Foundation; either version 2.1 of the License, or
  16   (at your option) any later version.
  17
  18   elogind is distributed in the hope that it will be useful, but
  19   WITHOUT ANY WARRANTY; without even the implied warranty of
  20   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  21   Lesser General Public License for more details.
  22
  23   You should have received a copy of the GNU Lesser General Public License
  24   along with elogind; If not, see <http://www.gnu.org/licenses/>.
  25 -->
  26
  27 <variablelist>
  28   <!-- 0 /// With elogind there is no calling user systemd instance.
  29   <varlistentry id='user'>
  30     <term><option>&#x2D;&#x2D;user</option></term>
  31
  32     <listitem id='user-text'>
  33       <para>Talk to the service manager of the calling user,
  34       rather than the service manager of the system.</para>
  35     </listitem>
  36   </varlistentry>
  37
  38   <varlistentry id='system'>
  39     <term><option>&#x2D;&#x2D;system</option></term>
  40
  41     <listitem id='system-text'>
  42       <para>Talk to the service manager of the system. This is the
  43       implied default.</para>
  44     </listitem>
  45   </varlistentry>
  46   // 0 -->
  47
  48   <varlistentry id='host'>
  49     <term><option>-H</option></term>
  50     <term><option>--host=</option></term>
  51
  52     <listitem id='host-text'>
  53       <para>Execute the operation remotely. Specify a hostname, or a
  54       username and hostname separated by <literal>@</literal>, to
  55       connect to. The hostname may optionally be suffixed by a
  56       container name, separated by <literal>:</literal>, which
  57       connects directly to a specific container on the specified
  58       host. This will use SSH to talk to the remote machine manager
  59       instance. Container names may be enumerated with
  60       <command>machinectl -H
  61       <replaceable>HOST</replaceable></command>.</para>
  62     </listitem>
  63   </varlistentry>
  64
  65   <varlistentry id='machine'>
  66     <term><option>-M</option></term>
  67     <term><option>--machine=</option></term>
  68
  69     <listitem id='machine-text'>
  70       <para>Execute operation on a local container. Specify a
  71       container name to connect to.</para>
  72     </listitem>
  73   </varlistentry>
  74 </variablelist>