diff --git a/man/repart.d.xml b/man/repart.d.xml index eaa83f6171..9b6b06f06c 100644 --- a/man/repart.d.xml +++ b/man/repart.d.xml @@ -509,6 +509,23 @@ Note that when CopyFiles= is used with Format=xfs, xfsprogs 6.17 or newer is required. + Note that systemd-repart always excludes the contents of a number of API + file systems and temporary directories, namely /proc/, /sys/, + /dev/, /tmp/, /run/, and + /var/tmp/, as their contents are not expected to be part of a disk image. The + directories themselves are still created (empty) in the new file system. + + When a root partition is populated, the contents below the mount points of any other + partitions that are part of the same image are excluded too, so that data belonging to a separate + partition is not duplicated into the root file system. For example, if an esp + partition is part of the image, the contents of /boot/ and + /efi/ are not copied into the root partition. + + To copy a directory that is excluded by the mount-point rule above, add an explicit + CopyFiles= entry for it. For example, CopyFiles=/boot:/boot + overrides the implicit exclusion and copies /boot/ into the root + partition. +