ZFS\-MOUNT\-GENERATOR
Section: (8)
Updated: ZFS
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- EXAMPLE
-
- SEE ALSO
-
Return to Main Contents
NAME
zfs-mount-generator - generates systemd mount units for ZFS
SYNOPSIS
/lib/systemd/system-generators/zfs-mount-generator
DESCRIPTION
zfs-mount-generator implements the Generators Specification
of
systemd(1),
and is called during early boot to generate
systemd.mount(5)
units for automatically mounted datasets. Mount ordering and dependencies
are created for all tracked pools (see below). If a dataset has
canmount=on
and
mountpoint
set, the
auto
mount option will be set, and a dependency for
local-fs.target
on the mount will be created.
Because zfs pools may not be available very early in the boot process,
information on ZFS mountpoints must be stored separately. The output
of the command
-
zfs list -H -o name,mountpoint,canmount,atime,relatime,devices,exec,readonly,setuid,nbmand
for datasets that should be mounted by systemd, should be kept
separate from the pool, at
-
/usr/local/etc/zfs/zfs-list.cache/POOLNAME
The cache file, if writeable, will be kept synchronized with the pool
state by the ZEDLET
-
history_event-zfs-list-cacher.sh .
EXAMPLE
To begin, enable tracking for the pool:
-
touch
/usr/local/etc/zfs/zfs-list.cache/POOLNAME
Then, enable the tracking ZEDLET:
-
ln -s "/usr/local/libexec/zfs/zed.d/history_event-zfs-list-cacher.sh" "/usr/local/etc/zfs/zed.d"
systemctl enable zed.service
systemctl restart zed.service
Force the running of the ZEDLET by setting canmount=on for at least one dataset in the pool:
-
zfs set canmount=on
DATASET
This forces an update to the stale cache file.
SEE ALSO
zfs(5)
zfs-events(5)
zed(8)
zpool(5)
systemd(1)
systemd.target(5)
systemd.special(7)
systemd.mount(7)