From owner-p4-projects@FreeBSD.ORG  Tue Aug 12 08:21:53 2008
Return-Path: <owner-p4-projects@FreeBSD.ORG>
Delivered-To: p4-projects@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 163361065676; Tue, 12 Aug 2008 08:21:53 +0000 (UTC)
Delivered-To: perforce@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id CE0EA1065674
	for <perforce@freebsd.org>; Tue, 12 Aug 2008 08:21:52 +0000 (UTC)
	(envelope-from trasz@freebsd.org)
Received: from repoman.freebsd.org (repoman.freebsd.org
	[IPv6:2001:4f8:fff6::29])
	by mx1.freebsd.org (Postfix) with ESMTP id BCE178FC08
	for <perforce@freebsd.org>; Tue, 12 Aug 2008 08:21:52 +0000 (UTC)
	(envelope-from trasz@freebsd.org)
Received: from repoman.freebsd.org (localhost [127.0.0.1])
	by repoman.freebsd.org (8.14.2/8.14.2) with ESMTP id m7C8LqXE073706
	for <perforce@freebsd.org>; Tue, 12 Aug 2008 08:21:52 GMT
	(envelope-from trasz@freebsd.org)
Received: (from perforce@localhost)
	by repoman.freebsd.org (8.14.2/8.14.1/Submit) id m7C8Lq13073704
	for perforce@freebsd.org; Tue, 12 Aug 2008 08:21:52 GMT
	(envelope-from trasz@freebsd.org)
Date: Tue, 12 Aug 2008 08:21:52 GMT
Message-Id: <200808120821.m7C8Lq13073704@repoman.freebsd.org>
X-Authentication-Warning: repoman.freebsd.org: perforce set sender to
	trasz@freebsd.org using -f
From: Edward Tomasz Napierala <trasz@FreeBSD.org>
To: Perforce Change Reviews <perforce@freebsd.org>
Cc: 
Subject: PERFORCE change 147216 for review
X-BeenThere: p4-projects@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: p4 projects tree changes <p4-projects.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/p4-projects>
List-Post: <mailto:p4-projects@freebsd.org>
List-Help: <mailto:p4-projects-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 12 Aug 2008 08:21:53 -0000

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

Change 147216 by trasz@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.