|
Packit |
b0b924 |
.\" NFSv4 Access Control Lists manual pages
|
|
Packit |
b0b924 |
.\" format with: groff -man -Tascii foo.1
|
|
Packit |
b0b924 |
.\"
|
|
Packit |
b0b924 |
.\" http://www.delorie.com/gnu/docs/groff/groff_37.html
|
|
Packit |
b0b924 |
.\" http://www.schweikhardt.net/man_page_howto.html
|
|
Packit |
b0b924 |
.\"
|
|
Packit |
b0b924 |
.TH NFS4_GETFACL 1 "version 0.3.4, August 2018" "Linux" "NFSv4 Access Control Lists"
|
|
Packit |
b0b924 |
.SH NAME
|
|
Packit |
b0b924 |
nfs4_getfacl \- get NFSv4 file/directory access control lists
|
|
Packit |
b0b924 |
.SH SYNOPSIS
|
|
Packit |
b0b924 |
.B nfs4_getfacl [-HR]
|
|
Packit |
b0b924 |
file ...
|
|
Packit |
b0b924 |
.SH DESCRIPTION
|
|
Packit |
b0b924 |
.B nfs4_getfacl
|
|
Packit |
b0b924 |
will display the NFSv4 Access Control List (ACL) for the files given
|
|
Packit |
b0b924 |
as arguments, provided they are on mounted NFSv4 filesystems which
|
|
Packit |
b0b924 |
support ACLs.
|
|
Packit |
b0b924 |
|
|
Packit |
b0b924 |
If the
|
|
Packit |
b0b924 |
.BR -H / --more-help
|
|
Packit |
b0b924 |
flag is specified,
|
|
Packit |
b0b924 |
.B nfs4_getfacl
|
|
Packit |
b0b924 |
will print some information about NFSv4 ACLs and the fields used in ACEs.
|
|
Packit |
b0b924 |
|
|
Packit |
b0b924 |
If the
|
|
Packit |
b0b924 |
.BR -R / --recursive
|
|
Packit |
b0b924 |
flag is specified,
|
|
Packit |
b0b924 |
.B nfs4_getfacl
|
|
Packit |
b0b924 |
will list the NFSv4 ACLs of all files and directories recursively.
|
|
Packit |
e80be2 |
|
|
Packit |
e80be2 |
If the
|
|
Packit |
e80be2 |
.BR -c / --omit-header
|
|
Packit |
e80be2 |
flag is specified,
|
|
Packit |
e80be2 |
.B nfs4_getfacl
|
|
Packit |
e80be2 |
will not display the comment header (Do not print filename).
|
|
Packit |
b0b924 |
|
|
Packit |
b0b924 |
The output format for an NFSv4 file ACL, e.g., is:
|
|
Packit |
b0b924 |
.RS
|
|
Packit |
b0b924 |
.nf
|
|
Packit |
b0b924 |
|
|
Packit |
b0b924 |
# file: /somedir
|
|
Packit |
b0b924 |
A::OWNER@:rwatTnNcCy
|
|
Packit |
b0b924 |
A::alice@nfsdomain.org:rxtncy
|
|
Packit |
b0b924 |
A::bob@nfsdomain.org:rwadtTnNcCy
|
|
Packit |
b0b924 |
A:g:GROUP@:rtncy
|
|
Packit |
b0b924 |
D:g:GROUP@:waxTC
|
|
Packit |
b0b924 |
A::EVERYONE@:rtncy
|
|
Packit |
b0b924 |
D::EVERYONE@:waxTC
|
|
Packit |
b0b924 |
.fi
|
|
Packit |
b0b924 |
.RE
|
|
Packit |
b0b924 |
|
|
Packit |
b0b924 |
In the example output above, the user `alice@nfsdomain.org' has the equivalent
|
|
Packit |
b0b924 |
of "read" and "execute" permissions, `bob@nfsdomain.org' has "read" and
|
|
Packit |
b0b924 |
"write", and both `GROUP@' and `EVERYONE@' have "read".
|
|
Packit |
b0b924 |
|
|
Packit |
b0b924 |
The ACL listings of multiple files are separated by blank lines.
|
|
Packit |
b0b924 |
|
|
Packit |
b0b924 |
Refer to the
|
|
Packit |
b0b924 |
.BR nfs4_acl (5)
|
|
Packit |
b0b924 |
manpage for detailed information about NFSv4 ACL terminology and syntax.
|
|
Packit |
b0b924 |
.SH AUTHORS
|
|
Packit |
b0b924 |
.B nfs4_getfacl
|
|
Packit |
b0b924 |
was written by people at CITI, the Center for Information Technology Integration
|
|
Packit |
b0b924 |
.RI ( http://www.citi.umich.edu ).
|
|
Packit |
b0b924 |
This manpage was written by David Richter.
|
|
Packit |
b0b924 |
.SH CONTACT
|
|
Packit |
b0b924 |
Please send bug reports, feature requests, and comments to
|
|
Packit |
b0b924 |
.RI < linux-nfs@vger.kernel.org >.
|
|
Packit |
b0b924 |
.SH SEE ALSO
|
|
Packit |
b0b924 |
.BR nfs4_setfacl "(1), " nfs4_acl (5),
|
|
Packit |
b0b924 |
.IR RFC3530 " (NFSv4.0), NFSv4.1 Minor Version Draft."
|