]> git.ipfire.org Git - thirdparty/systemd.git/blob - man/user-system-options.xml
Merge pull request #9917 from keszybz/cleanups
[thirdparty/systemd.git] / 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
9 <variablelist>
10 <varlistentry id='user'>
11 <term><option>--user</option></term>
12
13 <listitem id='user-text'>
14 <para>Talk to the service manager of the calling user,
15 rather than the service manager of the system.</para>
16 </listitem>
17 </varlistentry>
18
19 <varlistentry id='system'>
20 <term><option>--system</option></term>
21
22 <listitem id='system-text'>
23 <para>Talk to the service manager of the system. This is the
24 implied default.</para>
25 </listitem>
26 </varlistentry>
27
28 <varlistentry id='host'>
29 <term><option>-H</option></term>
30 <term><option>--host=</option></term>
31
32 <listitem id='host-text'>
33 <para>Execute the operation remotely. Specify a hostname, or a
34 username and hostname separated by <literal>@</literal>, to
35 connect to. The hostname may optionally be suffixed by a
36 port ssh is listening on, seperated by <literal>:</literal>, and then a
37 container name, separated by <literal>/</literal>, which
38 connects directly to a specific container on the specified
39 host. This will use SSH to talk to the remote machine manager
40 instance. Container names may be enumerated with
41 <command>machinectl -H
42 <replaceable>HOST</replaceable></command>. Put IPv6 addresses in brackets.</para>
43 </listitem>
44 </varlistentry>
45
46 <varlistentry id='machine'>
47 <term><option>-M</option></term>
48 <term><option>--machine=</option></term>
49
50 <listitem id='machine-text'>
51 <para>Execute operation on a local container. Specify a
52 container name to connect to.</para>
53 </listitem>
54 </varlistentry>
55 </variablelist>