1 08/19/88  list_retrieval_requests, lrr
 2 
 3 Syntax as a command:  lrr {path} {-control_args}
 4 
 5 
 6 Function: lists retrieval requests in the retrieval daemon queues.
 7 The request identifier and entryname of each request are printed.
 8 
 9 
10 Arguments:
11 path
12    is the pathname of a request to be listed.  The star convention is
13    allowed.  Only requests matching this pathname are selected.  If you
14    give no path, all pathnames are selected.  This argument is
15    incompatible with -entry.
16 
17 
18 Control arguments:
19 -absolute_pathname, -absp
20    prints the full pathname of each selected request, rather than the
21    just entryname.
22 -admin {User_id}, -am {User_id}
23    selects the requests of all users, or of the user specified by
24    User_id.  If you don't choose -admin, only your own requests are
25    selected.  This control argument is incompatible with -user.  (See
26    "Access required" and "Notes" below.)
27 -all, -a
28    searches all queues and prints the totals for each nonempty queue
29    whether or not any requests are selected from it.  This control
30    argument is incompatible with -queue.
31 
32 
33 -brief, -bf
34    does not print the state and comment of each request.  This control
35    argument is incompatible with -long and -total.
36 -entry STR, -et STR
37    selects only requests whose entrynames match STR.  The star
38    convention is allowed.  Directory portions of request pathnames are
39    ignored when selecting requests.
40 -id ID
41    selects only requests whose identifiers match the specified ID.
42 -long, -lg
43    prints all the information pertaining to a retrieval request.  If
44    you omit -long, only the full pathname of the object or subtree to
45    be retrieved is printed.
46 -long_id, -lgid
47    prints the long the request identifier.
48 
49 
50 -position, -psn
51    prints the position within its queue of each selected request.  When
52    used with -total, it prints a list of all the positions of the
53    selected requests.  (See "Access required.")
54 -queue N, -q N
55    searches only queue N.  If you don't select -queue, all queues are
56    searched but nothing is printed for queues from which no requests
57    are selected.
58 -total, -tt
59    prints only the total number of selected requests and the total
60    number of requests in the queue plus a list of positions if you
61    choose -position.  If the queue is empty, it is not listed.
62 -user User_id
63    selects only requests entered by the specified user.  (See "Access
64    required" and "Notes" below.)
65 
66 
67 Access required: You must have o access to the queue(s).  You must
68 have r extended access to the queue(s) to use -admin, -position, or
69 -user, since it is necessary to read all requests in the queue(s) to
70 select those entered by a specified user.
71 
72 
73 Notes: The default condition is to list only pathnames for the default
74 queue.
75 
76 The User_id arguments specified after -admin or -user can have any of
77 the following forms:
78    Person_id.Project_id   matches that user only
79    Person_id.*            matches that person on any project
80    Person_id              same as Person_id.*
81    *.Project_id           matches any user on that project
82    .Project_id            same as *.Project_id
83    *.*                    same as -admin with no User_id following it.
84 
85 If you select no arguments, only your own requests are listed.  When a
86 user name is specified with either the -admin or -user control
87 arguments, then proxy requests are selected if either the user who
88 entered the request, or the proxy user on whose behalf it was entered,
89 matches the specified user name.  If -admin User_id or -user User_id is
90 given more than once in a command, only the final instance is used.