lsacl(1)

NAME

lsacl — list access control lists (ACLs) of files

SYNOPSIS

/usr/bin/lsacl [-l] file...

DESCRIPTION

lsacl lists access control lists (ACLs) of one or more files in symbolic, ``short'' form, one file's ACL per line of output, followed by the file name; see acl(5) for ACL syntax.

Options

lsacl recognizes the following option:

-l: Print ACLs in long form. Each file's ACL can be more than one line long, and is always preceded by file name, colon, and newline. Consecutive file names are separated by blank lines.

If a hyphen (-) is given as a file name argument, lsacl prints the ACL for the standard input. By default, it prints the file name as -. For the -l option it prints a file name of <stdin>.

Unlike ls, lsacl cannot list ACLs of files in subdirectories automatically or list the ACL entries of the files in the current directory by default. A good way to do the latter is:

lsacl * 

lsacl .* * 

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed.

If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG. If any internationalization variable contains an invalid setting, lsacl behaves as if all internationalization variables are set to "C". See environ(5).

RETURN VALUE

If lsacl succeeds, it returns zero. If invoked incorrectly, it returns a value of 1. If lsacl is unable to read the ACL for a specified file, it prints an error message to standard error, continues, and later returns a value of 2.

EXAMPLES

List the ACL for the file dir/file1:

lsacl dir/file1 

List ACLs for all files in the current directory, in long form.

lsacl -l .* * 

List ACLs for all files under mydir:

find mydir -print | sort | xargs lsacl 

DEPENDENCIES

lsacl will fail when the target file resides on a file system which does not support ACLs.

NFS:

lsacl is not supported on remote files.

AUTHOR

lsacl was developed by HP.