il9763 Sdiff usr/src/man/man1m/zfs.1m

Print this page

9763 zfs(1M): broken formatting in allow/unallow description

   9 .\" or http://www.opensolaris.org/os/licensing.
  10 .\" See the License for the specific language governing permissions
  11 .\" and limitations under the License.
  12 .\"
  13 .\" When distributing Covered Code, include this CDDL HEADER in each
  14 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15 .\" If applicable, add the following below this CDDL HEADER, with the
  16 .\" fields enclosed by brackets "[]" replaced with your own identifying
  17 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  18 .\"
  19 .\" CDDL HEADER END
  20 .\"
  21 .\"
  22 .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved.
  23 .\" Copyright 2011 Joshua M. Clulow <josh@sysmgr.org>
  24 .\" Copyright (c) 2011, 2016 by Delphix. All rights reserved.
  25 .\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved.
  26 .\" Copyright (c) 2014, Joyent, Inc. All rights reserved.
  27 .\" Copyright (c) 2014 by Adam Stevko. All rights reserved.
  28 .\" Copyright (c) 2014 Integros [integros.com]
  29 .\" Copyright 2017 Nexenta Systems, Inc.
  30 .\" Copyright 2018 Joyent, Inc.
  31 .\"
  32 .Dd Feb 10, 2018
  33 .Dt ZFS 1M
  34 .Os
  35 .Sh NAME
  36 .Nm zfs
  37 .Nd configures ZFS file systems
  38 .Sh SYNOPSIS
  39 .Nm
  40 .Op Fl \?
  41 .Nm
  42 .Cm create
  43 .Op Fl p
  44 .Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
  45 .Ar filesystem
  46 .Nm
  47 .Cm create
  48 .Op Fl ps
  49 .Op Fl b Ar blocksize

3125 .Nm zfs Cm receive Fl s ,
3126 deleting its saved partially received state.
3127 .It Xo
3128 .Nm
3129 .Cm allow
3130 .Ar filesystem Ns | Ns Ar volume
3131 .Xc
3132 Displays permissions that have been delegated on the specified filesystem or
3133 volume.
3134 See the other forms of
3135 .Nm zfs Cm allow
3136 for more information.
3137 .It Xo
3138 .Nm
3139 .Cm allow
3140 .Op Fl dglu
3141 .Ar user Ns | Ns Ar group Ns Oo , Ns Ar user Ns | Ns Ar group Oc Ns ...
3142 .Ar perm Ns | Ns @ Ns Ar setname Ns Oo , Ns Ar perm Ns | Ns @ Ns
3143 .Ar setname Oc Ns ...
3144 .Ar filesystem Ns | Ns Ar volume
3145 .br

3146 .Nm
3147 .Cm allow
3148 .Op Fl dl
3149 .Fl e Ns | Ns Sy everyone
3150 .Ar perm Ns | Ns @ Ns Ar setname Ns Oo , Ns Ar perm Ns | Ns @ Ns
3151 .Ar setname Oc Ns ...
3152 .Ar filesystem Ns | Ns Ar volume
3153 .Xc
3154 Delegates ZFS administration permission for the file systems to non-privileged
3155 users.
3156 .Bl -tag -width "-d"
3157 .It Fl d
3158 Allow only for the descendent file systems.
3159 .It Fl e Ns | Ns Sy everyone
3160 Specifies that the permissions be delegated to everyone.
3161 .It Fl g Ar group Ns Oo , Ns Ar group Oc Ns ...
3162 Explicitly specify that permissions are delegated to the group.
3163 .It Fl l
3164 Allow
3165 .Qq locally

3299 .Ar setname Oc Ns ...
3300 .Ar filesystem Ns | Ns Ar volume
3301 .Xc
3302 Defines or adds permissions to a permission set.
3303 The set can be used by other
3304 .Nm zfs Cm allow
3305 commands for the specified file system and its descendents.
3306 Sets are evaluated dynamically, so changes to a set are immediately reflected.
3307 Permission sets follow the same naming restrictions as ZFS file systems, but the
3308 name must begin with
3309 .Sy @ ,
3310 and can be no more than 64 characters long.
3311 .It Xo
3312 .Nm
3313 .Cm unallow
3314 .Op Fl dglru
3315 .Ar user Ns | Ns Ar group Ns Oo , Ns Ar user Ns | Ns Ar group Oc Ns ...
3316 .Oo Ar perm Ns | Ns @ Ns Ar setname Ns Oo , Ns Ar perm Ns | Ns @ Ns
3317 .Ar setname Oc Ns ... Oc
3318 .Ar filesystem Ns | Ns Ar volume
3319 .br

3320 .Nm
3321 .Cm unallow
3322 .Op Fl dlr
3323 .Fl e Ns | Ns Sy everyone
3324 .Oo Ar perm Ns | Ns @ Ns Ar setname Ns Oo , Ns Ar perm Ns | Ns @ Ns
3325 .Ar setname Oc Ns ... Oc
3326 .Ar filesystem Ns | Ns Ar volume
3327 .br

