diff options
| author | Daan De Meyer <daan.j.demeyer@gmail.com> | 2022-07-11 21:43:41 +0200 |
|---|---|---|
| committer | Daan De Meyer <daan.j.demeyer@gmail.com> | 2022-07-11 21:43:41 +0200 |
| commit | f075e32ca15a7451bd9a436f64bfc1720cf5f899 (patch) | |
| tree | 95cf823fd596f26c8df462fee46100746b97e84d /man/systemd-nspawn.xml | |
| parent | nspawn: Drop unnecessary intermediate variable (diff) | |
| download | systemd-f075e32ca15a7451bd9a436f64bfc1720cf5f899.tar.xz systemd-f075e32ca15a7451bd9a436f64bfc1720cf5f899.zip | |
nspawn: Rewrap --overlay docs
Diffstat (limited to 'man/systemd-nspawn.xml')
| -rw-r--r-- | man/systemd-nspawn.xml | 42 |
1 files changed, 17 insertions, 25 deletions
diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index e700864873..b5a02f0a78 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -1455,33 +1455,25 @@ After=sys-subsystem-net-devices-ens1.device</programlisting> <term><option>--overlay=</option></term> <term><option>--overlay-ro=</option></term> - <listitem><para>Combine multiple directory trees into one - overlay file system and mount it into the container. Takes a - list of colon-separated paths to the directory trees to - combine and the destination mount point.</para> - - <para>Backslash escapes are interpreted in the paths, so - <literal>\:</literal> may be used to embed colons in the paths. + <listitem><para>Combine multiple directory trees into one overlay file system and mount it into the + container. Takes a list of colon-separated paths to the directory trees to combine and the + destination mount point.</para> + + <para>Backslash escapes are interpreted in the paths, so <literal>\:</literal> may be used to embed + colons in the paths.</para> + + <para>If three or more paths are specified, then the last specified path is the destination mount + point in the container, all paths specified before refer to directory trees on the host and are + combined in the specified order into one overlay file system. The left-most path is hence the lowest + directory tree, the second-to-last path the highest directory tree in the stacking order. If + <option>--overlay-ro=</option> is used instead of <option>--overlay=</option>, a read-only overlay + file system is created. If a writable overlay file system is created, all changes made to it are + written to the highest directory tree in the stacking order, i.e. the second-to-last specified. </para> - <para>If three or more paths are specified, then the last - specified path is the destination mount point in the - container, all paths specified before refer to directory trees - on the host and are combined in the specified order into one - overlay file system. The left-most path is hence the lowest - directory tree, the second-to-last path the highest directory - tree in the stacking order. If <option>--overlay-ro=</option> - is used instead of <option>--overlay=</option>, a read-only - overlay file system is created. If a writable overlay file - system is created, all changes made to it are written to the - highest directory tree in the stacking order, i.e. the - second-to-last specified.</para> - - <para>If only two paths are specified, then the second - specified path is used both as the top-level directory tree in - the stacking order as seen from the host, as well as the mount - point for the overlay file system in the container. At least - two paths have to be specified.</para> + <para>If only two paths are specified, then the second specified path is used both as the top-level + directory tree in the stacking order as seen from the host, as well as the mount point for the + overlay file system in the container. At least two paths have to be specified.</para> <para>The source paths may optionally be prefixed with <literal>+</literal> character. If so they are taken relative to the image's root directory. The uppermost source path may also be specified as an |