From owner-svn-src-head@FreeBSD.ORG Sat May 23 13:51:06 2009 Return-Path: <owner-svn-src-head@FreeBSD.ORG> Delivered-To: svn-src-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 225A6106566B; Sat, 23 May 2009 13:51:06 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 0FC498FC1B; Sat, 23 May 2009 13:51:06 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id n4NDp5Ne057311; Sat, 23 May 2009 13:51:05 GMT (envelope-from trasz@svn.freebsd.org) Received: (from trasz@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id n4NDp5bD057306; Sat, 23 May 2009 13:51:05 GMT (envelope-from trasz@svn.freebsd.org) Message-Id: <200905231351.n4NDp5bD057306@svn.freebsd.org> From: Edward Tomasz Napierala <trasz@FreeBSD.org> Date: Sat, 23 May 2009 13:51:05 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r192638 - head/lib/libc/posix1e X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the src tree for head/-current <svn-src-head.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>, <mailto:svn-src-head-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-src-head> List-Post: <mailto:svn-src-head@freebsd.org> List-Help: <mailto:svn-src-head-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>, <mailto:svn-src-head-request@freebsd.org?subject=subscribe> X-List-Received-Date: Sat, 23 May 2009 13:51:06 -0000 Author: trasz Date: Sat May 23 13:51:05 2009 New Revision: 192638 URL: http://svn.freebsd.org/changeset/base/192638 Log: Improve API documentation. Reviewed by: rwatson (earlier version) Modified: head/lib/libc/posix1e/acl.3 head/lib/libc/posix1e/acl_add_perm.3 head/lib/libc/posix1e/acl_get.3 head/lib/libc/posix1e/acl_set.3 head/lib/libc/posix1e/acl_set_tag_type.3 Modified: head/lib/libc/posix1e/acl.3 ============================================================================== --- head/lib/libc/posix1e/acl.3 Sat May 23 13:44:37 2009 (r192637) +++ head/lib/libc/posix1e/acl.3 Sat May 23 13:51:05 2009 (r192638) @@ -48,7 +48,7 @@ The library calls include routines to al and validate ACLs associated with file objects. As well as the POSIX.1e routines, there are a number of non-portable extensions defined that allow for alternative ACL semantics than the -POSIX.1e semantics, such as AFS, NTFS, Coda, and NWFS semantics. +POSIX.1e semantics, such as NFSv4, AFS, NTFS, Coda, and NWFS semantics. Where routines are non-standard, they are suffixed with _np to indicate that they are not portable. .Pp Modified: head/lib/libc/posix1e/acl_add_perm.3 ============================================================================== --- head/lib/libc/posix1e/acl_add_perm.3 Sat May 23 13:44:37 2009 (r192637) +++ head/lib/libc/posix1e/acl_add_perm.3 Sat May 23 13:51:05 2009 (r192638) @@ -49,6 +49,14 @@ to the permission set .Pp Note: it is not considered an error to attempt to add permissions that already exist in the permission set. +.Pp +For POSIX.1e ACLs, valid values are: +.Pp +.Bl -column -offset 3n "ACL_EXECUTE" +.It ACL_EXECUTE Execute permission +.It ACL_WRITE Write permission +.It ACL_READ Read permission +.El .Sh RETURN VALUES .Rv -std acl_add_perm .Sh ERRORS Modified: head/lib/libc/posix1e/acl_get.3 ============================================================================== --- head/lib/libc/posix1e/acl_get.3 Sat May 23 13:44:37 2009 (r192637) +++ head/lib/libc/posix1e/acl_get.3 Sat May 23 13:51:05 2009 (r192638) @@ -91,6 +91,15 @@ with the object referred to by .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 +.Bl -column -offset 3n "ACL_TYPE_DEFAULT" +.It ACL_TYPE_ACCESS POSIX.1e access ACL +.It ACL_TYPE_DEFAULT POSIX.1e default ACL +.El .Sh IMPLEMENTATION NOTES .Fx Ns 's support for POSIX.1e interfaces and features is still under Modified: head/lib/libc/posix1e/acl_set.3 ============================================================================== --- head/lib/libc/posix1e/acl_set.3 Sat May 23 13:44:37 2009 (r192637) +++ head/lib/libc/posix1e/acl_set.3 Sat May 23 13:51:05 2009 (r192638) @@ -75,6 +75,15 @@ The .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 +.Bl -column -offset 3n "ACL_TYPE_DEFAULT" +.It ACL_TYPE_ACCESS POSIX.1e access ACL +.It ACL_TYPE_DEFAULT POSIX.1e default ACL +.El .Sh IMPLEMENTATION NOTES .Fx Ns 's support for POSIX.1e interfaces and features is still under Modified: head/lib/libc/posix1e/acl_set_tag_type.3 ============================================================================== --- head/lib/libc/posix1e/acl_set_tag_type.3 Sat May 23 13:44:37 2009 (r192637) +++ head/lib/libc/posix1e/acl_set_tag_type.3 Sat May 23 13:51:05 2009 (r192638) @@ -46,6 +46,18 @@ is a POSIX.1e call that sets the ACL tag .Fa entry_d to the value of .Fa tag_type . +.Pp +Valid values are: +.Pp +.Bl -column -offset 3n "ACL_EVERYONE" +.It ACL_USER_OBJ Permissions apply to file owner +.It ACL_USER Permissions apply to additional user specified by qualifier +.It ACL_GROUP_OBJ Permissions apply to file group +.It ACL_GROUP Permissions apply to additional group specified by qualifier +.It ACL_MASK Permissions specify mask +.It ACL_OTHER Permissions apply to "other" +.It ACL_OTHER_OBJ Same as ACL_OTHER +.El .Sh RETURN VALUES .Rv -std acl_set_tag_type .Sh ERRORS