nfs4_setfacl manipulates the NFSv4 Access Control List (ACL) of one
or more files (or directories), provided they are on a mounted NFSv4
filesystem which supports ACLs.
nfs4_editfacl is equivalent to nfs4_setfacl -e.
Refer to the nfs4_acl(5) manpage for information about NFSv4 ACL
terminology and syntax.
COMMANDS-a acl_spec [index]
add the ACEs from acl_spec to file's ACL. ACEs are inserted
starting at the indexth position (DEFAULT: 1) of file's ACL.
-A acl_file [index]
add the ACEs from the acl_spec in acl_file to file's ACL.
ACEs are inserted starting at the indexth position (DEFAULT:
1) of file's ACL.
-x acl_spec | index
delete ACEs matched from acl_spec - or delete the indexth ACE
- from file's ACL. Note that the ordering of the ACEs in
acl_spec does not matter.
delete ACEs matched from the acl_spec in acl_file from file's
ACL. Note that the ordering of the ACEs in the acl_spec does
set file's ACL to acl_spec.
set file's ACL to the acl_spec in acl_file.
edit file's ACL in the editor defined in the EDITOR
environment variable (DEFAULT: vi(1)) and set the resulting
ACL upon a clean exit, assuming changes made in the editor
were saved. Note that if multiple files are specified, the
editor will be serially invoked once per file.
-m from_ace to_ace
modify file's ACL in-place by replacing from_ace with to_ace.
-?, -h, --help
display help text and exit.
display this program's version and exit.
NOTE: if '-' is given as the acl_file with the -A/-X/-S flags, the
acl_spec will be read from stdin.
recursively apply to a directory's files and subdirectories.
Similar to setfacl(1), the default behavior is to follow
symlinks given on the command line and to skip symlinks
encountered while recursing through directories.
in conjunction with -R/--recursive, a logical walk follows all
in conjunction with -R/--recursive, a physical walk skips all
display results of COMMAND, but do not save changes.
With nfs4_setfacl, one can use simple abbreviations ("aliases") to
express generic "read" (R), generic "write" (W), and generic
"execute" (X) permissions, familiar from the POSIX mode bits used by,
e.g., chmod(1). To use these aliases, one can put them in the
permissions field of an NFSv4 ACE and nfs4_setfacl will convert them:
an R is expanded to rntcy, a W is expanded to watTNcCy (with D added
to directory ACEs), and an X is expanded to xtcy. Please refer to
the nfs4_acl(5) manpage for information on specific NFSv4 ACE
For example, if one wanted to grant generic "read" and "write" access
on a file, the NFSv4 permissions field would normally contain
something like rwatTnNcCy. Instead, one might use aliases to
accomplish the same goal with RW.
The two permissions not included in any of the aliases are d (delete)
and o (write-owner). However, they can still be used: e.g., a
permissions field consisting of Wdo expresses generic "write" access
as well as the ability to delete and change ownership.
Assume that the file `foo' has the following NFSv4 ACL for the
- add ACE granting `email@example.com' generic "read" and "execute"
access (defaults to prepending ACE to ACL):
$ nfs4_setfacl -a A::firstname.lastname@example.org:rxtncy foo
- add the same ACE as above, but using aliases:
$ nfs4_setfacl -a A::email@example.com:RX foo
- edit existing ACL in a text editor and set modified ACL on clean
$ nfs4_setfacl -e foo
- set ACL (overwrites original) to contents of a spec_file named
$ nfs4_setfacl -S newacl.txt foo
- recursively set the ACLs of all files and subdirectories in the
current directory, skipping all symlinks encountered, to the ACL
contained in the spec_file named `newacl.txt':
$ nfs4_setfacl -R -P -S newacl.txt *
- delete the first ACE, but only print the resulting ACL (does not
$ nfs4_setfacl --test -x 1 foo
- delete the last two ACEs above:
$ nfs4_setfacl -x A::EVERYONE@rtncy,D::EVERYONE@:waxTC foo
- modify (in-place) the second ACE above:
$ nfs4_setfacl -m D::OWNER@:x D::OWNER@:xo foo
- set ACLs of `bar' and `frobaz' to ACL of `foo':
$ nfs4_getfacl foo | nfs4_setfacl -S - bar frobaz
This page is part of the nfs4-acl-tools (NFSv4 ACL tools) project.
Information about the project can be found at
⟨http://linux-nfs.org/wiki/index.php/Main_Page⟩. If you have a bug
report for this manual page, see
⟨http://linux-nfs.org/wiki/index.php/Main_Page⟩. This page was
obtained from the project's upstream Git repository
2020-07-14. (At that time, the date of the most recent commit that
was found in the repository was 2020-06-04.) If you discover any
rendering problems in this HTML version of the page, or you believe
there is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
Linux version 0.3.4, August 2018 NFS4_SETFACL(1)