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 systemd.
   9
  10   Copyright 2014 Zbigniew Jędrzejewski-Szmek
  11   Copyright 2014 Lennart Poettering
  12
  13   systemd 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   systemd 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 systemd; If not, see <http://www.gnu.org/licenses/>.
  25 -->
  26
  27 <variablelist>
  28   <varlistentry id='user'>
  29     <term><option>--user</option></term>
  30
  31     <listitem id='user-text'>
  32       <para>Talk to the service manager of the calling user,
  33       rather than the service manager of the system.</para>
  34     </listitem>
  35   </varlistentry>
  36
  37   <varlistentry id='system'>
  38     <term><option>--system</option></term>
  39
  40     <listitem id='system-text'>
  41       <para>Talk to the service manager of the system. This is the
  42       implied default.</para>
  43     </listitem>
  44   </varlistentry>
  45
  46   <varlistentry id='host'>
  47     <term><option>-H</option></term>
  48     <term><option>--host=</option></term>
  49
  50     <listitem id='host-text'>
  51       <para>Execute the operation remotely. Specify a hostname, or a
  52       username and hostname separated by <literal>@</literal>, to
  53       connect to. The hostname may optionally be suffixed by a
  54       container name, separated by <literal>:</literal>, which
  55       connects directly to a specific container on the specified
  56       host. This will use SSH to talk to the remote machine manager
  57       instance. Container names may be enumerated with
  58       <command>machinectl -H
  59       <replaceable>HOST</replaceable></command>.</para>
  60     </listitem>
  61   </varlistentry>
  62
  63   <varlistentry id='machine'>
  64     <term><option>-M</option></term>
  65     <term><option>--machine=</option></term>
  66
  67     <listitem id='machine-text'>
  68       <para>Execute operation on a local container. Specify a
  69       container name to connect to.</para>
  70     </listitem>
  71   </varlistentry>
  72 </variablelist>