summaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorAntonio Russo <[email protected]>2017-10-30 16:18:26 -0400
committerTony Hutter <[email protected]>2017-11-20 16:20:08 -0600
commit1c4f5e7d92b1fbd65413ddf34e5b9fbf7414309f (patch)
treefc99ed04c4e618b83fe568debe31e98aefeaca91 /man
parent246e515cf8e0be011a1466c54890a31a87a953e1 (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 44180d603..48a5e6ea7 100644
--- a/man/man8/zfs.8
+++ b/man/man8/zfs.8
@@ -440,7 +440,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