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   Copyright 2014 Zbigniew Jędrzejewski-Szmek
   9   Copyright 2014 Lennart Poettering
  10 -->
  11
  12 <variablelist>
  13   <varlistentry id='user'>
  14     <term><option>--user</option></term>
  15
  16     <listitem id='user-text'>
  17       <para>Talk to the service manager of the calling user,
  18       rather than the service manager of the system.</para>
  19     </listitem>
  20   </varlistentry>
  21
  22   <varlistentry id='system'>
  23     <term><option>--system</option></term>
  24
  25     <listitem id='system-text'>
  26       <para>Talk to the service manager of the system. This is the
  27       implied default.</para>
  28     </listitem>
  29   </varlistentry>
  30
  31   <varlistentry id='host'>
  32     <term><option>-H</option></term>
  33     <term><option>--host=</option></term>
  34
  35     <listitem id='host-text'>
  36       <para>Execute the operation remotely. Specify a hostname, or a
  37       username and hostname separated by <literal>@</literal>, to
  38       connect to. The hostname may optionally be suffixed by a
  39       container name, separated by <literal>:</literal>, which
  40       connects directly to a specific container on the specified
  41       host. This will use SSH to talk to the remote machine manager
  42       instance. Container names may be enumerated with
  43       <command>machinectl -H
  44       <replaceable>HOST</replaceable></command>.</para>
  45     </listitem>
  46   </varlistentry>
  47
  48   <varlistentry id='machine'>
  49     <term><option>-M</option></term>
  50     <term><option>--machine=</option></term>
  51
  52     <listitem id='machine-text'>
  53       <para>Execute operation on a local container. Specify a
  54       container name to connect to.</para>
  55     </listitem>
  56   </varlistentry>
  57 </variablelist>