1 03/11/76   list_acl, la
 2 
 3 Function:  The list_acl command lists the access control lists (ACLs)
 4 of files or directories.  (See "Access Control" in Section III of the
 5 M^H__^Hu_^Hl_^Ht_^Hi_^Hc_^Hs D^H_F^H_A^H_S^H_T^H_ S^H__^Hu_^Hb_^Hs_^Hy_^Hs_^Ht_^He_^Hm U^H__^Hs_^He_^Hr_^Hs'^H_ G^H__^Hu_^Hi_^Hd_^He (Order No. AT59)).
 6 
 7 
 8 
 9 Syntax:  list_acl {file_name} {User_ids} {-control_args}
10 
11 
12 where:
13 
14 1.   file_name              identifies the file whose ACL is to be
15                             listed.  If it is omitted, the home
16                             directory is assumed and no User_ids can be
17                             specified.  The star convention can be
18                             used.
19 
20 2.   User_ids               are access control names that must be of
21                             the form Person_id.Project_id.tag.  All ACL
22                             entries with matching names are listed.
23                             (For a description of the matching
24                             strategy, refer to the set_acl command.)
25                             If User_id is -a, -all, or omitted, the
26                             entire ACL is listed.
27 
28 3.   control_args           can be chosen from the following control
29                             arguments:
30 
31        -all, -a             lists the entire ACL.  This argument
32                             overrides any specified User_ids.
33 
34        -brief, -bf          suppresses the message "User name not on
35                             ACL of file/directory."
36 
37        -directory, -dr      lists the ACLs of directories only.  The
38                             default is files and directories.
39 
40 
41 Note:
42 
43 If the list_acl command is invoked with no arguments, it lists the
44 entire ACL of the home directory.
45 
46 
47 Example:
48 
49 !    list_acl notice.runoff .Faculty. Doe
50 
51 
52 lists, from the ACL of notice.runoff, all entries with Project_id
53 Faculty and the entry for Doe.*.*.
54 
55 !    list_acl *.basic
56 
57 
58 lists the whole ACL of every file in the home directory that has a
59 two-component name with a second component of basic.
60 
61 
62 !    la -wd .Faculty. *.*.*
63 
64 
65 lists access modes for all entries on the home directory's ACL whose
66 Project_id is Faculty and for the *.*.* entry.