1 # ZoL userland configuration.
3 # To enable a boolean setting, set it to yes, on, true, or 1.
4 # Anything else will be interpreted as unset.
6 # Run `zfs mount -a` during system start?
9 # Run `zfs unmount -a` during system stop?
12 # Run `zfs share -a` during system start?
13 # nb: The shareiscsi, sharenfs, and sharesmb dataset properties.
16 # Run `zfs unshare -a` during system stop?
19 # By default, a verbatim import of all pools is performed at boot based on the
20 # contents of the default zpool cache file. The contents of the cache are
21 # managed automatically by the 'zpool import' and 'zpool export' commands.
23 # By setting this to 'yes', the system will instead search all devices for
24 # pools and attempt to import them all at boot, even those that have been
25 # exported. Under this mode, the search path can be controlled by the
26 # ZPOOL_IMPORT_PATH variable and a list of pools that should not be imported
27 # can be listed in the ZFS_POOL_EXCEPTIONS variable.
29 # Note that importing all visible pools may include pools that you don't
30 # expect, such as those on removable devices and SANs, and those pools may
31 # proceed to mount themselves in places you do not want them to. The results
32 # can be unpredictable and possibly dangerous. Only enable this option if you
33 # understand this risk and have complete physical control over your system and
34 # SAN to prevent the insertion of malicious pools.
35 ZPOOL_IMPORT_ALL_VISIBLE='no'
37 # Specify specific path(s) to look for device nodes and/or links for the
38 # pool import(s). See zpool(8) for more information about this variable.
39 # It supersedes the old USE_DISK_BY_ID which indicated that it would only
40 # try '/dev/disk/by-id'.
41 # The old variable will still work in the code, but is deprecated.
42 #ZPOOL_IMPORT_PATH="/dev/disk/by-vdev:/dev/disk/by-id"
44 # List of pools that should NOT be imported at boot
45 # when ZPOOL_IMPORT_ALL_VISIBLE is 'yes'.
46 # This is a space separated list.
47 #ZFS_POOL_EXCEPTIONS="test2"
49 # List of pools that SHOULD be imported at boot by the initramfs
50 # instead of trying to import all available pools. If this is set
51 # then ZFS_POOL_EXCEPTIONS is ignored.
52 # Only applicable for Debian GNU/Linux {dkms,initramfs}.
53 # This is a semi-colon separated list.
54 #ZFS_POOL_IMPORT="pool1;pool2"
56 # Should the datasets be mounted verbosely?
57 # A mount counter will be used when mounting if set to 'yes'.
60 # Should we allow overlay mounts?
61 # This is standard in Linux, but not ZFS which comes from Solaris where this
63 DO_OVERLAY_MOUNTS='no'
65 # Any additional option to the 'zfs import' commandline?
66 # Include '-o' for each option wanted.
67 # You don't need to put '-f' in here, unless you want it ALL the time.
68 # Using the option 'zfsforce=1' on the grub/kernel command line will
69 # do the same, but on a case-to-case basis.
72 # Full path to the ZFS cache file?
73 # See "cachefile" in zpool(8).
74 # The default is "@sysconfdir@/zfs/zpool.cache".
75 #ZPOOL_CACHE="@sysconfdir@/zfs/zpool.cache"
77 # Setting ZPOOL_CACHE to an empty string ('') AND setting ZPOOL_IMPORT_OPTS to
78 # "-c @sysconfdir@/zfs/zpool.cache" will _enforce_ the use of a cache file.
79 # This is needed in some cases (extreme amounts of VDEVs, multipath etc).
80 # Generally, the use of a cache file is usually not recommended on Linux
81 # because it sometimes is more trouble than it's worth (laptops with external
82 # devices or when/if device nodes changes names).
83 #ZPOOL_IMPORT_OPTS="-c @sysconfdir@/zfs/zpool.cache"
86 # Any additional option to the 'zfs mount' command line?
87 # Include '-o' for each option wanted.
88 MOUNT_EXTRA_OPTIONS=""
90 # Build kernel modules with the --enable-debug switch?
91 # Only applicable for Debian GNU/Linux {dkms,initramfs}.
92 ZFS_DKMS_ENABLE_DEBUG='no'
94 # Keep debugging symbols in kernel modules?
95 # Only applicable for Debian GNU/Linux {dkms,initramfs}.
96 ZFS_DKMS_DISABLE_STRIP='no'
98 # Wait for this many seconds in the initrd pre_mountroot?
99 # This delays startup and should be '0' on most systems.
100 # Only applicable for Debian GNU/Linux {dkms,initramfs}.
101 ZFS_INITRD_PRE_MOUNTROOT_SLEEP='0'
103 # Wait for this many seconds in the initrd mountroot?
104 # This delays startup and should be '0' on most systems. This might help on
105 # systems which have their ZFS root on a USB disk that takes just a little
106 # longer to be available
107 # Only applicable for Debian GNU/Linux {dkms,initramfs}.
108 ZFS_INITRD_POST_MODPROBE_SLEEP='0'
110 # List of additional datasets to mount after the root dataset is mounted?
112 # The init script will use the mountpoint specified in the 'mountpoint'
113 # property value in the dataset to determine where it should be mounted.
115 # This is a space separated list, and will be mounted in the order specified,
116 # so if one filesystem depends on a previous mountpoint, make sure to put
117 # them in the right order.
119 # It is not necessary to add filesystems below the root fs here. It is
120 # taken care of by the initrd script automatically. These are only for
121 # additional filesystems needed. Such as /opt, /usr/local which is not
122 # located under the root fs.
123 # Example: If root FS is 'rpool/ROOT/rootfs', this would make sense.
124 #ZFS_INITRD_ADDITIONAL_DATASETS="rpool/ROOT/usr rpool/ROOT/var"
126 # Optional arguments for the ZFS Event Daemon (ZED).
127 # See zed(8) for more information on available options.