MFC r273854:

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

Sponsored by:	The FreeBSD Foundation
This commit is contained in:
trasz 2014-11-29 15:51:48 +00:00
parent 684c853eed
commit f9abf723a8

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