Update acl(3) to expand on NFSv4 ACL support.

MFC after:	1 month
Sponsored by:	The FreeBSD Foundation
This commit is contained in:
Edward Tomasz Napierala 2014-10-30 10:56:38 +00:00
parent 02c55812ad
commit 62bf353355
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=273854

View File

@ -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