I noticed some errors in ls(1), acl(5) and the ZFS Admin Guide about ZFS/NFSv4
ACLs:
ls(1): "read_acl (r) Permission to read the ACL of a file." The
compact
representation of read_acl is "c", not "r".
ls(1): "-c | -v The same as -l, and in addition displays the [...]"
The
options are in fact "-/ c" or "-/ v".
ls(1): "The display in verbose mode (/ v) uses full attribute [...]".
This
should read "(-/ v)".
acl(5): "execute (X)". The x should be lowercase: "(x)"
acl(5) does not document 3 ACEs: success access (S), failed access (F),
inherited (I).
The ZFS Admin Guide does not document the same 3 ACEs.
The ZFS Admin Guide gives examples listing a compact representation of ACLs
containing only 6 inheritance flags instead of 7. For example in the
section "Setting and Displaying ACLs on ZFS Files in Compact Format":
# ls -V file.1
-rw-r--r-- 1 root root 206663 Feb 16 11:00 file.1
owner@:--x-----------:------:deny
^^^^^^
7th position for flag ''I'' missing
By the way, where can I find the latest version of the ls(1) manpage online ?
I cannot find it, neither on src.opensolaris.org, nor in the manpage
consolidation download center [1]. I''d like to check whether the errors
I
found in ls(1) are fixed before submitting a bug report.
[1] http://opensolaris.org/os/downloads/manpages/
-marc
Cindy.Swearingen at Sun.COM
2008-Jul-29 15:32 UTC
[zfs-discuss] Errors in ZFS/NFSv4 ACL Documentation
Mark, Thanks for your detailed review comments. I will check where the latest man pages are online and get back to you. In the meantime, I can file the bugs to get these issues fixed on your behalf. Thanks again, Cindy Marc Bevand wrote:> I noticed some errors in ls(1), acl(5) and the ZFS Admin Guide about ZFS/NFSv4 > ACLs: > > ls(1): "read_acl (r) Permission to read the ACL of a file." The compact > representation of read_acl is "c", not "r". > > ls(1): "-c | -v The same as -l, and in addition displays the [...]" The > options are in fact "-/ c" or "-/ v". > > ls(1): "The display in verbose mode (/ v) uses full attribute [...]". This > should read "(-/ v)". > > acl(5): "execute (X)". The x should be lowercase: "(x)" > > acl(5) does not document 3 ACEs: success access (S), failed access (F), > inherited (I). > > The ZFS Admin Guide does not document the same 3 ACEs. > > The ZFS Admin Guide gives examples listing a compact representation of ACLs > containing only 6 inheritance flags instead of 7. For example in the > section "Setting and Displaying ACLs on ZFS Files in Compact Format": > # ls -V file.1 > -rw-r--r-- 1 root root 206663 Feb 16 11:00 file.1 > owner@:--x-----------:------:deny > ^^^^^^ > 7th position for flag ''I'' missing > > By the way, where can I find the latest version of the ls(1) manpage online ? > I cannot find it, neither on src.opensolaris.org, nor in the manpage > consolidation download center [1]. I''d like to check whether the errors I > found in ls(1) are fixed before submitting a bug report. > > [1] http://opensolaris.org/os/downloads/manpages/ > > -marc > > > _______________________________________________ > zfs-discuss mailing list > zfs-discuss at opensolaris.org > http://mail.opensolaris.org/mailman/listinfo/zfs-discuss
Cindy.Swearingen at Sun.COM
2008-Jul-31 21:03 UTC
[zfs-discuss] Errors in ZFS/NFSv4 ACL Documentation
Mark, I filed two bugs for these issues but they are not visible in the Opensolaris bug database yet: 6731639 More NFSv4 ACL changes for ls.1 (Nevada) 6731650 More NFSv4 ACL changes for acl.5 (Nevada) The current ls.1 man page can be displayed on docs.sun.com, here: http://docs.sun.com/app/docs/doc/819-2239/ls-1?l=en&a=view I''ve updated the SXCE ZFS Admin Guide to reflect reality. Thanks, Cindy Marc Bevand wrote:> I noticed some errors in ls(1), acl(5) and the ZFS Admin Guide about ZFS/NFSv4 > ACLs: > > ls(1): "read_acl (r) Permission to read the ACL of a file." The compact > representation of read_acl is "c", not "r". > > ls(1): "-c | -v The same as -l, and in addition displays the [...]" The > options are in fact "-/ c" or "-/ v". > > ls(1): "The display in verbose mode (/ v) uses full attribute [...]". This > should read "(-/ v)". > > acl(5): "execute (X)". The x should be lowercase: "(x)" > > acl(5) does not document 3 ACEs: success access (S), failed access (F), > inherited (I). > > The ZFS Admin Guide does not document the same 3 ACEs. > > The ZFS Admin Guide gives examples listing a compact representation of ACLs > containing only 6 inheritance flags instead of 7. For example in the > section "Setting and Displaying ACLs on ZFS Files in Compact Format": > # ls -V file.1 > -rw-r--r-- 1 root root 206663 Feb 16 11:00 file.1 > owner@:--x-----------:------:deny > ^^^^^^ > 7th position for flag ''I'' missing > > By the way, where can I find the latest version of the ls(1) manpage online ? > I cannot find it, neither on src.opensolaris.org, nor in the manpage > consolidation download center [1]. I''d like to check whether the errors I > found in ls(1) are fixed before submitting a bug report. > > [1] http://opensolaris.org/os/downloads/manpages/ > > -marc > > > _______________________________________________ > zfs-discuss mailing list > zfs-discuss at opensolaris.org > http://mail.opensolaris.org/mailman/listinfo/zfs-discuss