summaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorAntonio Russo <[email protected]>2017-10-30 16:18:26 -0400
committerBrian Behlendorf <[email protected]>2017-10-30 13:18:26 -0700
commit5c2552c56456191e8038efe25ed66270c3f1501a (patch)
tree468d9ad783dc26c92967c4418aa1ba328eb2fe00 /man
parentca85d690974c4c1e12f1bd5eadfa47806ba01f89 (diff)
systemd zfs-import.target and documentation
zfs-import-{cache,scan}.service must complete before any mounting of filesystems can occur. To simplify this dependency, create a target that is reached After (in the systemd sense) the pool is imported. Additionally, recommend that legacy zfs mounts use the option x-systemd.requires=zfs-import.target to codify this requirement. Reviewed-by: Fabian Grünbichler <[email protected]> Reviewed-by: Brian Behlendorf <[email protected]> Reviewed-by: Giuseppe Di Natale <[email protected]> Signed-off-by: Antonio Russo <[email protected]> Closes #6764
Diffstat (limited to 'man')
-rw-r--r--man/man8/zfs.811
1 files changed, 10 insertions, 1 deletions
diff --git a/man/man8/zfs.8 b/man/man8/zfs.8
index 27c750d7e..46b0a5130 100644
--- a/man/man8/zfs.8
+++ b/man/man8/zfs.8
@@ -461,7 +461,16 @@ If needed, ZFS file systems can also be managed with traditional tools
If a file system's mount point is set to
.Sy legacy ,
ZFS makes no attempt to manage the file system, and the administrator is
-responsible for mounting and unmounting the file system.
+responsible for mounting and unmounting the file system. Because pools must
+be imported before a legacy mount can succeed, administrators should ensure
+that legacy mounts are only attempted after the zpool import process
+finishes at boot time. For example, on machines using systemd, the mount
+option
+.Pp
+.Nm x-systemd.requires=zfs-import.target
+.Pp
+will ensure that the zfs-import completes before systemd attempts mounting
+the filesystem. See systemd.mount(5) for details.
.Ss Deduplication
Deduplication is the process for removing redundant data at the block level,
reducing the total amount of data stored. If a file system has the