1uustat(1) General Commands Manual uustat(1)
2
6 uustat - UUCP status inquiry and control
7
9 uustat -a
10 uustat --all
12 uustat [ -eKRiMNQ ] [ -sS system ] [ -uU user ] [ -cC command ] [ -oy
14 hours ] [ -B lines ] [ --executions ] [ --kill-all ] [ --rejuvenate-all
15 ] [ --prompt ] [ --mail ] [ --notify ] [ --no-list ] [ --system system
16 ] [ --not-system system ] [ --user user ] [ --not-user user ] [ --com‐
17 mand command ] [ --not-command command ] [ --older-than hours ] [
18 --younger-than hours ] [ --mail-lines lines ]
19 uustat [ -kr jobid ] [ --kill jobid ] [ --rejuvenate jobid ]
21 uustat -q [ -sS system ] [ -oy hours ] [ --system system ] [ --not-sys‐
23 tem system ] [ --older-than hours ] [ --younger-than hours ]
24 uustat --list [ -sS system ] [ -oy hours ] [ --system system ] [ --not-
26 system system ] [ --older-than hours ] [ --younger-than hours ]
27 uustat -m
29 uustat --status
31 uustat -p
33 uustat --ps
35
37 The uustat command can display various types of status information
38 about the UUCP system. It can also be used to cancel or rejuvenate
39 requests made by uucp (1) or uux (1).
40 By default uustat displays all jobs queued up for the invoking user, as
42 if given the --user option with the appropriate argument.
43 If any of the -a, --all, -e, --executions, -s, --system, -S, --not-sys‐
45 tem, -u, --user, -U, --not-user, -c, --command, -C, --not-command, -o,
46 --older-than, -y, --younger-than options are given, then all jobs which
47 match the combined specifications are displayed.
48 The -K or --kill-all option may be used to kill off a selected group of
50 jobs, such as all jobs more than 7 days old.
51
53 The following options may be given to uustat.
54 -a, --all
56 List all queued file transfer requests.
57 -e, --executions
59 List queued execution requests rather than queued file transfer
60 requests. Queued execution requests are processed by uuxqt (8)
61 rather than uucico (8). Queued execution requests may be waiting
62 for some file to be transferred from a remote system. They are
63 created by an invocation of uux (1).
64 -s system, --system system
66 List all jobs queued up for the named system. These options may
67 be specified multiple times, in which case all jobs for all the
68 systems will be listed. If used with --list only the systems
69 named will be listed.
70 -S system, --not-system system
72 List all jobs queued for systems other than the one named. These
73 options may be specified multiple times, in which case no jobs
74 from any of the specified systems will be listed. If used with
75 --list only the systems not named will be listed. These options
76 may not be used with -s or --system.
77 -u user, --user user
79 List all jobs queued up for the named user. These options may be
80 specified multiple times, in which case all jobs for all the users
81 will be listed.
82 -U user, --not-user user
84 List all jobs queued up for users other than the one named. These
85 options may be specified multiple times, in which case no jobs
86 from any of the specified users will be listed. These options may
87 not be used with -u or --user.
88 -c command, --command command
90 List all jobs requesting the execution of the named command. If
91 command is ALL this will list all jobs requesting the execution of
92 some command (as opposed to simply requesting a file transfer).
93 These options may be specified multiple times, in which case all
94 jobs requesting any of the commands will be listed.
95 -C command, --not-command command
97 List all jobs requesting execution of some command other than the
98 named command, or, if command is ALL, list all jobs that simply
99 request a file transfer (as opposed to requesting the execution of
100 some command). These options may be specified multiple times, in
101 which case no job requesting one of the specified commands will be
102 listed. These options may not be used with -c or --command.
103 -o hours, --older-than hours
105 List all queued jobs older than the given number of hours. If
106 used with --list only systems whose oldest job is older than the
107 given number of hours will be listed.
108 -y hours, --younger-than hours
110 List all queued jobs younger than the given number of hours. If
111 used with --list only systems whose oldest job is younger than the
112 given number of hours will be listed.
113 -k jobid, --kill jobid
115 Kill the named job. The job id is shown by the default output
116 format, as well as by the -j or --jobid option to uucp (1) or uux
117 (1). A job may only be killed by the user who created the job, or
118 by the UUCP administrator or the superuser. The -k or --kill
119 options may be used multiple times on the command line to kill
120 several jobs.
121 -r jobid, --rejuvenate jobid
123 Rejuvenate the named job. This will mark it as having been
124 invoked at the current time, affecting the output of the -o,
125 --older-than, -y, or --younger-than options and preserving it from
126 any automated cleanup daemon. The job id is shown by the default
127 output format, as well as by the -j or --jobid options to uucp (1)
128 or uux (1). A job may only be rejuvenated by the user who created
129 the job, or by the UUCP administrator or the superuser. The -r or
130 --rejuvenate options may be used multiple times on the command
131 line to rejuvenate several jobs.
132 -q, --list
134 Display the status of commands, executions and conversations for
135 all remote systems for which commands or executions are queued.
136 The -s, --system, -S, --not-system, -o, --older-than, -y, and
137 --younger-than options may be used to restrict the systems which
138 are listed. Systems for which no commands or executions are
139 queued will never be listed.
140 -m, --status
142 Display the status of conversations for all remote systems.
143 -p, --ps
145 Display the status of all processes holding UUCP locks on systems
146 or ports.
147 -i, --prompt
149 For each listed job, prompt whether to kill the job or not. If
150 the first character of the input line is y or Y the job will be
151 killed.
152 -K, --kill-all
154 Automatically kill each listed job. This can be useful for auto‐
155 matic cleanup scripts, in conjunction with the --mail and --notify
156 options.
157 -R, --rejuvenate-all
159 Automatically rejuvenate each listed job. This may not be used
160 with --kill-all.
161 -M, --mail
163 For each listed job, send mail to the UUCP administrator. If the
164 job is killed (due to --kill-all or --prompt with an affirmative
165 response) the mail will indicate that. A comment specified by the
166 --comment option may be included. If the job is an execution, the
167 initial portion of its standard input will be included in the mail
168 message; the number of lines to include may be set with the
169 --mail-lines option (the default is 100). If the standard input
170 contains null characters, it is assumed to be a binary file and is
171 not included.
172 -N, --notify
174 For each listed job, send mail to the user who requested the job.
175 The mail is identical to that sent by the -M or --mail options.
176 -W comment, --comment comment
178 Specify a comment to be included in mail sent with the -M, --mail,
179 -N, or --notify options.
180 -B lines, --mail-lines lines
182 When the -M, --mail, -N, or --notify options are used to send mail
183 about an execution with standard input, this option controls the
184 number of lines of standard input to include in the message. The
185 default is 100.
186 -Q, --no-list
188 Do not actually list the job, but only take any actions indicated
189 by the -i, --prompt, -K, --kill-all, -M, --mail, -N or --notify
190 options.
191 -x type, --debug type
193 Turn on particular debugging types. The following types are rec‐
194 ognized: abnormal, chat, handshake, uucp-proto, proto, port, con‐
195 fig, spooldir, execute, incoming, outgoing. Only abnormal, con‐
196 fig, spooldir and execute are meaningful for uustat.
197 Multiple types may be given, separated by commas, and the --debug
199 option may appear multiple times. A number may also be given,
200 which will turn on that many types from the foregoing list; for
201 example, --debug 2 is equivalent to --debug abnormal,chat.
202 -I file, --config file
204 Set configuration file to use. This option may not be available,
205 depending upon how uustat was compiled.
206 -v, --version
208 Report version information and exit.
209 --help
211 Print a help message and exit.
212
214 uustat --all
215 Display status of all jobs. A sample output line is as follows:
216 bugsA027h bugs ian 04-01 13:50 Executing rmail ian@airs.com (sending 1283 bytes)
217 The format is
218 jobid system user queue-date command (size)
219 The jobid may be passed to the --kill or --rejuvenate options. The
220 size indicates how much data is to be transferred to the remote system,
221 and is absent for a file receive request. The --system, --not-system,
222 --user, --not-user, --command, --not-command, --older-than, and
223 --younger-than options may be used to control which jobs are listed.
224 uustat --executions
226 Display status of queued up execution requests. A sample output line
227 is as follows:
228 bugs bugs!ian 05-20 12:51 rmail ian
229 The format is
230 system requestor queue-date command
231 The --system, --not-system, --user, --not-user, --command, --not-com‐
232 mand, --older-than, and --younger-than options may be used to control
233 which requests are listed.
234 uustat --list
236 Display status for all systems with queued up commands. A sample out‐
237 put line is as follows:
238 bugs 4C (1 hour) 0X (0 secs) 04-01 14:45 Dial failed
239 This indicates the system, the number of queued commands, the age of
240 the oldest queued command, the number of queued local executions, the
241 age of the oldest queued execution, the date of the last conversation,
242 and the status of that conversation.
243 uustat --status
245 Display conversation status for all remote systems. A sample output
246 line is as follows:
247 bugs 04-01 15:51 Conversation complete
248 This indicates the system, the date of the last conversation, and the
249 status of that conversation. If the last conversation failed, uustat
250 will indicate how many attempts have been made to call the system. If
251 the retry period is currently preventing calls to that system, uustat
252 also displays the time when the next call will be permitted.
253 uustat --ps
255 Display the status of all processes holding UUCP locks. The output
256 format is system dependent, as uustat simply invokes ps (1) on each
257 process holding a lock.
258 uustat --command rmail --older-than 168 --kill-all --no-list --mail --notify --comment "Queued for over 1 week"
260 This will kill all rmail commands that have been queued up waiting for
261 delivery for over 1 week (168 hours). For each such command, mail will
262 be sent both to the UUCP administrator and to the user who requested
263 the rmail execution. The mail message sent will include the string
264 given by the --comment option. The --no-list option prevents any of
265 the jobs from being listed on the terminal, so any output from the pro‐
266 gram will be error messages.
267
269 ps(1), rmail(1), uucp(1), uux(1), uucico(8), uuxqt(8)
270
272 Ian Lance Taylor (ian@airs.com)
273 Taylor UUCP 1.07 uustat(1)