HP UX Operating Systems 512

lsacl(1)

NAME

lsacl - list access control lists (ACLs) of ®les

SYNOPSIS

/usr/bin/lsacl [-l]®le...

DESCRIPTION

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

Options

lsacl recognizes the following option:

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

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

Unlike ls, lsacl cannot list ACLs of ®les in subdirectories automatically or list the ACL entries of the ®les 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 speci®ed 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 speci®ed ®le, it prints an error message to standard error, continues, and later returns a value of 2.

EXAMPLES

List the ACL for the ®le dir/file1:

lsacl dir/file1

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

lsacl -l .* *

List ACLs for all ®les under mydir:

find mydir -print sort xargs lsacl

DEPENDENCIES

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

NFS:

lsacl is not supported on remote ®les.

AUTHOR

lsacl was developed by HP.