tail head cat sleep
QR code linking to this page

Manual Pages  — ZFS-ALLOW

NAME

zfs-allow – delegate ZFS administration permissions to unprivileged users

CONTENTS

SYNOPSIS


zfs allow [-dglu] user|group[,user|group ]… perm|@setname[,perm|@ setname ]… filesystem|volume
zfs allow [-dl] -e | everyone perm|@setname[,perm|@ setname ]… filesystem|volume
zfs allow -c perm|@setname[,perm|@ setname ]… filesystem|volume
zfs allow -s @setname perm|@setname[,perm|@ setname ]… filesystem|volume
zfs unallow [-dglru] user|group[,user|group ]… [perm|@setname[,perm|@ setname ]… ] filesystem|volume
zfs unallow [-dlr] -e | everyone [perm|@setname[,perm|@ setname ]… ] filesystem|volume
zfs unallow [-r] -c [perm|@setname[,perm|@ setname ]… ] filesystem|volume
zfs unallow [-r] -s @setname [perm|@setname[,perm|@ setname ]… ] filesystem|volume

DESCRIPTION

zfs allow filesystem|volume Displays permissions that have been delegated on the specified filesystem or volume. See the other forms of zfs for more information.

Delegations are supported under Linux with the exception of mount, unmount, mountpoint, canmount, rename, and share. These permissions cannot be delegated because the Linux mount(8) command restricts modifications of the global namespace to the root user.

zfs allow [-dglu] user|group[,user|group ]… perm|@setname[,perm|@ setname ]… filesystem|volume
zfs allow [-dl] -e | everyone perm|@setname[,perm|@ setname ]… filesystem|volume Delegates ZFS administration permission for the file systems to non-privileged users.
-d
  Allow only for the descendent file systems.
-e | everyone
  Specifies that the permissions be delegated to everyone.
-g group[,group ]…
  Explicitly specify that permissions are delegated to the group.
-l
  Allow "locally" only for the specified file system.
-u user[,user ]…
  Explicitly specify that permissions are delegated to the user.
user|group[,user|group ]…
  Specifies to whom the permissions are delegated. Multiple entities can be specified as a comma-separated list. If neither of the -gu 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 -g or -u options. To specify a group with the same name as a user, use the -g options.
perm|@setname[,perm|@ setname ]… The permissions to delegate. Multiple permissions may be specified as a comma-separated list. Permission names are the same as ZFS subcommand and property names. See the property list below. Property set names, which begin with @, may be specified. See the -s form below for details.

If neither of the -dl options are specified, or both are, then the permissions are allowed for the file system or volume, and all of its descendents.

Permissions are generally the ability to use a ZFS subcommand or change a ZFS property. The following permissions are available:

NAMETYPENOTES
allowsubcommandMust also have the permission that is being allowed
bookmarksubcommand
clonesubcommandMust also have the create ability and mount ability in the origin file system
createsubcommandMust also have the mount ability. Must also have the refreservation ability to create a non-sparse volume.
destroysubcommandMust also have the mount ability
diffsubcommandAllows lookup of paths within a dataset given an object number, and the ability to create snapshots necessary to zfs diff.
holdsubcommandAllows adding a user hold to a snapshot
load-keysubcommandAllows loading and unloading of encryption key (see zfs load-key and zfs unload-key).
change-keysubcommandAllows changing an encryption key via zfs change-key.
mountsubcommandAllows mounting/umounting ZFS datasets
promotesubcommandMust also have the mount and promote ability in the origin file system
receivesubcommandMust also have the mount and create ability
releasesubcommandAllows releasing a user hold which might destroy the snapshot
renamesubcommandMust also have the mount and create ability in the new parent
rollbacksubcommandMust also have the mount ability
sendsubcommand
sharesubcommandAllows sharing file systems over NFS or SMB protocols
snapshotsubcommandMust also have the mount ability
groupquotaotherAllows accessing any groupquota@... property
groupobjquotaotherAllows accessing any groupobjquota@... property
groupusedotherAllows reading any groupused@... property
groupobjusedotherAllows reading any groupobjused@... property
userpropotherAllows changing any user property
userquotaotherAllows accessing any userquota@... property
userobjquotaotherAllows accessing any userobjquota@... property
userusedotherAllows reading any userused@... property
userobjusedotherAllows reading any userobjused@... property
projectobjquotaotherAllows accessing any projectobjquota@... property
projectquotaotherAllows accessing any projectquota@... property
projectobjusedotherAllows reading any projectobjused@... property
projectusedotherAllows reading any projectused@... property
aclinheritproperty
aclmodeproperty
acltypeproperty
atimeproperty
canmountproperty
casesensitivityproperty
checksumproperty
compressionproperty
contextproperty
copiesproperty
dedupproperty
defcontextproperty
devicesproperty
dnodesizeproperty
encryptionproperty
execproperty
filesystem_limitproperty
fscontextproperty
keyformatproperty
keylocationproperty
logbiasproperty
mlslabelproperty
mountpointproperty
nbmandproperty
normalizationproperty
overlayproperty
pbkdf2itersproperty
primarycacheproperty
quotaproperty
readonlyproperty
recordsizeproperty
redundant_metadataproperty
refquotaproperty
refreservationproperty
relatimeproperty
reservationproperty
rootcontextproperty
secondarycacheproperty
setuidproperty
sharenfsproperty
sharesmbproperty
snapdevproperty
snapdirproperty
snapshot_limitproperty
special_small_blocksproperty
syncproperty
utf8onlyproperty
versionproperty
volblocksizeproperty
volmodeproperty
volsizeproperty
vscanproperty
xattrproperty
zonedproperty
zfs allow -c perm|@setname[,perm|@ setname ]… filesystem|volume Sets "create time" permissions. These permissions are granted (locally) to the creator of any newly-created descendent file system.
zfs allow -s @setname perm|@setname[,perm|@ setname ]… filesystem|volume Defines or adds permissions to a permission set. The set can be used by other zfs commands for the specified file system and its descendents. Sets are evaluated dynamically, so changes to a set are immediately reflected. Permission sets follow the same naming restrictions as ZFS file systems, but the name must begin with @, and can be no more than 64 characters long.
zfs unallow [-dglru] user|group[,user|group ]… [perm|@setname[,perm|@ setname ]… ] filesystem|volume
zfs unallow [-dlr] -e | everyone [perm|@setname[,perm|@ setname ]… ] filesystem|volume
zfs unallow [-r] -c [perm|@setname[,perm|@ setname ]… ] filesystem|volume Removes permissions that were granted with the zfs 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 user, group, or everyone are removed. Specifying everyone (or using the -e option ) only removes the permissions that were granted to everyone, not all permissions for every user and group. See the zfs command for a description of the -ldugec options.
-r
  Recursively remove the permissions from this file system and all descendents.
zfs unallow [-r] -s @setname [perm|@setname[,perm|@ setname ]… ] filesystem|volume Removes permissions from a permission set. If no permissions are specified, then all permissions are removed, thus removing the set entirely.

ZFS-ALLOW (8) May 27, 2021

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

This philosophy, in the hands of amateurs, leads to inexplicably mind-numbing botches like the existence of two programs, “head” and “tail,” which print the first part or the last part of a file, depending. Even though their operations are duals of one another, “head” and “tail” are different programs, written by different authors, and take different options!
— The Unix Haters' handbook