1 02/13/85  list_iacl_seg, lis
 2 
 3 Syntax as a command:  lis {path} {User_ids} {-control_args}
 4 
 5 
 6 Syntax as an active function:  [lis {path} {User_ids} {-control_args}]
 7 
 8 
 9 Function: lists some or all the entries on a segment initial access
10 control list (initial ACL) in 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, then 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.  (Default: to chase a link only
32    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 need status permission on the containing
43 directory.
44 
45 
46 Notes: If you invoke list_iacl_seg without any arguments, the entire
47 initial ACL for your working directory is listed.
48 
49 A segment initial ACL contains the ACL entries to be placed on segments
50 created in the specified directory.
51 
52 For information on initial ACLs, see IACL.gi.  For a description of
53 the matching strategy for User_ids, see the set_acl command.