1 10/17/84  list_iacl_dir, lid
 2 
 3 Syntax as a command:  lid {path} {User_ids} {-control_args}
 4 
 5 
 6 Syntax as an active function:  [lid {path} {User_ids} {-control_args}]
 7 
 8 
 9 Function:  lists some or all the entries on a directory initial access
10 control list (initial ACL) of a specified directory.
11 
12 
13 Arguments:
14 path
15    specifies the directory in which the directory initial ACL should be
16    listed.  If path is -working_directory (-wd) or omitted, your
17    working directory is assumed; if omitted, you can't specify
18    User_ids.  The star convention is allowed.
19 User_ids
20    are access control names of the form Person_id.Project_id.tag.  All
21    access names matching the given User_ids are listed.  If you don't
22    give User_id, the entire initial ACL is listed.
23 
24 
25 Control arguments:
26 -brief, -bf
27    suppresses the message "User name not on ACL of path."  If you
28    invoke lid as an active function and User_id is not on the initial
29    ACL, the null string is returned.
30 -chase
31    chases links matching a star name.  The default is to chase a link
32    only when specified by a nonstarred pathname.
33 -no_chase
34    does not chase links.
35 -ring N, -rg N
36    identifies the ring number whose directory initial ACL is to be
37    listed.  It can appear anywhere on the line and affects the whole
38    line.  If present, follow it by N (where 0 <= N <= 7).  If omitted,
39    your ring is assumed.
40 
41 
42 Access required:  You must have status permission on the containing
43 directory.
44 
45 
46 Notes:  If you invoke list_iacl_dir without any arguments, the entire
47 initial ACL for your working directory is listed.
48 
49 A directory initial ACL contains the ACL entries to be placed on
50 directories created in the specified directory.
51 
52 For information on initial ACLs, see the Programmer's Reference Manual.
53 For a description of the matching strategy for User_ids, see the
54 set_acl command.