1 ''' $Id: uustat.1,v 1.12 1995/06/26 20:34:30 ian Rel $
2 .TH uustat 1 "Taylor UUCP 1.06"
4 uustat \- UUCP status inquiry and control
103 command can display various types of status information about the UUCP
104 system. It can also be used to cancel or rejuvenate requests made by
112 displays all jobs queued up for the invoking user, as if given the
114 option with the appropriate argument.
137 options are given, then all jobs which match the combined
138 specifications are displayed.
144 option may be used to kill off a selected group of jobs, such as all
145 jobs more than 7 days old.
147 The following options may be given to
151 List all queued file transfer requests.
153 .B \-e, \-\-executions
154 List queued execution requests rather than queued file transfer
155 requests. Queued execution requests are processed by
159 (8). Queued execution requests may be waiting for some file to be
160 transferred from a remote system. They are created by an invocation
165 .B \-s system, \-\-system system
166 List all jobs queued up for the named system. These options may be
167 specified multiple times, in which case all jobs for all the systems
168 will be listed. If used with
170 only the systems named will be listed.
172 .B \-S system, \-\-not-system system
173 List all jobs queued for systems other than the one named. These
174 options may be specified multiple times, in which case no jobs from
175 any of the specified systems will be listed. If used with
177 only the systems not named will be listed. These options may not be
183 .B \-u user, \-\-user user
184 List all jobs queued up for the named user. These options may be
185 specified multiple times, in which case all jobs for all the users
188 .B \-U user, \-\-not-user user
189 List all jobs queued up for users other than the one named. These
190 options may be specified multiple times, in which case no jobs from
191 any of the specified users will be listed. These options may not be
197 .B \-c command, \-\-command command
198 List all jobs requesting the execution of the named command. If
202 this will list all jobs requesting the execution of some command (as
203 opposed to simply requesting a file transfer). These options may be
204 specified multiple times, in which case all jobs requesting any of the
205 commands will be listed.
207 .B \-C command, \-\-not-command command
208 List all jobs requesting execution of some command other than the
209 named command, or, if
213 list all jobs that simply request a file transfer (as opposed to
214 requesting the execution of some command). These options may be
215 specified multiple times, in which case no job requesting one of the
216 specified commands will be listed. These options may not be used with
221 .B \-o hours, \-\-older-than hours
222 List all queued jobs older than the given number of hours. If used
225 only systems whose oldest job is older than the given number of hours
228 .B \-y hours, \-\-younger-than hours
229 List all queued jobs younger than the given number of hours. If used
232 only systems whose oldest job is younger than the given number of
233 hours will be listed.
235 .B \-k jobid, \-\-kill jobid
236 Kill the named job. The job id is shown by the default output format,
245 (1). A job may only be killed by the user who created the job, or by
246 the UUCP administrator or the superuser. The
250 options may be used multiple times on the command line to kill several
253 .B \-r jobid, \-\-rejuvenate jobid
254 Rejuvenate the named job. This will mark it as having been invoked at
255 the current time, affecting the output of the
261 options and preserving it from any automated cleanup daemon. The job
262 id is shown by the default output format, as well as by the
270 (1). A job may only be rejuvenated by the user who created the job,
271 or by the UUCP administrator or the superuser. The
275 options may be used multiple times on the command line to rejuvenate
279 Display the status of commands, executions and conversations for all
280 remote systems for which commands or executions are queued. The
290 options may be used to restrict the systems which are listed. Systems
291 for which no commands or executions are queued will never be listed.
294 Display the status of conversations for all remote systems.
297 Display the status of all processes holding UUCP locks on systems or
301 For each listed job, prompt whether to kill the job or not. If the
302 first character of the input line is
306 the job will be killed.
309 Automatically kill each listed job. This can be useful for automatic
310 cleanup scripts, in conjunction with the
316 .B \-R, \-\-rejuvenate-all
317 Automatically rejuvenate each listed job. This may not be used with
321 For each listed job, send mail to the UUCP administrator. If the job
326 with an affirmative response) the mail will indicate that. A comment
329 option may be included. If the job is an execution, the initial
330 portion of its standard input will be included in the mail message;
331 the number of lines to include may be set with the
333 option (the default is 100). If the standard input contains null
334 characters, it is assumed to be a binary file and is not included.
337 For each listed job, send mail to the user who requested the job. The
338 mail is identical to that sent by the
344 .B \-W comment, \-\-comment comment
345 Specify a comment to be included in mail sent with the
353 .B \-B lines, \-\-mail-lines lines
360 options are used to send mail about an execution with standard input,
361 this option controls the number of lines of standard input to include
362 in the message. The default is 100.
365 Do not actually list the job, but only take any actions indicated by
378 .B \-x type, \-\-debug type
379 Turn on particular debugging types. The following types are
380 recognized: abnormal, chat, handshake, uucp-proto, proto, port,
381 config, spooldir, execute, incoming, outgoing. Only abnormal, config,
382 spooldir and execute are meaningful for
385 Multiple types may be given, separated by commas, and the
387 option may appear multiple times. A number may also be given, which
388 will turn on that many types from the foregoing list; for example,
391 .B \-\-debug abnormal,chat.
393 .B \-I file, \-\-config file
394 Set configuration file to use. This option may not be available,
400 Report version information and exit.
403 Print a help message and exit.
409 Display status of all jobs. A sample output line is as follows:
413 bugsA027h bugs ian 04-01 13:50 Executing rmail ian@airs.com (sending 1283 bytes)
420 jobid system user queue-date command (size)
423 The jobid may be passed to the
428 The size indicates how much data is to be transferred to the remote
429 system, and is absent for a file receive request.
440 options may be used to control which jobs are listed.
446 Display status of queued up execution requests. A sample output line
451 bugs bugs!ian 05-20 12:51 rmail ian
458 system requestor queue-date command
471 options may be used to control which requests are listed.
477 Display status for all systems with queued up commands. A sample
478 output line is as follows:
482 bugs 4C (1 hour) 0X (0 secs) 04-01 14:45 Dial failed
485 This indicates the system, the number of queued commands, the age of
486 the oldest queued command, the number of queued local executions, the
487 age of the oldest queued execution, the date of the last conversation,
488 and the status of that conversation.
494 Display conversation status for all remote systems. A sample output
499 bugs 04-01 15:51 Conversation complete
502 This indicates the system, the date of the last conversation, and the
503 status of that conversation. If the last conversation failed,
505 will indicate how many attempts have been made to call the system. If
506 the retry period is currently preventing calls to that system,
508 also displays the time when the next call will be permitted.
514 Display the status of all processes holding UUCP locks. The output
515 format is system dependent, as
519 (1) on each process holding a lock.
524 uustat --command rmail --older-than 168 --kill-all --no-list --mail --notify --comment "Queued for over 1 week"
529 commands that have been queued up waiting for delivery for over 1 week
530 (168 hours). For each such command, mail will be sent both to the
531 UUCP administrator and to the user who requested the rmail execution.
532 The mail message sent will include the string given by the
536 option prevents any of the jobs from being listed on the terminal, so
537 any output from the program will be error messages.
539 The file names may be changed at compilation time or by the
540 configuration file, so these are only approximations.
543 /usr/lib/uucp/config - Configuration file.
546 UUCP spool directory.
548 ps(1), rmail(1), uucp(1), uux(1), uucico(8), uuxqt(8)