3328 .Nm
3329 .Cm unallow
3330 .Op Fl r
3331 .Fl c
3332 .Oo Ar perm Ns | Ns @ Ns Ar setname Ns Oo , Ns Ar perm Ns | Ns @ Ns
3333 .Ar setname Oc Ns ... Oc
3334 .Ar filesystem Ns | Ns Ar volume
3335 .Xc
3336 Removes permissions that were granted with the
3337 .Nm zfs Cm allow
3338 command.
3339 No permissions are explicitly denied, so other permissions granted are still in
3340 effect.
3341 For example, if the permission is granted by an ancestor.
3342 If no permissions are specified, then all permissions for the specified
3343 .Ar user ,
3344 .Ar group ,
3345 or
3346 .Sy everyone
3347 are removed.

   9 .\" or http://www.opensolaris.org/os/licensing.
  10 .\" See the License for the specific language governing permissions
  11 .\" and limitations under the License.
  12 .\"
  13 .\" When distributing Covered Code, include this CDDL HEADER in each
  14 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15 .\" If applicable, add the following below this CDDL HEADER, with the
  16 .\" fields enclosed by brackets "[]" replaced with your own identifying
  17 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  18 .\"
  19 .\" CDDL HEADER END
  20 .\"
  21 .\"
  22 .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved.
  23 .\" Copyright 2011 Joshua M. Clulow <josh@sysmgr.org>
  24 .\" Copyright (c) 2011, 2016 by Delphix. All rights reserved.
  25 .\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved.
  26 .\" Copyright (c) 2014, Joyent, Inc. All rights reserved.
  27 .\" Copyright (c) 2014 by Adam Stevko. All rights reserved.
  28 .\" Copyright (c) 2014 Integros [integros.com]
  29 .\" Copyright 2018 Nexenta Systems, Inc.
  30 .\" Copyright 2018 Joyent, Inc.
  31 .\"
  32 .Dd Feb 10, 2018
  33 .Dt ZFS 1M
  34 .Os
  35 .Sh NAME
  36 .Nm zfs
  37 .Nd configures ZFS file systems
  38 .Sh SYNOPSIS
  39 .Nm
  40 .Op Fl \?
  41 .Nm
  42 .Cm create
  43 .Op Fl p
  44 .Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
  45 .Ar filesystem
  46 .Nm
  47 .Cm create
  48 .Op Fl ps
  49 .Op Fl b Ar blocksize

3125 .Nm zfs Cm receive Fl s ,
3126 deleting its saved partially received state.
3127 .It Xo
3128 .Nm
3129 .Cm allow
3130 .Ar filesystem Ns | Ns Ar volume
3131 .Xc
3132 Displays permissions that have been delegated on the specified filesystem or
3133 volume.
3134 See the other forms of
3135 .Nm zfs Cm allow
3136 for more information.
3137 .It Xo
3138 .Nm
3139 .Cm allow
3140 .Op Fl dglu
3141 .Ar user Ns | Ns Ar group Ns Oo , Ns Ar user Ns | Ns Ar group Oc Ns ...
3142 .Ar perm Ns | Ns @ Ns Ar setname Ns Oo , Ns Ar perm Ns | Ns @ Ns
3143 .Ar setname Oc Ns ...
3144 .Ar filesystem Ns | Ns Ar volume
3145 .Xc
3146 .It Xo
3147 .Nm
3148 .Cm allow
3149 .Op Fl dl
3150 .Fl e Ns | Ns Sy everyone
3151 .Ar perm Ns | Ns @ Ns Ar setname Ns Oo , Ns Ar perm Ns | Ns @ Ns
3152 .Ar setname Oc Ns ...
3153 .Ar filesystem Ns | Ns Ar volume
3154 .Xc
3155 Delegates ZFS administration permission for the file systems to non-privileged
3156 users.
3157 .Bl -tag -width "-d"
3158 .It Fl d
3159 Allow only for the descendent file systems.
3160 .It Fl e Ns | Ns Sy everyone
3161 Specifies that the permissions be delegated to everyone.
3162 .It Fl g Ar group Ns Oo , Ns Ar group Oc Ns ...
3163 Explicitly specify that permissions are delegated to the group.
3164 .It Fl l
3165 Allow
3166 .Qq locally

3300 .Ar setname Oc Ns ...
3301 .Ar filesystem Ns | Ns Ar volume
3302 .Xc
3303 Defines or adds permissions to a permission set.
3304 The set can be used by other
3305 .Nm zfs Cm allow
3306 commands for the specified file system and its descendents.
3307 Sets are evaluated dynamically, so changes to a set are immediately reflected.
3308 Permission sets follow the same naming restrictions as ZFS file systems, but the
3309 name must begin with
3310 .Sy @ ,
3311 and can be no more than 64 characters long.
3312 .It Xo
3313 .Nm
3314 .Cm unallow
3315 .Op Fl dglru
3316 .Ar user Ns | Ns Ar group Ns Oo , Ns Ar user Ns | Ns Ar group Oc Ns ...
3317 .Oo Ar perm Ns | Ns @ Ns Ar setname Ns Oo , Ns Ar perm Ns | Ns @ Ns
3318 .Ar setname Oc Ns ... Oc
3319 .Ar filesystem Ns | Ns Ar volume
3320 .Xc
3321 .It Xo
3322 .Nm
3323 .Cm unallow
3324 .Op Fl dlr
3325 .Fl e Ns | Ns Sy everyone
3326 .Oo Ar perm Ns | Ns @ Ns Ar setname Ns Oo , Ns Ar perm Ns | Ns @ Ns
3327 .Ar setname Oc Ns ... Oc
3328 .Ar filesystem Ns | Ns Ar volume
3329 .Xc
3330 .It Xo
3331 .Nm
3332 .Cm unallow
3333 .Op Fl r
3334 .Fl c
3335 .Oo Ar perm Ns | Ns @ Ns Ar setname Ns Oo , Ns Ar perm Ns | Ns @ Ns
3336 .Ar setname Oc Ns ... Oc
3337 .Ar filesystem Ns | Ns Ar volume
3338 .Xc
3339 Removes permissions that were granted with the
3340 .Nm zfs Cm allow
3341 command.
3342 No permissions are explicitly denied, so other permissions granted are still in
3343 effect.
3344 For example, if the permission is granted by an ancestor.
3345 If no permissions are specified, then all permissions for the specified
3346 .Ar user ,
3347 .Ar group ,
3348 or
3349 .Sy everyone
3350 are removed.