<!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+
+
+ Copyright 2014 Zbigniew Jędrzejewski-Szmek
+-->
+
<variablelist>
+ <!-- 0 /// With elogind there is no calling user systemd instance.
<varlistentry id='user'>
- <term><option>--user</option></term>
+ <term><option>--user</option></term>
<listitem id='user-text'>
<para>Talk to the service manager of the calling user,
</varlistentry>
<varlistentry id='system'>
- <term><option>--system</option></term>
+ <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>
+ // 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
+ <para>Execute the operation remotely. Specify a hostname, or a
username and hostname separated by <literal>@</literal>, to
- connect to. This will use SSH to talk to the remote machine
- manager instance.</para>
+ 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>