Backport vendor changes in zfs(8) manual page (MFV r246389)
Illumos ZFS issues: 3380 zfs man page: documentation for zfs allow is confusing References: https://www.illumos.org/issues/3380 MFC after: 2 weeks
This commit is contained in:
mm
parent
385da813c5
commit
522c6ecda0
@ -1,5 +1,5 @@
|
||||
'\" te
|
||||
.\" Copyright (c) 2012, Martin Matuska <mm@FreeBSD.org>.
|
||||
.\" Copyright (c) 2013, Martin Matuska <mm@FreeBSD.org>.
|
||||
.\" All Rights Reserved.
|
||||
.\"
|
||||
.\" The contents of this file are subject to the terms of the
|
||||
@ -19,16 +19,16 @@
|
||||
.\"
|
||||
.\" Copyright (c) 2010, Sun Microsystems, Inc. All Rights Reserved.
|
||||
.\" Copyright (c) 2012 by Delphix. All rights reserved.
|
||||
.\" Copyright (c) 2012 Nexenta Systems, Inc. All Rights Reserved.
|
||||
.\" Copyright (c) 2012, Joyent, Inc. All rights reserved.
|
||||
.\" Copyright (c) 2011, Pawel Jakub Dawidek <pjd@FreeBSD.org>
|
||||
.\" Copyright (c) 2012, Glen Barber <gjb@FreeBSD.org>
|
||||
.\" Copyright (c) 2012, Bryan Drewery <bdrewery@FreeBSD.org>
|
||||
.\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved.
|
||||
.\" Copyright (c) 2013 Nexenta Systems, Inc. All Rights Reserved.
|
||||
.\"
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd February 8, 2012
|
||||
.Dd February 10, 2012
|
||||
.Dt ZFS 8
|
||||
.Os
|
||||
.Sh NAME
|
||||
@ -40,14 +40,12 @@
|
||||
.Nm
|
||||
.Cm create
|
||||
.Op Fl pu
|
||||
.Op Fl o Ar property Ns = Ns Ar value
|
||||
.Ar ... filesystem
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ... Ar filesystem
|
||||
.Nm
|
||||
.Cm create
|
||||
.Op Fl ps
|
||||
.Op Fl b Ar blocksize
|
||||
.Op Fl o Ar property Ns = Ns Ar value
|
||||
.Ar ...
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Fl V
|
||||
.Ar size volume
|
||||
.Nm
|
||||
@ -60,13 +58,13 @@
|
||||
.Sm off
|
||||
.Ar snapshot
|
||||
.Op % Ns Ar snapname
|
||||
.Op , Ns Ar ...
|
||||
.Op , Ns ...
|
||||
.Sm on
|
||||
.Nm
|
||||
.Cm snapshot
|
||||
.Op Fl r
|
||||
.Op Fl o Ar property Ns = Ns Ar value
|
||||
.Ar ... filesystem@snapname Ns | Ns Ar volume@snapname
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Ar filesystem@snapname Ns | Ns Ar volume@snapname
|
||||
.Nm
|
||||
.Cm rollback
|
||||
.Op Fl rRf
|
||||
@ -74,8 +72,8 @@
|
||||
.Nm
|
||||
.Cm clone
|
||||
.Op Fl p
|
||||
.Op Fl o Ar property Ns = Ns Ar value
|
||||
.Ar ... snapshot filesystem Ns | Ns Ar volume
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Ar snapshot filesystem Ns | Ns Ar volume
|
||||
.Nm
|
||||
.Cm promote
|
||||
.Ar clone-filesystem
|
||||
@ -103,31 +101,29 @@
|
||||
.Cm list
|
||||
.Op Fl r Ns | Ns Fl d Ar depth
|
||||
.Op Fl H
|
||||
.Op Fl o Ar property Ns Op , Ns Ar ...
|
||||
.Op Fl t Ar type Ns Op , Ns Ar ...
|
||||
.Op Fl s Ar property
|
||||
.Ar ...
|
||||
.Op Fl S Ar property
|
||||
.Ar ...
|
||||
.Op Fl o Ar property Ns Oo , Ns property Ns Oc Ns ...
|
||||
.Op Fl t Ar type Ns Oo , Ns type Ns Oc Ns ...
|
||||
.Oo Fl s Ar property Oc Ns ...
|
||||
.Oo Fl S Ar property Oc Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
|
||||
.Nm
|
||||
.Cm set
|
||||
.Ar property Ns = Ns Ar value
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot Ns ...
|
||||
.Nm
|
||||
.Cm get
|
||||
.Op Fl r Ns | Ns Fl d Ar depth
|
||||
.Op Fl Hp
|
||||
.Op Fl o Ar all | field Ns Op , Ns Ar ...
|
||||
.Op Fl t Ar type Ns Op , Ns Ar ...
|
||||
.Op Fl s Ar source Ns Op , Ns Ar ...
|
||||
.Ar all | property Ns Op , Ns Ar ...
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
|
||||
.Op Fl o Ar all | field Ns Oo , Ns Ar field Oc Ns ...
|
||||
.Op Fl t Ar type Ns Oo Ns , Ar type Oc Ns ...
|
||||
.Op Fl s Ar source Ns Oo Ns , Ns Ar source Oc Ns ...
|
||||
.Ar all | property Ns Oo Ns , Ns Ar property Oc Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot Ns ...
|
||||
.Nm
|
||||
.Cm inherit
|
||||
.Op Fl rS
|
||||
.Ar property
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot Ns ...
|
||||
.Nm
|
||||
.Cm upgrade
|
||||
.Op Fl v
|
||||
@ -139,29 +135,25 @@
|
||||
.Nm
|
||||
.Cm userspace
|
||||
.Op Fl Hinp
|
||||
.Op Fl o Ar field Ns Op , Ns Ar ...
|
||||
.Op Fl s Ar field
|
||||
.Ar ...
|
||||
.Op Fl S Ar field
|
||||
.Ar ...
|
||||
.Op Fl t Ar type Ns Op , Ns Ar ...
|
||||
.Op Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
|
||||
.Oo Fl s Ar field Oc Ns ...
|
||||
.Oo Fl S Ar field Oc Ns ...
|
||||
.Op Fl t Ar type Ns Oo Ns , Ns Ar type Oc Ns ...
|
||||
.Ar filesystem Ns | Ns Ar snapshot
|
||||
.Nm
|
||||
.Cm groupspace
|
||||
.Op Fl Hinp
|
||||
.Op Fl o Ar field Ns Op , Ns Ar ...
|
||||
.Op Fl s Ar field
|
||||
.Ar ...
|
||||
.Op Fl S Ar field
|
||||
.Ar ...
|
||||
.Op Fl t Ar type Ns Op , Ns Ar ...
|
||||
.Op Fl o Ar field Ns Oo , Ns field Oc Ns ...
|
||||
.Oo Fl s Ar field Oc Ns ...
|
||||
.Oo Fl S Ar field Oc Ns ...
|
||||
.Op Fl t Ar type Ns Oo Ns , Ns Ar type Oc Ns ...
|
||||
.Ar filesystem Ns | Ns Ar snapshot
|
||||
.Nm
|
||||
.Cm mount
|
||||
.Nm
|
||||
.Cm mount
|
||||
.Op Fl vO
|
||||
.Op Fl o Ar property Ns Op , Ns Ar ...
|
||||
.Op Fl o Ar property Ns Oo , Ns Ar property Oc Ns ...
|
||||
.Fl a | Ar filesystem
|
||||
.Nm
|
||||
.Cm unmount
|
||||
@ -193,63 +185,71 @@
|
||||
.Nm
|
||||
.Cm allow
|
||||
.Op Fl ldug
|
||||
.Cm everyone Ns | Ns Ar user Ns | Ns Ar group Ns Op , Ns Ar ...
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Ar user Ns | Ns Ar group Ns Oo Ns , Ns Ar user Ns | Ns Ar group Oc Ns ...
|
||||
.Ar perm Ns | Ns Ar @setname Ns
|
||||
.Oo Ns , Ns Ar perm Ns | Ns Ar @setname Oc Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Nm
|
||||
.Cm allow
|
||||
.Op Fl ld
|
||||
.Fl e
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Fl e Ns | Ns Cm everyone
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op Ns , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Nm
|
||||
.Cm allow
|
||||
.Fl c
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op Ns , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Nm
|
||||
.Cm allow
|
||||
.Fl s
|
||||
.Ar @setname
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op Ns , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Nm
|
||||
.Cm unallow
|
||||
.Op Fl rldug
|
||||
.Cm everyone Ns | Ns Ar user Ns | Ns Ar group Ns Op , Ns Ar ...
|
||||
.Op Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Ar user Ns | Ns Ar group Ns Oo Ns , Ns Ar user Ns | Ns Ar group Oc Ns ...
|
||||
.Oo Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ... Oc
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Nm
|
||||
.Cm unallow
|
||||
.Op Fl rld
|
||||
.Fl e
|
||||
.Op Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Fl e Ns | Ns Cm everyone
|
||||
.Oo Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ... Oc
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Nm
|
||||
.Cm unallow
|
||||
.Op Fl r
|
||||
.Fl c
|
||||
.Op Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Oo Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ... Oc
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Nm
|
||||
.Cm unallow
|
||||
.Op Fl r
|
||||
.Fl s
|
||||
.Ar @setname
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Oo Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ... Oc
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Nm
|
||||
.Cm hold
|
||||
.Op Fl r
|
||||
.Ar tag snapshot ...
|
||||
.Ar tag snapshot Ns ...
|
||||
.Nm
|
||||
.Cm holds
|
||||
.Op Fl r
|
||||
.Ar snapshot ...
|
||||
.Ar snapshot Ns ...
|
||||
.Nm
|
||||
.Cm release
|
||||
.Op Fl r
|
||||
.Ar tag snapshot ...
|
||||
.Ar tag snapshot Ns ...
|
||||
.Nm
|
||||
.Cm diff
|
||||
.Op Fl FHt
|
||||
@ -1411,8 +1411,8 @@ Displays a help message.
|
||||
.Nm
|
||||
.Cm create
|
||||
.Op Fl pu
|
||||
.Op Fl o Ar property Ns = Ns Ar value
|
||||
.Ar ... filesystem
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Ar filesystem
|
||||
.Xc
|
||||
.Pp
|
||||
Creates a new
|
||||
@ -1449,8 +1449,7 @@ options.
|
||||
.Cm create
|
||||
.Op Fl ps
|
||||
.Op Fl b Ar blocksize
|
||||
.Op Fl o Ar property Ns = Ns Ar value
|
||||
.Ar ...
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Fl V
|
||||
.Ar size volume
|
||||
.Xc
|
||||
@ -1550,7 +1549,7 @@ behavior for mounted file systems in use.
|
||||
.Sm off
|
||||
.Ar snapshot
|
||||
.Op % Ns Ar snapname
|
||||
.Op , Ns Ar ...
|
||||
.Op , Ns ...
|
||||
.Sm on
|
||||
.Xc
|
||||
.Pp
|
||||
@ -1611,8 +1610,7 @@ behavior for mounted file systems in use.
|
||||
.Nm
|
||||
.Cm snapshot
|
||||
.Op Fl r
|
||||
.Op Fl o Ar property Ns = Ns Ar value
|
||||
.Ar ...
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Ar filesystem@snapname Ns | Ns volume@snapname
|
||||
.Xc
|
||||
.Pp
|
||||
@ -1659,8 +1657,8 @@ option to force an unmount of any clone file systems that are to be destroyed.
|
||||
.Nm
|
||||
.Cm clone
|
||||
.Op Fl p
|
||||
.Op Fl o Ar property Ns = Ns Ar value
|
||||
.Ar ... snapshot filesystem Ns | Ns Ar volume
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Ar snapshot filesystem Ns | Ns Ar volume
|
||||
.Xc
|
||||
.Pp
|
||||
Creates a clone of the given snapshot. See the
|
||||
@ -1763,13 +1761,11 @@ only dataset that can be renamed recursively.
|
||||
.Cm list
|
||||
.Op Fl r Ns | Ns Fl d Ar depth
|
||||
.Op Fl H
|
||||
.Op Fl o Ar property Ns Op , Ns Ar ...
|
||||
.Op Fl t Ar type Ns Op , Ns Ar ...
|
||||
.Op Fl s Ar property
|
||||
.Ar ...
|
||||
.Op Fl S Ar property
|
||||
.Ar ...
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
|
||||
.Op Fl o Ar property Ns Oo , Ns Ar property Oc Ns ...
|
||||
.Op Fl t Ar type Ns Oo , Ns Ar type Oc Ns ...
|
||||
.Oo Fl s Ar property Oc Ns ...
|
||||
.Oo Fl S Ar property Oc Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot Ns ...
|
||||
.Xc
|
||||
.Pp
|
||||
Lists the property information for the given datasets in tabular form. If
|
||||
@ -1795,7 +1791,7 @@ will display only the dataset and its direct children.
|
||||
.It Fl H
|
||||
Used for scripting mode. Do not print headers and separate fields by a single
|
||||
tab instead of arbitrary white space.
|
||||
.It Fl o Ar property Ns Op , Ns Ar ...
|
||||
.It Fl o Ar property Ns Oo , Ns Ar property Oc Ns ...
|
||||
A comma-separated list of properties to display. The property must be:
|
||||
.Bl -bullet -offset 2n
|
||||
.It
|
||||
@ -1819,7 +1815,7 @@ shortcut for specifying
|
||||
.Sy filesystem,volume
|
||||
syntax.
|
||||
.El
|
||||
.It Fl t Ar type Ns Op , Ns Ar ...
|
||||
.It Fl t Ar type Ns Oo , Ns Ar type Oc Ns ...
|
||||
A comma-separated list of types to display, where
|
||||
.Ar type
|
||||
is one of
|
||||
@ -1882,11 +1878,11 @@ section.
|
||||
.Cm get
|
||||
.Op Fl r Ns | Ns Fl d Ar depth
|
||||
.Op Fl Hp
|
||||
.Op Fl o Ar all | field Ns Op , Ns Ar ...
|
||||
.Op Fl t Ar type Ns Op , Ns Ar ...
|
||||
.Op Fl s Ar source Ns Op , Ns Ar ...
|
||||
.Ar all | property Ns Op , Ns Ar ...
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
|
||||
.Op Fl o Ar all | field Ns Oo , Ns Ar field Oc Ns ...
|
||||
.Op Fl t Ar type Ns Oo , Ns Ar type Oc Ns ...
|
||||
.Op Fl s Ar source Ns Oo , Ns Ar source Oc Ns ...
|
||||
.Ar all | property Ns Oo , Ns Ar property Oc Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot Ns ...
|
||||
.Xc
|
||||
.Pp
|
||||
Displays properties for the given datasets. If no datasets are specified, then
|
||||
@ -1936,7 +1932,7 @@ omitted, and fields are explicitly separated by a single tab instead of an
|
||||
arbitrary amount of space.
|
||||
.It Fl p
|
||||
Display numbers in parseable (exact) values.
|
||||
.It Fl o Cm all | Ar field Ns Op , Ns Ar ...
|
||||
.It Fl o Cm all | Ar field Ns Oo , Ns Ar field Oc Ns ...
|
||||
A comma-separated list of columns to display. Supported values are
|
||||
.Sy name,property,value,received,source .
|
||||
Default values are
|
||||
@ -1944,7 +1940,7 @@ Default values are
|
||||
The keyword
|
||||
.Cm all
|
||||
specifies all columns.
|
||||
.It Fl t Ar type Ns Op , Ns Ar ...
|
||||
.It Fl t Ar type Ns Oo , Ns Ar type Oc Ns ...
|
||||
A comma-separated list of types to display, where
|
||||
.Ar type
|
||||
is one of
|
||||
@ -1952,7 +1948,7 @@ is one of
|
||||
For example, specifying
|
||||
.Fl t Cm snapshot
|
||||
displays only snapshots.
|
||||
.It Fl s Ar source Ns Op , Ns Ar ...
|
||||
.It Fl s Ar source Ns Oo , Ns Ar source Oc Ns ...
|
||||
A comma-separated list of sources to display. Those properties coming from a
|
||||
source other than those in this list are ignored. Each source must be one of
|
||||
the following:
|
||||
@ -1964,7 +1960,7 @@ The default value is all sources.
|
||||
.Cm inherit
|
||||
.Op Fl rS
|
||||
.Ar property
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot
|
||||
.Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot Ns ...
|
||||
.Xc
|
||||
.Pp
|
||||
Clears the specified property, causing it to be inherited from an ancestor. If
|
||||
@ -2039,12 +2035,10 @@ Upgrade the specified file system.
|
||||
.Nm
|
||||
.Cm userspace
|
||||
.Op Fl Hinp
|
||||
.Op Fl o Ar field Ns Op , Ns Ar ...
|
||||
.Op Fl s Ar field
|
||||
.Ar ...
|
||||
.Op Fl S Ar field
|
||||
.Ar ...
|
||||
.Op Fl t Ar type Ns Op , Ns Ar ...
|
||||
.Op Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
|
||||
.Oo Fl s Ar field Oc Ns ...
|
||||
.Oo Fl S Ar field Oc Ns ...
|
||||
.Op Fl t Ar type Ns Oo , Ns Ar type Oc Ns ...
|
||||
.Ar filesystem Ns | Ns Ar snapshot
|
||||
.Xc
|
||||
.Pp
|
||||
@ -2061,7 +2055,7 @@ Print numeric ID instead of user/group name.
|
||||
Do not print headers, use tab-delimited output.
|
||||
.It Fl p
|
||||
Use exact (parsable) numeric output.
|
||||
.It Fl o Ar field Ns Op , Ns Ar ...
|
||||
.It Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
|
||||
Display only the specified fields from the following set:
|
||||
.Sy type,name,used,quota .
|
||||
The default is to display all fields.
|
||||
@ -2076,7 +2070,7 @@ another. The default is
|
||||
.It Fl S Ar field
|
||||
Sort by this field in reverse order. See
|
||||
.Fl s .
|
||||
.It Fl t Ar type Ns Op , Ns Ar ...
|
||||
.It Fl t Ar type Ns Oo , Ns Ar type Oc Ns ...
|
||||
Print only the specified types from the following set:
|
||||
.Sy all,posixuser,smbuser,posixgroup,smbgroup .
|
||||
.Pp
|
||||
@ -2092,12 +2086,10 @@ Translate SID to POSIX ID. This flag currently has no effect on
|
||||
.Nm
|
||||
.Cm groupspace
|
||||
.Op Fl Hinp
|
||||
.Op Fl o Ar field Ns Op , Ns Ar ...
|
||||
.Op Fl s Ar field
|
||||
.Ar ...
|
||||
.Op Fl S Ar field
|
||||
.Ar ...
|
||||
.Op Fl t Ar type Ns Op , Ns Ar ...
|
||||
.Op Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
|
||||
.Oo Fl s Ar field Oc Ns ...
|
||||
.Oo Fl S Ar field Oc Ns ...
|
||||
.Op Fl t Ar type Ns Oo , Ns Ar type Oc Ns ...
|
||||
.Ar filesystem Ns | Ns Ar snapshot
|
||||
.Xc
|
||||
.Pp
|
||||
@ -2121,7 +2113,7 @@ file systems currently mounted.
|
||||
.Nm
|
||||
.Cm mount
|
||||
.Op Fl vO
|
||||
.Op Fl o Ar property Ns Op , Ns Ar ...
|
||||
.Op Fl o Ar property Ns Oo , Ns Ar property Oc Ns ...
|
||||
.Fl a | Ar filesystem
|
||||
.Xc
|
||||
.Pp
|
||||
@ -2134,7 +2126,7 @@ Report mount progress.
|
||||
.It Fl O
|
||||
Perform an overlay mount. Overlay mounts are not supported on
|
||||
.Fx .
|
||||
.It Fl o Ar property Ns Op , Ns Ar ...
|
||||
.It Fl o Ar property Ns Oo , Ns Ar property Oc Ns ...
|
||||
An optional, comma-separated list of mount options to use temporarily for the
|
||||
duration of the mount. See the
|
||||
.Qq Sx Temporary Mount Point Properties
|
||||
@ -2453,16 +2445,18 @@ for more information.
|
||||
.Nm
|
||||
.Cm allow
|
||||
.Op Fl ldug
|
||||
.Cm everyone Ns | Ns Ar user Ns | Ns Ar group Ns Op , Ns Ar ...
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Ar user Ns | Ns Ar group Ns Oo Ns , Ns Ar user Ns | Ns Ar group Oc Ns ...
|
||||
.Ar perm Ns | Ns Ar @setname Ns
|
||||
.Oo Ns , Ns Ar perm Ns | Ns Ar @setname Oc Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Xc
|
||||
.It Xo
|
||||
.Nm
|
||||
.Cm allow
|
||||
.Op Fl ld
|
||||
.Fl e
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Fl e Ns | Ns Cm everyone
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op Ns , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Xc
|
||||
.Pp
|
||||
@ -2472,26 +2466,31 @@ administration permission for the file systems to non-privileged users.
|
||||
.Bl -tag -width indent
|
||||
.It Xo
|
||||
.Op Fl ug
|
||||
.Cm everyone Ns | Ns Ar user Ns | Ns Ar group Ns Op , Ns Ar ...
|
||||
.Ar user Ns | Ns Ar group Ns Oo , Ar user Ns | Ns Ar group Oc Ns ...
|
||||
.Xc
|
||||
Specifies to whom the permissions are delegated. Multiple entities can be
|
||||
specified as a comma-separated list. If neither of the
|
||||
.Fl ug
|
||||
options are specified, then the argument is interpreted preferentially as the
|
||||
keyword "everyone", then as a user name, and lastly as a group name. To specify
|
||||
a user or group named "everyone", use the
|
||||
keyword
|
||||
.Cm everyone ,
|
||||
then as a user name, and lastly as a group name. To specify
|
||||
a user or group named
|
||||
.Qq everyone ,
|
||||
use the
|
||||
.Fl u
|
||||
or
|
||||
.Fl g
|
||||
options. To specify a group with the same name as a user, use the
|
||||
.Fl g
|
||||
option.
|
||||
.It Op Fl e Ns | Ns Cm everyone
|
||||
Specifies that the permissions be delegated to
|
||||
.Qq everyone .
|
||||
.It Xo
|
||||
.Op Fl e
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Ar perm Ns | Ns Ar @setname Ns Oo , Ns Ar perm Ns | Ns Ar @setname Oc Ns ...
|
||||
.Xc
|
||||
Specifies that the permissions be delegated to "everyone".
|
||||
Multiple permissions
|
||||
The permissions to delegate. Multiple permissions
|
||||
may be specified as a comma-separated list. Permission names are the same as
|
||||
.Tn ZFS
|
||||
subcommand and property names. See the property list below. Property set names,
|
||||
@ -2598,7 +2597,8 @@ protocol
|
||||
.Nm
|
||||
.Cm allow
|
||||
.Fl c
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op Ns , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Xc
|
||||
.Pp
|
||||
@ -2609,7 +2609,8 @@ creator of any newly-created descendent file system.
|
||||
.Cm allow
|
||||
.Fl s
|
||||
.Ar @setname
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op Ns , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ...
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Xc
|
||||
.Pp
|
||||
@ -2625,16 +2626,18 @@ and can be no more than 64 characters long.
|
||||
.Nm
|
||||
.Cm unallow
|
||||
.Op Fl rldug
|
||||
.Cm everyone Ns | Ns Ar user Ns | Ns Ar group Ns Op , Ns Ar ...
|
||||
.Op Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Ar user Ns | Ns Ar group Ns Oo Ns , Ns Ar user Ns | Ns Ar group Oc Ns ...
|
||||
.Oo Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ... Oc
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Xc
|
||||
.It Xo
|
||||
.Nm
|
||||
.Cm unallow
|
||||
.Op Fl rld
|
||||
.Fl e
|
||||
.Op Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Fl e Ns | Ns Cm everyone
|
||||
.Oo Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ... Oc
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Xc
|
||||
.It Xo
|
||||
@ -2642,7 +2645,8 @@ and can be no more than 64 characters long.
|
||||
.Cm unallow
|
||||
.Op Fl r
|
||||
.Fl c
|
||||
.Op Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Oo Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ... Oc
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Xc
|
||||
.Pp
|
||||
@ -2651,10 +2655,12 @@ Removes permissions that were granted with the
|
||||
command. No permissions are explicitly denied, so other permissions granted are
|
||||
still in effect. For example, if the permission is granted by an ancestor. If
|
||||
no permissions are specified, then all permissions for the specified
|
||||
.Ar user , group , No or Ar everyone
|
||||
are removed. Specifying "everyone" (or using the
|
||||
.Fl e
|
||||
option) only removes the permissions that were granted to "everyone",
|
||||
.Ar user , group , No or everyone
|
||||
are removed. Specifying
|
||||
.Cm everyone
|
||||
.Po or using the Fl e
|
||||
option
|
||||
.Pc only removes the permissions that were granted to everyone ,
|
||||
not all permissions for every user and group. See the
|
||||
.Qq Nm Cm allow
|
||||
command for a description of the
|
||||
@ -2670,7 +2676,8 @@ Recursively remove the permissions from this file system and all descendents.
|
||||
.Op Fl r
|
||||
.Fl s
|
||||
.Ar @setname
|
||||
.Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar ...
|
||||
.Oo Ar perm Ns | Ns Ar @setname Ns Op , Ns Ar perm Ns | Ns Ar @setname Ns
|
||||
.Ns ... Oc
|
||||
.Ar filesystem Ns | Ns Ar volume
|
||||
.Xc
|
||||
.Pp
|
||||
@ -2680,7 +2687,7 @@ then all permissions are removed, thus removing the set entirely.
|
||||
.Nm
|
||||
.Cm hold
|
||||
.Op Fl r
|
||||
.Ar tag snapshot ...
|
||||
.Ar tag snapshot Ns ...
|
||||
.Xc
|
||||
.Pp
|
||||
Adds a single reference, named with the
|
||||
@ -2701,7 +2708,7 @@ snapshots of all descendent file systems.
|
||||
.Nm
|
||||
.Cm holds
|
||||
.Op Fl r
|
||||
.Ar snapshot ...
|
||||
.Ar snapshot Ns ...
|
||||
.Xc
|
||||
.Pp
|
||||
Lists all existing user references for the given snapshot or snapshots.
|
||||
@ -2714,7 +2721,7 @@ listing the holds on the named snapshot.
|
||||
.Nm
|
||||
.Cm release
|
||||
.Op Fl r
|
||||
.Ar tag snapshot ...
|
||||
.Ar tag snapshot Ns ...
|
||||
.Xc
|
||||
.Pp
|
||||
Removes a single reference, named with the
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user