PERFORCE change 147216 for review

[Edward Tomasz Napierala]

http://perforce.freebsd.org/chv.cgi?CH=147216

Change 147216 by trasz at trasz_traszkan on 2008/08/12 08:21:40

	Explain what "trivial ACL" is.

Affected files ...

.. //depot/projects/soc2008/trasz_nfs4acl/lib/libc/posix1e/acl_is_trivial_np.3#2 edit
.. //depot/projects/soc2008/trasz_nfs4acl/lib/libc/posix1e/acl_strip_np.3#2 edit

Differences ...

==== //depot/projects/soc2008/trasz_nfs4acl/lib/libc/posix1e/acl_is_trivial_np.3#2 (text+ko) ====

@@ -46,6 +46,14 @@
 function determines whether the ACL pointed to by the argument
 .Va acl
 is trivial.
+.Pp
+ACL is trivial if it can be fully expressed as a file mode without loosing
+any access rules.
+For POSIX.1e ACLs, ACL is trivial if it has the three required entries,
+one for owner, one for owning group, and one for other.
+For NFS4 ACLs, ACL is trivial if it has the "canonical six" entries.
+File having non-trivial ACL have a plus sign appended after mode bits
+in "ls -al" output.
 .Sh RETURN VALUES
 The
 .Fn acl_is_trivial

==== //depot/projects/soc2008/trasz_nfs4acl/lib/libc/posix1e/acl_strip_np.3#2 (text+ko) ====

@@ -87,6 +87,7 @@
 .El
 .Sh SEE ALSO
 .Xr acl 3 ,
+.Xr acl_is_trivial_np 3 ,
 .Xr posix1e 3
 .Sh STANDARDS
 POSIX.1e is described in IEEE POSIX.1e draft 17.