mirror of
https://github.com/systemd/systemd
synced 2024-10-14 12:04:49 +00:00
man/systemctl: rework descriptions of bind and mount-image
The text used "unit's view" to mean mount namespace. But we talk about mount namespaces in the later part of the paragraph anyway, so trying to use an "approachable term" only makes the whole thing harder to understand. Let's use the precise term. Some paragraph-breaking and re-indentation is done too.
This commit is contained in:
parent
dab1fe1a8e
commit
e04eae5e1c
|
@ -552,38 +552,62 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command>bind</command> <replaceable>UNIT</replaceable> <replaceable>PATH</replaceable> [<replaceable>PATH</replaceable>]</term>
|
<term>
|
||||||
|
<command>bind</command>
|
||||||
|
<replaceable>UNIT</replaceable>
|
||||||
|
<replaceable>PATH</replaceable>
|
||||||
|
[<replaceable>PATH</replaceable>]
|
||||||
|
</term>
|
||||||
|
|
||||||
<listitem><para>Bind mounts a file or directory from the host into the specified unit's view. The first path
|
<listitem><para>Bind-mounts a file or directory from the host into the specified unit's mount
|
||||||
argument is the source file or directory on the host, the second path argument is the destination file or
|
namespace. The first path argument is the source file or directory on the host, the second path
|
||||||
directory in the unit's view. When the latter is omitted, the destination path in the unit's view is the same as
|
argument is the destination file or directory in the unit's mount namespace. When the latter is
|
||||||
the source path on the host. When combined with the <option>--read-only</option> switch, a ready-only bind
|
omitted, the destination path in the unit's mount namespace is the same as the source path on the
|
||||||
mount is created. When combined with the <option>--mkdir</option> switch, the destination path is first created
|
host. When combined with the <option>--read-only</option> switch, a ready-only bind mount is
|
||||||
before the mount is applied. Note that this option is currently only supported for units that run within a mount
|
created. When combined with the <option>--mkdir</option> switch, the destination path is first
|
||||||
namespace (e.g.: with <option>RootImage=</option>, <option>PrivateMounts=</option>, etc.). This command supports bind
|
created before the mount is applied.</para>
|
||||||
mounting directories, regular files, device nodes, <constant>AF_UNIX</constant> socket nodes, as well as FIFOs.
|
|
||||||
The bind mount is ephemeral, and it is undone as soon as the current unit process exists.
|
<para>Note that this option is currently only supported for units that run within a mount namespace
|
||||||
Note that the namespace mentioned here, where the bind mount will be added to, is the one where the main service
|
(e.g.: with <option>RootImage=</option>, <option>PrivateMounts=</option>, etc.). This command
|
||||||
process runs, as other processes run in distinct namespaces (e.g.: <option>ExecReload=</option>,
|
supports bind-mounting directories, regular files, device nodes, <constant>AF_UNIX</constant>
|
||||||
<option>ExecStartPre=</option>, etc.) </para></listitem>
|
socket nodes, as well as FIFOs. The bind mount is ephemeral, and it is undone as soon as the
|
||||||
|
current unit process exists. Note that the namespace mentioned here, where the bind mount will be
|
||||||
|
added to, is the one where the main service process runs. Other processes (those exececuted by
|
||||||
|
<option>ExecReload=</option>, <option>ExecStartPre=</option>, etc.) run in distinct namespaces.
|
||||||
|
</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command>mount-image</command> <replaceable>UNIT</replaceable> <replaceable>IMAGE</replaceable> [<replaceable>PATH</replaceable> [<replaceable>PARTITION_NAME</replaceable>:<replaceable>MOUNT_OPTIONS</replaceable>]]</term>
|
<term>
|
||||||
|
<command>mount-image</command>
|
||||||
|
<replaceable>UNIT</replaceable>
|
||||||
|
<replaceable>IMAGE</replaceable>
|
||||||
|
[<replaceable>PATH</replaceable>
|
||||||
|
[<replaceable>PARTITION_NAME</replaceable>:<replaceable>MOUNT_OPTIONS</replaceable>]]
|
||||||
|
</term>
|
||||||
|
|
||||||
<listitem><para>Mounts an image from the host into the specified unit's view. The first path argument is the source
|
<listitem><para>Mounts an image from the host into the specified unit's mount namespace. The first
|
||||||
image on the host, the second path argument is the destination directory in the unit's view (ie: inside
|
path argument is the source image on the host, the second path argument is the destination
|
||||||
<option>RootImage=</option>/<option>RootDirectory=</option>). Any following argument is interpreted as a
|
directory in the unit's mount namespace (i.e. inside
|
||||||
colon-separated tuple of partition name and comma-separated list of mount options for that partition. The format is the
|
<option>RootImage=</option>/<option>RootDirectory=</option>). The following argument, if any, is
|
||||||
same as the service <option>MountImages=</option> setting. When combined with the <option>--read-only</option> switch, a
|
interpreted as a colon-separated tuple of partition name and comma-separated list of mount options
|
||||||
ready-only mount is created. When combined with the <option>--mkdir</option> switch, the destination path is first
|
for that partition. The format is the same as the service <option>MountImages=</option>
|
||||||
created before the mount is applied. Note that this option is currently only supported for units that run within a mount
|
setting. When combined with the <option>--read-only</option> switch, a ready-only mount is
|
||||||
namespace (e.g.: with <option>RootImage=</option>, <option>PrivateMounts=</option>, etc.).
|
created. When combined with the <option>--mkdir</option> switch, the destination path is first
|
||||||
Note that the namespace mentioned here, where the image mount will be added to, is the one where the main service
|
created before the mount is applied.</para>
|
||||||
process runs, as other processes run in distinct namespaces (e.g.: <option>ExecReload=</option>,
|
|
||||||
<option>ExecStartPre=</option>, etc.). Example:
|
<para>Note that this option is currently only supported for units that run within a mount namespace
|
||||||
|
(i.e. with <option>RootImage=</option>, <option>PrivateMounts=</option>, etc.). Note that the
|
||||||
|
namespace mentioned here where the image mount will be added to, is the one where the main service
|
||||||
|
process runs. Note that the namespace mentioned here, where the bind mount will be
|
||||||
|
added to, is the one where the main service process runs. Other processes (those exececuted by
|
||||||
|
<option>ExecReload=</option>, <option>ExecStartPre=</option>, etc.) run in distinct namespaces.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>Example:
|
||||||
<programlisting>systemctl mount-image foo.service /tmp/img.raw /var/lib/image root:ro,nosuid</programlisting>
|
<programlisting>systemctl mount-image foo.service /tmp/img.raw /var/lib/image root:ro,nosuid</programlisting>
|
||||||
<programlisting>systemctl mount-image --mkdir bar.service /tmp/img.raw /var/lib/baz/img</programlisting></para></listitem>
|
<programlisting>systemctl mount-image --mkdir bar.service /tmp/img.raw /var/lib/baz/img</programlisting>
|
||||||
|
</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
|
@ -2185,9 +2209,9 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
|
||||||
<term><option>--lines=</option></term>
|
<term><option>--lines=</option></term>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>When used with <command>status</command>, controls the number of journal lines to show, counting from
|
<para>When used with <command>status</command>, controls the number of journal lines to show,
|
||||||
the most recent ones. Takes a positive integer argument, or 0 to disable journal output. Defaults to
|
counting from the most recent ones. Takes a positive integer argument, or 0 to disable journal
|
||||||
10.</para>
|
output. Defaults to 10.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
@ -2208,8 +2232,9 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
|
||||||
<term><option>--firmware-setup</option></term>
|
<term><option>--firmware-setup</option></term>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>When used with the <command>reboot</command> command, indicate to the system's firmware to reboot into
|
<para>When used with the <command>reboot</command> command, indicate to the system's firmware to
|
||||||
the firmware setup interface. Note that this functionality is not available on all systems.</para>
|
reboot into the firmware setup interface. Note that this functionality is not available on all
|
||||||
|
systems.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
@ -2217,10 +2242,10 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
|
||||||
<term><option>--boot-loader-menu=</option></term>
|
<term><option>--boot-loader-menu=</option></term>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>When used with the <command>reboot</command> command, indicate to the system's boot loader to show the
|
<para>When used with the <command>reboot</command> command, indicate to the system's boot loader to
|
||||||
boot loader menu on the following boot. Takes a time value as parameter — indicating the menu timeout. Pass
|
show the boot loader menu on the following boot. Takes a time value as parameter — indicating the
|
||||||
zero in order to disable the menu timeout. Note that not all boot loaders support this
|
menu timeout. Pass zero in order to disable the menu timeout. Note that not all boot loaders
|
||||||
functionality.</para>
|
support this functionality.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
@ -2228,10 +2253,10 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
|
||||||
<term><option>--boot-loader-entry=</option></term>
|
<term><option>--boot-loader-entry=</option></term>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>When used with the <command>reboot</command> command, indicate to the system's boot loader to boot into
|
<para>When used with the <command>reboot</command> command, indicate to the system's boot loader to
|
||||||
a specific boot loader entry on the following boot. Takes a boot loader entry identifier as argument, or
|
boot into a specific boot loader entry on the following boot. Takes a boot loader entry identifier
|
||||||
<literal>help</literal> in order to list available entries. Note that not all boot loaders support this
|
as argument, or <literal>help</literal> in order to list available entries. Note that not all boot
|
||||||
functionality.</para>
|
loaders support this functionality.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue