From owner-svn-src-all@FreeBSD.ORG Thu Oct 30 10:56:39 2014 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 253C79D2; Thu, 30 Oct 2014 10:56:39 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id EBB4193C; Thu, 30 Oct 2014 10:56:38 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id s9UAucno055396; Thu, 30 Oct 2014 10:56:38 GMT (envelope-from trasz@FreeBSD.org) Received: (from trasz@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id s9UAucZ7055395; Thu, 30 Oct 2014 10:56:38 GMT (envelope-from trasz@FreeBSD.org) Message-Id: <201410301056.s9UAucZ7055395@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: trasz set sender to trasz@FreeBSD.org using -f From: Edward Tomasz Napierala Date: Thu, 30 Oct 2014 10:56:38 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r273854 - head/lib/libc/posix1e X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 Oct 2014 10:56:39 -0000 Author: trasz Date: Thu Oct 30 10:56:38 2014 New Revision: 273854 URL: https://svnweb.freebsd.org/changeset/base/273854 Log: Update acl(3) to expand on NFSv4 ACL support. MFC after: 1 month Sponsored by: The FreeBSD Foundation Modified: head/lib/libc/posix1e/acl.3 Modified: head/lib/libc/posix1e/acl.3 ============================================================================== --- head/lib/libc/posix1e/acl.3 Thu Oct 30 10:49:50 2014 (r273853) +++ head/lib/libc/posix1e/acl.3 Thu Oct 30 10:56:38 2014 (r273854) @@ -27,12 +27,12 @@ .\" .\" $FreeBSD$ .\" -.Dd November 12, 2013 +.Dd October 30, 2014 .Dt ACL 3 .Os .Sh NAME .Nm acl -.Nd introduction to the POSIX.1e ACL security API +.Nd introduction to the POSIX.1e/NFSv4 ACL security API .Sh LIBRARY .Lb libc .Sh SYNOPSIS @@ -42,13 +42,15 @@ .Fx permits file systems to export Access Control Lists via the VFS, and provides a library for userland access to and manipulation of these ACLs. -Not all file systems provide support for ACLs, and some may require that +.Fx +supports POSIX.1e and NFSv4 ACLs, but +not all file systems provide support for ACLs, and some may require that ACL support be explicitly enabled by the administrator. The library calls include routines to allocate, duplicate, retrieve, set, 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 NFSv4, AFS, NTFS, Coda, and NWFS semantics. +extensions defined that allow for ACL semantics alternative to +POSIX.1e, such as NFSv4. Where routines are non-standard, they are suffixed with _np to indicate that they are not portable. .Pp @@ -292,6 +294,8 @@ POSIX.1e support was introduced in .Fx 5.0 was the first version to include a complete ACL implementation based on extended attributes for the UFS and UFS2 file systems. +NFSv4 ACL support was introduced in +.Fx 8.0 . .Pp The .Xr getfacl 1