NAME
zfs-allow — delegate ZFS administration permissions to unprivileged users
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 allow 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:
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 allow 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 allow 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 allow 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.
EXAMPLES
Example 1: Delegating ZFS
Administration Permissions on a ZFS Dataset
The following example shows how to set permissions so that
user cindys can create, destroy, mount, and take
snapshots on tank/cindys. The permissions on
tank/cindys are also displayed.
# zfs allow cindys
create,destroy,mount,snapshot
tank/cindys
# zfs allow tank/cindys
---- Permissions on tank/cindys
--------------------------------------
Local+Descendent permissions:
user cindys create,destroy,mount,snapshot
Because the tank/cindys mount point permission is set to 755 by default, user cindys will be unable to mount file systems under tank/cindys. Add an ACE similar to the following syntax to provide mount point access:
# chmod A+user:cindys:add_subdirectory:allow /tank/cindys
Example
2: Delegating Create Time Permissions on a ZFS Dataset
The following example shows how to grant anyone in the group
staff to create file systems in tank/users.
This syntax also allows staff members to destroy their own
file systems, but not destroy anyone else’s file
system. The permissions on tank/users are also
displayed.
# zfs allow staff
create,mount tank/users
# zfs allow -c destroy tank/users
# zfs allow tank/users
---- Permissions on tank/users
---------------------------------------
Permission sets:
destroy
Local+Descendent permissions:
group staff create,mount
Example
3: Defining and Granting a Permission Set on a ZFS
Dataset
The following example shows how to define and grant a
permission set on the tank/users file system. The
permissions on tank/users are also displayed.
# zfs allow -s
@pset
create,destroy,snapshot,mount
tank/users
# zfs allow staff @pset tank/users
# zfs allow tank/users
---- Permissions on tank/users
---------------------------------------
Permission sets:
@pset create,destroy,mount,snapshot
Local+Descendent permissions:
group staff @pset
Example
4: Delegating Property Permissions on a ZFS Dataset
The following example shows to grant the ability to set
quotas and reservations on the users/home file
system. The permissions on users/home are also
displayed.
# zfs allow
cindys quota,reservation
users/home
# zfs allow users/home
---- Permissions on users/home
---------------------------------------
Local+Descendent permissions:
user cindys quota,reservation
cindys% zfs set quota=10G users/home/marks
cindys% zfs get quota users/home/marks
NAME PROPERTY VALUE SOURCE
users/home/marks quota 10G local
Example
5: Removing ZFS Delegated Permissions on a ZFS Dataset
The following example shows how to remove the snapshot
permission from the staff group on the
tank/users file system. The permissions on
tank/users are also displayed.
# zfs unallow
staff snapshot tank/users
# zfs allow tank/users
---- Permissions on tank/users
---------------------------------------
Permission sets:
@pset create,destroy,mount,snapshot
Local+Descendent permissions:
group staff @pset
OpenZFS March 16, 2022 OpenZFS