MFV r275547:

Port Illumos 'zfs allow' examples update.  While I'm there also fix
a typo.

Illumos issue:
    4181 zfs(1m): 'zfs allow' examples in the man page are outdated

MFC after:	2 weeks
This commit is contained in:
Xin LI 2014-12-13 01:55:02 +00:00
commit ce1fb8c8e8
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=275739

View File

@ -23,15 +23,15 @@
.\" Copyright (c) 2012, Glen Barber <gjb@FreeBSD.org> .\" Copyright (c) 2012, Glen Barber <gjb@FreeBSD.org>
.\" Copyright (c) 2012, Bryan Drewery <bdrewery@FreeBSD.org> .\" Copyright (c) 2012, Bryan Drewery <bdrewery@FreeBSD.org>
.\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved. .\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved.
.\" Copyright (c) 2013 Nexenta Systems, Inc. All Rights Reserved.
.\" Copyright (c) 2014, Joyent, Inc. All rights reserved. .\" Copyright (c) 2014, Joyent, Inc. All rights reserved.
.\" Copyright (c) 2013, Steven Hartland <smh@FreeBSD.org> .\" Copyright (c) 2013, Steven Hartland <smh@FreeBSD.org>
.\" Copyright (c) 2014 Nexenta Systems, Inc. All Rights Reserved.
.\" Copyright (c) 2014, Xin LI <delphij@FreeBSD.org> .\" Copyright (c) 2014, Xin LI <delphij@FreeBSD.org>
.\" Copyright (c) 2014, The FreeBSD Foundation, All Rights Reserved. .\" Copyright (c) 2014, The FreeBSD Foundation, All Rights Reserved.
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd November 12, 2014 .Dd December 12, 2014
.Dt ZFS 8 .Dt ZFS 8
.Os .Os
.Sh NAME .Sh NAME
@ -3505,10 +3505,9 @@ are also displayed.
.Bd -literal -offset 2n .Bd -literal -offset 2n
.Li # Ic zfs allow cindys create,destroy,mount,snapshot tank/cindys .Li # Ic zfs allow cindys create,destroy,mount,snapshot tank/cindys
.Li # Ic zfs allow tank/cindys .Li # Ic zfs allow tank/cindys
------------------------------------------------------------- ---- Permissions on tank/cindys --------------------------------------
Local+Descendent permissions on (tank/cindys) Local+Descendent permissions:
user cindys create,destroy,mount,snapshot user cindys create,destroy,mount,snapshot
-------------------------------------------------------------
.Ed .Ed
.It Sy Example 18 No Delegating Create Time Permissions on a Tn ZFS No Dataset .It Sy Example 18 No Delegating Create Time Permissions on a Tn ZFS No Dataset
.Pp .Pp
@ -3524,12 +3523,11 @@ are also displayed.
.Li # Ic zfs allow staff create,mount tank/users .Li # Ic zfs allow staff create,mount tank/users
.Li # Ic zfs allow -c destroy tank/users .Li # Ic zfs allow -c destroy tank/users
.Li # Ic zfs allow tank/users .Li # Ic zfs allow tank/users
------------------------------------------------------------- ---- Permissions on tank/users ---------------------------------------
Create time permissions on (tank/users) Permission sets:
create,destroy destroy
Local+Descendent permissions on (tank/users) Local+Descendent permissions:
group staff create,mount group staff create,mount
-------------------------------------------------------------
.Ed .Ed
.It Xo .It Xo
.Sy Example 19 .Sy Example 19
@ -3547,14 +3545,11 @@ are also displayed.
.Li # Ic zfs allow -s @pset create,destroy,snapshot,mount tank/users .Li # Ic zfs allow -s @pset create,destroy,snapshot,mount tank/users
.Li # Ic zfs allow staff @pset tank/users .Li # Ic zfs allow staff @pset tank/users
.Li # Ic zfs allow tank/users .Li # Ic zfs allow tank/users
------------------------------------------------------------- ---- Permissions on tank/users ---------------------------------------
Permission sets on (tank/users) Permission sets:
@pset create,destroy,mount,snapshot @pset create,destroy,mount,snapshot
Create time permissions on (tank/users) Local+Descendent permissions:
create,destroy group staff @pset
Local+Descendent permissions on (tank/users)
group staff @pset,create,mount
-------------------------------------------------------------
.Ed .Ed
.It Sy Example 20 No Delegating Property Permissions on a Tn ZFS No Dataset .It Sy Example 20 No Delegating Property Permissions on a Tn ZFS No Dataset
.Pp .Pp
@ -3566,16 +3561,15 @@ file system. The permissions on
are also displayed. are also displayed.
.Bd -literal -offset 2n .Bd -literal -offset 2n
.Li # Ic zfs allow cindys quota,reservation users/home .Li # Ic zfs allow cindys quota,reservation users/home
.Li # Ic zfs allow cindys .Li # Ic zfs allow users/home
------------------------------------------------------------- ---- Permissions on users/home ---------------------------------------
Local+Descendent permissions on (users/home) Local+Descendent permissions:
user cindys quota,reservation user cindys quota,reservation
-------------------------------------------------------------
.Li # Ic su - cindys .Li # Ic su - cindys
.Li cindys% Ic zfs set quota=10G users/home/marks .Li cindys% Ic zfs set quota=10G users/home/marks
.Li cindys% Ic zfs get quota users/home/marks .Li cindys% Ic zfs get quota users/home/marks
NAME PROPERTY VALUE SOURCE NAME PROPERTY VALUE SOURCE
users/home/marks quota 10G local users/home/marks quota 10G local
.Ed .Ed
.It Sy Example 21 No Removing ZFS Delegated Permissions on a Tn ZFS No Dataset .It Sy Example 21 No Removing ZFS Delegated Permissions on a Tn ZFS No Dataset
.Pp .Pp
@ -3589,14 +3583,11 @@ are also displayed.
.Bd -literal -offset 2n .Bd -literal -offset 2n
.Li # Ic zfs unallow staff snapshot tank/users .Li # Ic zfs unallow staff snapshot tank/users
.Li # Ic zfs allow tank/users .Li # Ic zfs allow tank/users
------------------------------------------------------------- ---- Permissions on tank/users ---------------------------------------
Permission sets on (tank/users) Permission sets:
@pset create,destroy,mount,snapshot @pset create,destroy,mount,snapshot
Create time permissions on (tank/users) Local+Descendent permissions:
create,destroy group staff @pset
Local+Descendent permissions on (tank/users)
group staff @pset,create,mount
-------------------------------------------------------------
.Ed .Ed
.It Sy Example 22 Showing the differences between a snapshot and a ZFS Dataset .It Sy Example 22 Showing the differences between a snapshot and a ZFS Dataset
.Pp .Pp