]>
Commit | Line | Data |
---|---|---|
88ae7333 | 1 | <?xml version="1.0"?> |
bbd0645a | 2 | <!DOCTYPE variablelist PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" |
3a54a157 | 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> |
db9ecf05 | 4 | <!-- SPDX-License-Identifier: LGPL-2.1-or-later --> |
f48f7543 | 5 | |
88ae7333 ZJS |
6 | <variablelist> |
7 | <varlistentry id='user'> | |
8 | <term><option>--user</option></term> | |
9 | ||
10 | <listitem id='user-text'> | |
11 | <para>Talk to the service manager of the calling user, | |
12 | rather than the service manager of the system.</para> | |
13 | </listitem> | |
14 | </varlistentry> | |
15 | ||
16 | <varlistentry id='system'> | |
17 | <term><option>--system</option></term> | |
18 | ||
19 | <listitem id='system-text'> | |
20 | <para>Talk to the service manager of the system. This is the | |
21 | implied default.</para> | |
22 | </listitem> | |
23 | </varlistentry> | |
4f50d2ef ZJS |
24 | |
25 | <varlistentry id='host'> | |
26 | <term><option>-H</option></term> | |
27 | <term><option>--host=</option></term> | |
28 | ||
29 | <listitem id='host-text'> | |
db6d9e86 | 30 | <para>Execute the operation remotely. Specify a hostname, or a |
4f50d2ef | 31 | username and hostname separated by <literal>@</literal>, to |
db6d9e86 | 32 | connect to. The hostname may optionally be suffixed by a |
5238e957 | 33 | port ssh is listening on, separated by <literal>:</literal>, and then a |
026df70e | 34 | container name, separated by <literal>/</literal>, which |
db6d9e86 LP |
35 | connects directly to a specific container on the specified |
36 | host. This will use SSH to talk to the remote machine manager | |
37 | instance. Container names may be enumerated with | |
38 | <command>machinectl -H | |
026df70e | 39 | <replaceable>HOST</replaceable></command>. Put IPv6 addresses in brackets.</para> |
4f50d2ef ZJS |
40 | </listitem> |
41 | </varlistentry> | |
42 | ||
43 | <varlistentry id='machine'> | |
44 | <term><option>-M</option></term> | |
45 | <term><option>--machine=</option></term> | |
46 | ||
47 | <listitem id='machine-text'> | |
ba4a31b7 LP |
48 | <para>Execute operation on a local container. Specify a container name to connect to, optionally |
49 | prefixed by a user name to connect as and a separating <literal>@</literal> character. If the special | |
50 | string <literal>.host</literal> is used in place of the container name, a connection to the local | |
51 | system is made (which is useful to connect to a specific user's user bus: <literal>--user | |
52 | --machine=lennart@.host</literal>). If the <literal>@</literal> syntax is not used, the connection is | |
53 | made as root user. If the <literal>@</literal> syntax is used either the left hand side or the right hand | |
24ee0f9d | 54 | side may be omitted (but not both) in which case the local user name and <literal>.host</literal> are |
ba4a31b7 | 55 | implied.</para> |
4f50d2ef ZJS |
56 | </listitem> |
57 | </varlistentry> | |
e8fd5554 LP |
58 | |
59 | <varlistentry id='capsule'> | |
60 | <term><option>-C</option></term> | |
61 | <term><option>--capsule=</option></term> | |
62 | ||
63 | <listitem id='capsule-text'> | |
64 | <para>Execute operation on a capsule. Specify a capsule name to connect to. See | |
65 | <citerefentry><refentrytitle>capsule@.service</refentrytitle><manvolnum>5</manvolnum></citerefentry> for | |
66 | details about capsules.</para> | |
67 | </listitem> | |
68 | </varlistentry> | |
88ae7333 | 69 | </variablelist> |