lsacl(1)                                                           lsacl(1)




 NAME    [Toc]    [Back]
      lsacl - list access control lists (ACLs) of files

 SYNOPSIS    [Toc]    [Back]
      /usr/bin/lsacl [-l] file...

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      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 *

      or

           lsacl .* *

 EXTERNAL INFLUENCES    [Toc]    [Back]
    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    [Toc]    [Back]
      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    [Toc]    [Back]
      List the ACL for the file dir/file1:



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 lsacl(1)                                                           lsacl(1)




           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    [Toc]    [Back]
      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    [Toc]    [Back]
      lsacl was developed by HP.

 SEE ALSO    [Toc]    [Back]
      chacl(1), getaccess(1), ls(1), getacl(2), acl(5).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003