2014-02-14 03:40:40 +08:00
|
|
|
<?xml version="1.0"?>
|
2019-03-14 21:40:58 +08:00
|
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
|
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
2020-11-09 12:23:58 +08:00
|
|
|
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
|
2017-11-19 00:52:56 +08:00
|
|
|
|
2014-02-14 03:40:40 +08:00
|
|
|
<variablelist>
|
|
|
|
|
<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 08:47:03 +08:00
|
|
|
|
|
|
|
|
<varlistentry id='host'>
|
|
|
|
|
<term><option>-H</option></term>
|
|
|
|
|
<term><option>--host=</option></term>
|
|
|
|
|
|
|
|
|
|
<listitem id='host-text'>
|
2014-07-04 02:37:10 +08:00
|
|
|
<para>Execute the operation remotely. Specify a hostname, or a
|
2014-02-21 08:47:03 +08:00
|
|
|
username and hostname separated by <literal>@</literal>, to
|
2014-07-04 02:37:10 +08:00
|
|
|
connect to. The hostname may optionally be suffixed by a
|
2019-04-27 08:22:40 +08:00
|
|
|
port ssh is listening on, separated by <literal>:</literal>, and then a
|
2018-02-09 01:19:14 +08:00
|
|
|
container name, separated by <literal>/</literal>, which
|
2014-07-04 02:37:10 +08: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-09 01:19:14 +08:00
|
|
|
<replaceable>HOST</replaceable></command>. Put IPv6 addresses in brackets.</para>
|
2014-02-21 08:47:03 +08:00
|
|
|
</listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
<varlistentry id='machine'>
|
|
|
|
|
<term><option>-M</option></term>
|
|
|
|
|
<term><option>--machine=</option></term>
|
|
|
|
|
|
|
|
|
|
<listitem id='machine-text'>
|
2020-12-14 20:23:00 +08: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 23:53:01 +08:00
|
|
|
side may be omitted (but not both) in which case the local user name and <literal>.host</literal> are
|
2020-12-14 20:23:00 +08:00
|
|
|
implied.</para>
|
2014-02-21 08:47:03 +08:00
|
|
|
</listitem>
|
|
|
|
|
</varlistentry>
|
2014-02-14 03:40:40 +08:00
|
|
|
</variablelist>
|
