]> git.proxmox.com Git - mirror_zfs.git/blame - man/man8/zfs-mount-generator.8
Fix shebangs on import tests
[mirror_zfs.git] / man / man8 / zfs-mount-generator.8
CommitLineData
55d80e65
AR
1.TH "ZFS\-MOUNT\-GENERATOR" "8" "ZFS" "zfs-mount-generator" "\""
2.SH "NAME"
3zfs\-mount\-generator \- generates systemd mount units for zfs
4.SH SYNOPSIS
5.B /lib/systemd/system-generators/zfs\-mount\-generator
6.sp
7.SH DESCRIPTION
8The zfs\-mount\-generator implements the \fBGenerators Specification\fP
9of
10.BR systemd (1),
11and is called during early boot to generate
12.BR systemd.mount (5)
13units for automatically mounted datasets. Mount ordering and dependencies
14are created for all tracked pools (see below). If a dataset has
15.BR canmount=on
16and
17.BR mountpoint
18set, the
19.BR auto
20mount option will be set, and a dependency for
21.BR local-fs.target
22on the mount will be created.
23
24Because zfs pools may not be available very early in the boot process,
25information on ZFS mountpoints must be stored separately. The output
26of the command
27.PP
28.RS 4
29zfs list -H -oname,mountpoint,canmount
30.RE
31.PP
32for datasets that should be mounted by systemd, should be kept
33separate from the pool, at
34.PP
35.RS 4
36.RI @sysconfdir@/zfs/zfs-list.cache/ POOLNAME
37.
38.RE
39.PP
40The cache file, if writeable, will be kept synchronized with the pool
41state by the ZEDLET
42.PP
43.RS 4
44history_event-zfs-list-cacher.sh .
45.RE
46.PP
47.sp
48.SH SEE ALSO
49.BR zfs (5)
50.BR zfs-events (5)
51.BR zed (8)
52.BR zpool (5)
53.BR systemd (1)
54.BR systemd.target (5)
55.BR systemd.special (7)
56.BR systemd.mount (7)