PERFORCE change 147231 for review

[Edward Tomasz Napierala]

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

Change 147231 by trasz at trasz_traszkan on 2008/08/12 13:46:12

	Improve manual pages.

Affected files ...

.. //depot/projects/soc2008/trasz_nfs4acl/lib/libc/posix1e/acl_get.3#2 edit
.. //depot/projects/soc2008/trasz_nfs4acl/lib/libc/posix1e/acl_set.3#2 edit

Differences ...

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

@@ -91,6 +91,18 @@
 .Va fd .
 The ACL in the working storage shall not participate in any access control
 decisions.
+.Pp
+Valid values for the
+.Va type
+argument are:
+.Pp
+.Bd -literal -offset indent -compact
+ACL_TYPE_ACCESS		POSIX.1e access ACL
+ACL_TYPE_DEFAULT	POSIX.1e default ACL
+ACL_TYPE_NFS4		NFS4 ACL
+.Ed
+.Pp
+The ACL returned will be branded accordingly.
 .Sh IMPLEMENTATION NOTES
 .Fx Ns 's
 support for POSIX.1e interfaces and features is still under
@@ -137,6 +149,7 @@
 .Xr acl 3 ,
 .Xr acl_free 3 ,
 .Xr acl_get 3 ,
+.Xr acl_get_brand_np 3 ,
 .Xr acl_set 3 ,
 .Xr posix1e 3
 .Sh STANDARDS

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

@@ -75,6 +75,21 @@
 .Fn acl_set_link_np
 function acts on a symlink rather than its target, if the target of the
 path is a symlink.
+.Pp
+Valid values for the
+.Va type
+argument are:
+.Pp
+.Bd -literal -offset indent -compact
+ACL_TYPE_ACCESS		POSIX.1e access ACL
+ACL_TYPE_DEFAULT	POSIX.1e default ACL
+ACL_TYPE_NFS4		NFS4 ACL
+.Ed
+.Pp
+Trying to set ACL_TYPE_NFS4 with
+.Va acl
+branded as POSIX, or ACL_TYPE_ACCESS or ACL_TYPE_DEFAULT with ACL
+branded as NFS4, will result in error.
 .Sh IMPLEMENTATION NOTES
 .Fx Ns 's
 support for POSIX.1e interfaces and features is still under
@@ -100,7 +115,7 @@
 does not point to a valid ACL for this object, or the ACL type
 specified in
 .Va type
-is invalid for this object, or both.
+is invalid for this object, or there is branding mismatch.
 .It Bq Er ENAMETOOLONG
 A component of a pathname exceeded 255 characters, or an
 entire path name exceeded 1023 characters.
@@ -123,6 +138,7 @@
 .Xr acl 3 ,
 .Xr acl_delete 3 ,
 .Xr acl_get 3 ,
+.Xr acl_get_brand_np 3 ,
 .Xr acl_valid 3 ,
 .Xr posix1e 3
 .Sh STANDARDS