zfs-mount-generator(8)
名称
zfs-mount-generator — 为 ZFS 文件系统生成 systemd 挂载单元
概述
@systemdgeneratordir@/zfs-mount-generator说明
zfs-mount-generator 是一个 systemd.generator(7) 生成器,为已配置的 ZFS 数据集生成原生的 systemd.mount(5) 单元。
属性
mountpoint=
值为 legacy 或 none 时跳过。
canmount=
值为 off 时跳过。如果给定挂载点下只存在 noauto 数据集,且这样的数据集不止一个,也会跳过。对于同一挂载点,值为 yes 的数据集优先于值为 noauto 的数据集。值为 noauto 时,设置逻辑上的 noauto 标志。加密根始终生成 zfs-load-key@root.service,即使值为 off。
atime=、relatime=、devices=、exec=、readonly=、setuid=、nbmand=
用于生成与 zfs mount 等价的挂载选项。
encroot=、keylocation=
如果数据集是加密根,其挂载单元将绑定到 zfs-load-key@root.service,并带有如下附加依赖项:
keylocation=prompt:无附加依赖,使用 systemd-ask-password(1)。keylocation=https://URL(等):Wants=、After=:network-online.targetkeylocation=file://<path>:RequiresMountsFor=path
该服务还使用与挂载单元相同的 Wants=、After=、Requires= 与 RequiresMountsFor=。
org.openzfs.systemd:requires=path[ path]…
为挂载单元与密钥加载单元设置 Requires=。
org.openzfs.systemd:requires-mounts-for=path[ path]…
为挂载单元与密钥加载单元设置 RequiresMountsFor=。
org.openzfs.systemd:before=unit[ unit]…
为挂载单元设置 Before=。
org.openzfs.systemd:after=unit[ unit]…
为挂载单元设置 After=。
org.openzfs.systemd:wanted-by=unit[ unit]…
设置逻辑上的 noauto 标志(见下文)。如果值不是 none,则为挂载单元设置 WantedBy=。
org.openzfs.systemd:required-by=unit[ unit]…
设置逻辑上的 noauto 标志(见下文)。如果值不是 none,则为挂载单元设置 RequiredBy=。
org.openzfs.systemd:nofail=(unset)|on|off
增强或减弱挂载单元默认反向依赖的强度,见下文。
org.openzfs.systemd:ignore=on|off
值为 on 时跳过(默认值: off)。
单元顺序与依赖
此外,除非数据集所在的池在生成时已经导入,否则两个单元都会获得 Wants=zfs-import.target 与 After=zfs-import.target。
此外,除非设置了逻辑上的 noauto 标志,否则挂载单元会为 local-fs.target 获得一个反向依赖,其强度如下:
nofail 取值
生成的依赖
(unset)
WantedBy= 与 Before=
on
WantedBy=
off
RequiredBy= 与 Before=
缓存文件
由于 ZFS 存储池在启动过程的早期可能尚不可用,ZFS 挂载点的信息必须单独存放。对于应由 systemd 挂载的数据集,zfs list -Ho name,<上述每个属性,按顺序> 的输出应保存在 @sysconfdir@/zfs/zfs-list.cache/poolname;如果该文件可写,那么在启用后,history_event-zfs-list-cacher.sh ZEDLET 会为整个池保持其同步(参见 zed(8))。
环境变量
如果环境变量 ZFS_DEBUG 非零(或者未设置且 /proc/cmdline 包含 debug),则在结束时打印汇总统计信息。
示例
首先,为存储池启用跟踪:
然后启用负责跟踪的 ZEDLET:
如果队列中没有历史事件,可以在池中某处设置一个受监视的属性,以此注入一个事件,确保 ZEDLET 运行并刷新缓存文件:
要测试生成器的输出:
如果生成的单元符合预期,可指示 systemd 重新运行所有生成器:
参考文献
systemd.mount(5)、systemd.target(5)、zfs(5)、systemd.generator(7)、systemd.special(7)、zed(8)、zpool-events(8)
2021 年 11 月 30 日
最后更新于