etc/default/zfs.in

   1 # OpenZFS userland configuration.
   2 # shellcheck disable=SC2154
   3
   4 # NOTE: This file is intended for sysv init and initramfs.
   5 # Changing some of these settings may not make any difference on
   6 # systemd-based setup, e.g. setting ZFS_MOUNT=no will not prevent systemd
   7 # from launching zfs-mount.service during boot.
   8 # See: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=901436
   9
  10 # To enable a boolean setting, set it to yes, on, true, or 1.
  11 # Anything else will be interpreted as unset.
  12 # shellcheck disable=SC2034
  13
  14 # Run `zfs load-key` during system start?
  15 ZFS_LOAD_KEY='yes'
  16
  17 # Run `zfs unload-key` during system stop?
  18 ZFS_UNLOAD_KEY='no'
  19
  20 # Run `zfs mount -a` during system start?
  21 ZFS_MOUNT='yes'
  22
  23 # Run `zfs unmount -a` during system stop?
  24 ZFS_UNMOUNT='yes'
  25
  26 # Run `zfs share -a` during system start?
  27 # nb: The shareiscsi, sharenfs, and sharesmb dataset properties.
  28 ZFS_SHARE='yes'
  29
  30 # Run `zfs unshare -a` during system stop?
  31 ZFS_UNSHARE='yes'
  32
  33 # By default, a verbatim import of all pools is performed at boot based on the
  34 # contents of the default zpool cache file.  The contents of the cache are
  35 # managed automatically by the 'zpool import' and 'zpool export' commands.
  36 #
  37 # By setting this to 'yes', the system will instead search all devices for
  38 # pools and attempt to import them all at boot, even those that have been
  39 # exported.  Under this mode, the search path can be controlled by the
  40 # ZPOOL_IMPORT_PATH variable and a list of pools that should not be imported
  41 # can be listed in the ZFS_POOL_EXCEPTIONS variable.
  42 #
  43 # Note that importing all visible pools may include pools that you don't
  44 # expect, such as those on removable devices and SANs, and those pools may
  45 # proceed to mount themselves in places you do not want them to.  The results
  46 # can be unpredictable and possibly dangerous.  Only enable this option if you
  47 # understand this risk and have complete physical control over your system and
  48 # SAN to prevent the insertion of malicious pools.
  49 ZPOOL_IMPORT_ALL_VISIBLE='no'
  50
  51 # Specify specific path(s) to look for device nodes and/or links for the
  52 # pool import(s). See zpool(8) for more information about this variable.
  53 # It supersedes the old USE_DISK_BY_ID which indicated that it would only
  54 # try '/dev/disk/by-id'.
  55 # The old variable will still work in the code, but is deprecated.
  56 #ZPOOL_IMPORT_PATH="/dev/disk/by-vdev:/dev/disk/by-id"
  57
  58 # List of pools that should NOT be imported at boot
  59 # when ZPOOL_IMPORT_ALL_VISIBLE is 'yes'.
  60 # This is a space separated list.
  61 #ZFS_POOL_EXCEPTIONS="test2"
  62
  63 # Should the datasets be mounted verbosely?
  64 # A mount counter will be used when mounting if set to 'yes'.
  65 VERBOSE_MOUNT='no'
  66
  67 # Should we allow overlay mounts?
  68 # This is standard in Linux, but not ZFS which comes from Solaris where this
  69 # is not allowed).
  70 DO_OVERLAY_MOUNTS='no'
  71
  72 # Any additional option to the 'zfs import' commandline?
  73 # Include '-o' for each option wanted.
  74 # You don't need to put '-f' in here, unless you want it ALL the time.
  75 # Using the option 'zfsforce=1' on the grub/kernel command line will
  76 # do the same, but on a case-to-case basis.
  77 ZPOOL_IMPORT_OPTS=""
  78
  79 # Full path to the ZFS cache file?
  80 # See "cachefile" in zpool(8).
  81 # The default is "@sysconfdir@/zfs/zpool.cache".
  82 #ZPOOL_CACHE="@sysconfdir@/zfs/zpool.cache"
  83 #
  84 # Setting ZPOOL_CACHE to an empty string ('') AND setting ZPOOL_IMPORT_OPTS to
  85 # "-c @sysconfdir@/zfs/zpool.cache" will _enforce_ the use of a cache file.
  86 # This is needed in some cases (extreme amounts of VDEVs, multipath etc).
  87 # Generally, the use of a cache file is usually not recommended on Linux
  88 # because it sometimes is more trouble than it's worth (laptops with external
  89 # devices or when/if device nodes changes names).
  90 #ZPOOL_IMPORT_OPTS="-c @sysconfdir@/zfs/zpool.cache"
  91 #ZPOOL_CACHE=""
  92
  93 # Any additional option to the 'zfs mount' command line?
  94 # Include '-o' for each option wanted.
  95 MOUNT_EXTRA_OPTIONS=""
  96
  97 # Build kernel modules with the --enable-debug switch?
  98 # Only applicable for Debian GNU/Linux {dkms,initramfs}.
  99 ZFS_DKMS_ENABLE_DEBUG='no'
 100
 101 # Build kernel modules with the --enable-debuginfo switch?
 102 # Only applicable for Debian GNU/Linux {dkms,initramfs}.
 103 ZFS_DKMS_ENABLE_DEBUGINFO='no'
 104
 105 # Keep debugging symbols in kernel modules?
 106 # Only applicable for Debian GNU/Linux {dkms,initramfs}.
 107 ZFS_DKMS_DISABLE_STRIP='no'
 108
 109 # Optional arguments for the ZFS Event Daemon (ZED).
 110 # See zed(8) for more information on available options.
 111 #ZED_ARGS="-M"