From 3f2fa83499fa52d7180fef997194cd00a6a12eb4 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Fri, 1 Mar 2019 15:14:36 +0100 Subject: [PATCH] man: document that --ephemeral and --template= don't cover submounts We never made this clear, let's fix that. --- man/systemd-nspawn.xml | 34 +++++++++++++++++++--------------- 1 file changed, 19 insertions(+), 15 deletions(-) diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index 5ed49e65870..00c14eafebb 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -160,16 +160,18 @@ - Directory or btrfs subvolume to use as template for the container's root - directory. If this is specified and the container's root directory (as configured by - ) does not yet exist it is created as btrfs snapshot (if - supported) or plain directory (otherwise) and populated from this template tree. Ideally, the specified - template path refers to the root of a btrfs subvolume, in which case a simple copy-on-write - snapshot is taken, and populating the root directory is instant. If the specified template path does not refer - to the root of a btrfs subvolume (or not even to a btrfs file system at - all), the tree is copied (though possibly in a 'reflink' copy-on-write scheme — if the file system supports - that), which can be substantially more time-consuming. May not be specified together with - or . + Directory or btrfs subvolume to use as template for the + container's root directory. If this is specified and the container's root directory (as configured by + ) does not yet exist it is created as btrfs snapshot + (if supported) or plain directory (otherwise) and populated from this template tree. Ideally, the + specified template path refers to the root of a btrfs subvolume, in which case a + simple copy-on-write snapshot is taken, and populating the root directory is instant. If the + specified template path does not refer to the root of a btrfs subvolume (or not + even to a btrfs file system at all), the tree is copied (though possibly in a + 'reflink' copy-on-write scheme — if the file system supports that), which can be substantially more + time-consuming. Note that the snapshot taken is of the specified directory or subvolume, including + all subdirectories and subvolumes below it, but excluding any sub-mounts. May not be specified + together with or . Note that this switch leaves host name, machine ID and all other settings that could identify the instance @@ -183,11 +185,13 @@ If specified, the container is run with a temporary snapshot of its file system that is removed immediately when the container terminates. May not be specified together with . - Note that this switch leaves host name, machine ID and all other settings that could identify the - instance unmodified. Please note that — as with — taking the temporary snapshot is - more efficient on file systems that support subvolume snapshots or 'reflinks' naively (btrfs - or new xfs) than on more traditional file systems that do not - (ext4). + Note that this switch leaves host name, machine ID and all other settings that could identify + the instance unmodified. Please note that — as with — taking the + temporary snapshot is more efficient on file systems that support subvolume snapshots or 'reflinks' + natively (btrfs or new xfs) than on more traditional file + systems that do not (ext4). Note that the snapshot taken is of the specified + directory or subvolume, including all subdirectories and subvolumes below it, but excluding any + sub-mounts. With this option no modifications of the container image are retained. Use (described below) for other mechanisms to restrict persistency of