<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
system and service manager.</para>
- <para>For Unit Commands the <replaceable>NAME</replaceable> represents full name of unit.
+ <para>For unit commands, the <replaceable>NAME</replaceable> represents full name of the unit.
<programlisting>
systemctl start foo.service
</programlisting>
- For Unit File Commands the <replaceable>NAME</replaceable> represents full name of the unit file, or absolute path to the unit file.
+ For unit file commands, the <replaceable>NAME</replaceable> represents the full name of the unit file, or the absolute path to the unit file.
<programlisting>
systemctl start /path/to/foo.service
</programlisting>
- While working with services/service files, <command>systemctl</command> is able to append .service suffix when it is missing.
+ While working with services/service files, <command>systemctl</command> implicitly appends the ".service" suffix when it is missing.
<programlisting>
systemctl start foo
</programlisting></para>
<term><option>--host</option></term>
<listitem>
- <para>Execute operation remotely. Specify a hostname, or
- username and hostname separated by <literal>@</literal>, to connect to. This
- will use SSH to talk to the remote systemd
+ <para>Execute the operation remotely. Specify a hostname, or
+ username and hostname separated by <literal>@</literal>, to
+ connect to. This will use SSH to talk to the remote systemd
instance.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><option>-P</option></term>
- <term><option>--privileged</option></term>
+ <term><option>-M</option></term>
+ <term><option>--machine=</option></term>
- <listitem>
- <para>Acquire privileges via PolicyKit before executing the
- operation.</para>
- </listitem>
+ <listitem><para>Execute the operation on a local
+ container. Specify a container name to connect
+ to.</para></listitem>
</varlistentry>
<varlistentry>
</listitem>
</varlistentry>
<varlistentry>
- <term><command>reboot</command></term>
+ <term><command>reboot <optional><replaceable>arg</replaceable></optional></command></term>
<listitem>
<para>Shut down and reboot the system. This is mostly
specified twice, the operation is immediately executed
without terminating any processes or unmounting any file
systems. This may result in data loss.</para>
+
+ <para>If the optional argument
+ <replaceable>arg</replaceable> is given, it will be passed
+ as the optional argument to the
+ <citerefentry><refentrytitle>reboot</refentrytitle><manvolnum>2</manvolnum></citerefentry>
+ system call. The value is architecture and firmware
+ specific. As an example, <literal>recovery</literal> might
+ be used to trigger system recovery, and
+ <literal>fota</literal> might be used to trigger a
+ <quote>firmware over the air</quote> update.</para>
</listitem>
</varlistentry>
<varlistentry>