getfacl1
Get acl information
Usage
getfacl [-dhinqv]
[file ...]
Overview
The getfacl utility writes discretionary access control information associated with the specified file(s) to standard output. If the getconf(1) utility indicates that {_POSIX_ACL_EXTENDED} is not in effect for a file then the standard discretionary access permissions are interpreted as an ACL containing only the required ACL entries.
The following option is available:
-
-d, --default -
The operation applies to the default ACL of a directory instead of the access ACL. An error is generated if a default ACL cannot be associated with file. This option is not valid for NFSv4 ACLs.
-
-h -
If the target of the operation is a symbolic link, return the ACL from the symbolic link itself rather than following the link.
As-h,--helpon Linux. -
-i -
For NFSv4 ACLs, append numerical ID at the end of each entry containing user or group name. Ignored for POSIX.1e ACLs.
Not on Linux. -
-n, --numeric -
Display user and group IDs numerically rather than converting to a user or group name. Ignored for POSIX.1e ACLs.
-
-q, --omit-header -
Do not write commented information about file name and ownership. This is useful when dealing with filenames with unprintable characters.
As-c,--omit-headeron Linux. -
-s, --skip-base -
Skip files that only have a trivial ACL, as defined by acl_is_trivial_np(3). Notably, files with POSIX.1e ACLs that only represent the owner, group and other to match the mode of the file will be skipped.
-
-v -
For NFSv4 ACLs, display access mask and flags in a verbose form. Ignored for POSIX.1e ACLs.
As-v,--versionon Linux.
The following operand is available:
- file
-
A pathname of a file whose ACL shall be retrieved. If file is not specified, or a file is specified as
-, thengetfaclreads a list of pathnames, each terminated by one newline character, from the standard input.
For an explanation of the ACL syntax, see the setfacl(1) manual page.
Exit status
The getfacl utility exits 0 on success, and >0 if an error occurs.
Examples
getfacl /
Retrieve ACL for the directory /.
getfacl -d /
Retrieve the default ACL for the directory /, if any.
Releases
56 releases since FreeBSD 5.0-RELEASE; the text changed 37 times.
- 5.0
- 5.1–5.2.1
- 5.3–5.5
- 6.0
- 6.1–6.3
- 6.4
- 7.0
- 7.1
- 7.2
- 7.3
- 7.4
- 8.0
- 8.1
- 8.2
- 8.3
- 8.4
- 9.0
- 9.1
- 9.2
- 9.3
- 10.0
- 10.1
- 10.2
- 10.3
- 10.4
- 11.0
- 11.1
- 11.2
- 11.3
- 11.4
- 12.0
- 12.1
- 12.2
- 12.3
- 12.4
- 13.0–13.2
- 13.3–14.5
- 15.0–16.0
--default since FreeBSD 15.0-RELEASE;
--numeric since FreeBSD 15.0-RELEASE;
--omit-header since FreeBSD 15.0-RELEASE;
--skip-base since FreeBSD 15.0-RELEASE;
-h since FreeBSD 5.1-RELEASE;
-i since FreeBSD 8.1-RELEASE;
-n since FreeBSD 8.1-RELEASE;
-q since FreeBSD 6.1-RELEASE;
-s since FreeBSD 15.0-RELEASE;
-v since FreeBSD 8.1-RELEASE.