summaryrefslogtreecommitdiff
path: root/man/user-system-options.xml
blob: 548a00f94f01b21bac494052d4f9b072ca6f96a2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<?xml version="1.0"?>
<!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+

  This file is part of elogind.

  Copyright 2014 Zbigniew Jędrzejewski-Szmek
  Copyright 2014 Lennart Poettering

  elogind is free software; you can redistribute it and/or modify it
  under the terms of the GNU Lesser General Public License as published by
  the Free Software Foundation; either version 2.1 of the License, or
  (at your option) any later version.

  elogind is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General Public License
  along with elogind; If not, see <http://www.gnu.org/licenses/>.
-->

<variablelist>
  <!-- 0 /// With elogind there is no calling user systemd instance.
  <varlistentry id='user'>
    <term><option>&#x2D;&#x2D;user</option></term>

    <listitem id='user-text'>
      <para>Talk to the service manager of the calling user,
      rather than the service manager of the system.</para>
    </listitem>
  </varlistentry>

  <varlistentry id='system'>
    <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>