2014-02-13 23:40:40 +04:00
<?xml version="1.0"?>
2023-12-23 11:57:43 +03:00
< !DOCTYPE variablelist PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
2019-03-14 16:40:58 +03:00
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
2020-11-09 07:23:58 +03:00
<!-- SPDX - License - Identifier: LGPL - 2.1 - or - later -->
2017-11-18 19:52:56 +03:00
2024-05-28 16:58:36 +03:00
<variablelist xmlns:xi= "http://www.w3.org/2001/XInclude" >
2014-02-13 23:40:40 +04:00
<varlistentry id= 'user' >
<term > <option > --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 > --system</option> </term>
<listitem id= 'system-text' >
<para > Talk to the service manager of the system. This is the
implied default.</para>
</listitem>
</varlistentry>
2014-02-21 04:47:03 +04:00
<varlistentry id= 'host' >
<term > <option > -H</option> </term>
<term > <option > --host=</option> </term>
<listitem id= 'host-text' >
2014-07-03 22:37:10 +04:00
<para > Execute the operation remotely. Specify a hostname, or a
2014-02-21 04:47:03 +04:00
username and hostname separated by <literal > @</literal> , to
2014-07-03 22:37:10 +04:00
connect to. The hostname may optionally be suffixed by a
2019-04-27 03:22:40 +03:00
port ssh is listening on, separated by <literal > :</literal> , and then a
2018-02-08 20:19:14 +03:00
container name, separated by <literal > /</literal> , which
2014-07-03 22:37:10 +04:00
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
2018-02-08 20:19:14 +03:00
<replaceable > HOST</replaceable> </command> . Put IPv6 addresses in brackets.</para>
2014-02-21 04:47:03 +04:00
</listitem>
</varlistentry>
<varlistentry id= 'machine' >
<term > <option > -M</option> </term>
<term > <option > --machine=</option> </term>
<listitem id= 'machine-text' >
2020-12-14 15:23:00 +03:00
<para > Execute operation on a local container. Specify a container name to connect to, optionally
prefixed by a user name to connect as and a separating <literal > @</literal> character. If the special
string <literal > .host</literal> is used in place of the container name, a connection to the local
system is made (which is useful to connect to a specific user's user bus: <literal > --user
--machine=lennart@.host</literal> ). If the <literal > @</literal> syntax is not used, the connection is
made as root user. If the <literal > @</literal> syntax is used either the left hand side or the right hand
2020-12-16 18:53:01 +03:00
side may be omitted (but not both) in which case the local user name and <literal > .host</literal> are
2020-12-14 15:23:00 +03:00
implied.</para>
2014-02-21 04:47:03 +04:00
</listitem>
</varlistentry>
2024-01-03 21:29:23 +03:00
<varlistentry id= 'capsule' >
<term > <option > -C</option> </term>
<term > <option > --capsule=</option> </term>
<listitem id= 'capsule-text' >
<para > Execute operation on a capsule. Specify a capsule name to connect to. See
<citerefentry > <refentrytitle > capsule@.service</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry> for
details about capsules.</para>
2024-05-28 16:58:36 +03:00
<xi:include href= "version-info.xml" xpointer= "v256" />
2024-01-03 21:29:23 +03:00
</listitem>
</varlistentry>
2014-02-13 23:40:40 +04:00
</variablelist>