diff options
Diffstat (limited to 'man/man8/mount.zfs.8')
-rw-r--r-- | man/man8/mount.zfs.8 | 102 |
1 files changed, 28 insertions, 74 deletions
diff --git a/man/man8/mount.zfs.8 b/man/man8/mount.zfs.8 index 60baf2952..dd04b3109 100644 --- a/man/man8/mount.zfs.8 +++ b/man/man8/mount.zfs.8 @@ -1,4 +1,3 @@ -'\" t .\" .\" CDDL HEADER START .\" @@ -19,7 +18,6 @@ .\" .\" CDDL HEADER END .\" -.\" .\" Copyright 2013 Darik Horn <[email protected]>. All rights reserved. .\" .Dd May 24, 2021 @@ -37,68 +35,49 @@ .Ar mountpoint . .Sh DESCRIPTION +The .Nm -is part of the zfsutils package for Linux. It is a helper program that -is usually invoked by the +helper is used by +.Xr mount 8 +to mount filesystem snapshots and +.Sy mountpoint= Ns Ar legacy +ZFS filesystems, as well as by +.Xr zfs 8 +when the +.Ev Em $ZFS_MOUNT_HELPER +environment variable is not set. +Users should should invoke either .Xr mount 8 or .Xr zfs 8 -commands to mount a ZFS dataset. +in most cases. .Pp -All .Ar options -are handled according to the FILESYSTEM INDEPENDENT MOUNT OPTIONS -section in the -.Xr mount 8 -manual, except for those described below. +are handled according to the +.Em Temporary Mount Point Properties +section in +.Xr zfsprops 8 , +except for those described below. .Pp -The -.Ar dataset -parameter is a ZFS filesystem name, as output by the -.Nm zfs Cm load-key Fl h Fl o Ar name -command. This parameter never has a leading slash character and is -not a device name. -.Pp -The -.Ar mountpoint -parameter is the path name of a directory. +If +.Pa /etc/mtab +is a regular file and +.Fl n +was not specified, it will be updated via libmount. . .Sh OPTIONS .Bl -tag -width "-o xa" .It Fl s -Ignore bad or sloppy mount options. +Ignore unknown (sloppy) mount options. .It Fl f -Do a fake mount; do not perform the mount operation. +Do everything except actually executing the system call. .It Fl n -Do not update the /etc/mtab file. +Never update +.Pa /etc/mtab . .It Fl v -Increase verbosity. +Print resolved mount options and parser state. .It Fl h Print the usage message. -.It Fl o Ar context -This flag sets the SELinux context for all files in the filesystem -under that mountpoint. -.It Fl o Ar fscontext -This flag sets the SELinux context for the filesystem being mounted. -.It Fl o Ar defcontext -This flag sets the SELinux context for unlabeled files. -.It Fl o Ar rootcontext -This flag sets the SELinux context for the root inode of the filesystem. -.It Fl o Ar legacy -This private flag indicates that the -.Ar dataset -has an entry in the /etc/fstab file. -.It Fl o Ar noxattr -This private flag disables extended attributes. -.It Fl o Ar xattr -This private flag enables directory-based extended attributes and, if -appropriate, adds a ZFS context to the selinux system policy. -.It Fl o Ar saxattr -This private flag enables system attributed-based extended attributes and, if -appropriate, adds a ZFS context to the selinux system policy. -.It Fl o Ar dirxattr -Equivalent to -.Ar xattr . .It Fl o Ar zfsutil This private flag indicates that .Xr mount 8 @@ -107,32 +86,7 @@ is being called by the command. .El . -.Sh NOTES -ZFS conventionally requires that the -.Ar mountpoint -be an empty directory, but the Linux implementation inconsistently -enforces the requirement. -.Pp -The -.Nm -helper does not mount the contents of zvols. -. -.Sh FILES -.Bl -tag -width "/etc/fstab" -.It Pa /etc/fstab -The static filesystem table. -.It Pa /etc/mtab -The mounted filesystem table. -.El -. -.Sh AUTHORS -The primary author of -.Nm -is Brian Behlendorf <[email protected]>. -.Pp -This man page was written by Darik Horn <[email protected]>. -. .Sh SEE ALSO .Xr fstab 5 , .Xr mount 8 , -.Xr zfs 8 +.Xr zfs-mount 8 |