zfs-mount(8)

zfs-mount8

Manage mount state of zfs filesystems

Usage

zfs mount [-j]

zfs {mount [-Oflv] [-o options] -a | -R filesystem | filesystem}

zfs {unmount [-fu] -a | filesystem | mountpoint}

Overview

zfs mount [-j] Displays all ZFS file systems currently mounted.

-j, --json

Displays all mounted file systems in JSON format.

zfs mount [-Oflv] [-o options] -a|-R filesystem|filesystem Mount ZFS filesystem on a path described by its mountpoint property, if the path exists and is empty. If mountpoint is set to legacy, the filesystem should be instead mounted using mount(8).

-O

Perform an overlay mount. Allows mounting in non-empty mountpoint. See mount(8) for more information.

-a

Mount all available ZFS file systems. Invoked automatically as part of the boot process if configured.

-R

Mount the specified filesystems along with all their children.

filesystem

Mount the specified filesystem.

-o options

An optional, comma-separated list of mount options to use temporarily for the duration of the mount. See the Temporary Mount Point Properties section of zfsprops(7) for details.

-l

Load keys for encrypted filesystems as they are being mounted. This is equivalent to executing zfs load-key on each encryption root before mounting it. Note that if a filesystem has keylocation=prompt, this will cause the terminal to interactively block after asking for the key.

-v

Report mount progress.

-f

Attempt to force mounting of all filesystems, even those that couldn't normally be mounted (e.g. redacted datasets).

zfs unmount [-fu] -a|filesystem|mountpoint Unmounts currently mounted ZFS file systems.

-a

Unmount all available ZFS file systems. Invoked automatically as part of the shutdown process.

-f

Forcefully unmount the file system, even if it is currently in use. This option is not supported on Linux.

-u

Unload keys for any encryption roots unmounted by this command.

filesystem|mountpoint

Unmount the specified filesystem. The command can also be given a path to a ZFS file system mount point on the system.

Releases

3 releases since Debian 11 (Bullseye); the text changed 2 times.

  1. 11
  2. 12
  3. 13

--json since Debian 13 (Trixie); -R since Debian 13 (Trixie); -j since Debian 13 (Trixie).

From zfsutils-linux 2.3.9-0+deb13u1 in Debian 13 (Trixie). Parsed by carta from the page's mdoc source.