getacl

Get NFSv4 ACL information

Synopsis

getacl [options] [file …]

Description

The getacl utility writes discretionary access control information associated with the specified file(s) to standard output. If an ACL is not in effect for a file then the standard discretionary access permissions are interpreted as an ACL containing only the required (i.e. trivial) ACL entries.

Options

-H, --half-logical

If --recursive is specified, follow symbolic links named on the command line only. Symbolic links encountered during traversal are not followed.

-h, --no-dereference

If the command line target of the operation is a symbolic link, return the ACL from the symbolic link itself rather than following the link.

Only effective if --recursive is not specified.

--help

Print this help message to stdout and exit.

-i

Append the numerical ID at the end of each ACL entry containing user or group names.

-L, --logical

If --recursive is specified, all symbolic links are followed.

-n, --numeric

Display user and group IDs numerically rather than converting to a user or group name.

-P, --physical

If --recursive is specified, no symbolic links are followed. This is the default.

-q, --omit-header

Do not write commented information about file name and ownership. This is useful when dealing with filenames with unprintable characters.

-R, --recursive

Operate recursively on files and directories.

-v

Display permissions and flags in a verbose form.

--version

Print the version of getacl to stdout and exit.

-x

Do not traverse file system mount points. Only effective if --recursive is given also.

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 -, then getacl reads a list of pathnames, each terminated by one newline character, from the standard input.

See Also

getfacl(1), setfacl(1), acl(3), acl(9), symlink(7)

Standards

The getacl utility is intended to be compliant with the general symbolic link handling for tools as described in symlink(7).