1 08/19/88  list_daemon_requests, ldr
 2 
 3 Syntax as a command:  ldr {path} {-control_args}
 4 
 5 
 6 Function: lists requests in the I/O daemon queues.  The request
 7 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.  If you supply no
30    -all, the default queue is searched.  This control argument is
31    incompatible with -queue.
32 
33 
34 -brief, -bf
35    does not print the state and comment of each request.  This control
36    argument is incompatible with -long and -total.
37 -entry STR, -et STR
38    selects only requests whose entrynames match STR.  The star
39    convention is allowed.  Directory portions of request pathnames are
40    ignored when selecting requests.
41 -id ID
42    selects only requests whose identifier matches the specified ID.
43 -immediate, -im
44    selects only requests that can be run immediately and skips requests
45    deferred by the I/O daemon.
46 
47 
48 -long, -lg
49    prints all the information about each selected request including the
50    long request identifier and the full pathname.  If you omit -long,
51    only the short request identifier, entryname, and state are printed.
52 -long_id, -lgid
53    prints the long the request identifier.
54 -position, -psn
55    prints the position within its queue of each selected request.  When
56    used with -total, it prints a list of all the positions of the
57    selected requests.  (See "Access required" and "Notes.")
58 -queue N, -q N
59    searches only queue N.  If you don't select -queue, all queues are
60    searched but nothing is printed for queues from which no requests
61    are selected.
62 
63 
64 -request_type STR, -rqt STR
65    specifies that requests are to be found in the queue for the request
66    type identified by STR.  If you give no -request_type, the default
67    is "printer".  List request types with print_request_types.
68 -total, -tt
69    prints only the total number of selected requests and the total
70    number of requests in the queue plus a list of positions if you
71    choose -position.  If the queue is empty, it is not listed.
72 -user User_id
73    selects only requests entered by the specified user.  (See "Access
74    required" and Notes.")
75 
76 
77 Access required: You must have o access to the queue(s).  You must
78 have r extended access to the queue(s) to use -admin, -position, or
79 -user, since it is necessary to read all requests in the queue(s) to
80 select those entered by a specified user or to compute the positions of
81 the chosen requests.
82 
83 
84 Notes: The User_id arguments specified after -admin or -user can have
85 any of the following forms:
86    Person_id.Project_id   matches that user only
87    Person_id.*            matches that person on any project
88    Person_id              same as Person_id.*
89    *.Project_id           matches any user on that project
90    .Project_id            same as *.Project_id
91    *.*                    same as -admin with no User_id following it.
92 
93 If -admin User_id or -user User_id is given more than once in a
94 command, only the final instance is used.
95 
96 
97 The state is printed only if it is deferred and you don't supply
98 -brief.