381 lines
8.9 KiB
Groff
381 lines
8.9 KiB
Groff
''' $Id: uustat.1,v 1.1 1993/08/04 19:37:04 jtc Exp $
|
|
.TH uustat 1 "Taylor UUCP 1.04"
|
|
.SH NAME
|
|
uustat \- UUCP status inquiry and control
|
|
.SH SYNOPSIS
|
|
.B uustat \-a
|
|
.PP
|
|
.B uustat
|
|
[
|
|
.B \-eKiMNQ ] [
|
|
.B \-sS
|
|
system ] [
|
|
.B \-uU
|
|
user ] [
|
|
.B \-cC
|
|
command ] [
|
|
.B \-o
|
|
hours ] [
|
|
.B \-y
|
|
hours ] [
|
|
.B \-B
|
|
lines ]
|
|
.PP
|
|
.B uustat
|
|
[
|
|
.B \-k
|
|
jobid ] [
|
|
.B \-r
|
|
jobid ]
|
|
.PP
|
|
.B uustat \-q
|
|
.PP
|
|
.B uustat \-m
|
|
.PP
|
|
.B uustat \-p
|
|
.SH DESCRIPTION
|
|
The
|
|
.I uustat
|
|
command can display various types of status information about the UUCP
|
|
system. It can also be used to cancel or rejuvenate requests made by
|
|
.I uucp
|
|
(1) or
|
|
.I uux
|
|
(1).
|
|
|
|
By default
|
|
.I uustat
|
|
displays all jobs queued up for the invoking user, as if given the
|
|
.B \-u
|
|
option with the appropriate argument.
|
|
|
|
If any of the
|
|
.B \-a,
|
|
.B \-e,
|
|
.B \-s,
|
|
.B \-S,
|
|
.B \-u,
|
|
.B \-U,
|
|
.B \-c,
|
|
.B \-C,
|
|
.B \-o,
|
|
.B \-y
|
|
options are given, then all jobs which match the combined
|
|
specifications are displayed.
|
|
|
|
The
|
|
.B \-K
|
|
option may be used to kill off a selected group of jobs, such as all
|
|
jobs more than 7 days old.
|
|
.SH OPTIONS
|
|
The following options may be given to
|
|
.I uustat.
|
|
.TP 5
|
|
.B \-a
|
|
List all queued file transfer requests.
|
|
.TP 5
|
|
.B \-e
|
|
List queued execution requests rather than queued file transfer
|
|
requests. Queued execution requests are processed by
|
|
.I uuxqt
|
|
(8) rather than
|
|
.I uucico
|
|
(8). Queued execution requests may be waiting for some file to be
|
|
transferred from a remote system. They are created by an invocation
|
|
of
|
|
.I uux
|
|
(1).
|
|
.TP 5
|
|
.B \-s system
|
|
List all jobs queued up for the named system. This option may be
|
|
specified multiple times, in which case all jobs for all the systems
|
|
will be listed.
|
|
.TP 5
|
|
.B \-S system
|
|
List all jobs queued for systems other than the one named. This
|
|
option may be specified multiple times, in which case no jobs from any
|
|
of the specified systems will be listed. This option may not be used
|
|
with
|
|
.B \-s.
|
|
.TP 5
|
|
.B \-u user
|
|
List all jobs queued up for the named user. This option may be
|
|
specified multiple times, in which case all jobs for all the users
|
|
will be listed.
|
|
.TP 5
|
|
.B \-U user
|
|
List all jobs queued up for users other than the one named. This
|
|
option may be specified multiple times, in which case no jobs from any
|
|
of the specified users will be listed. This option may not be used
|
|
with
|
|
.B \-u.
|
|
.TP 5
|
|
.B \-c command
|
|
List all jobs requesting the execution of the named command. If
|
|
.B command
|
|
is
|
|
.I ALL
|
|
this will list all jobs requesting the execution of some command (as
|
|
opposed to simply requesting a file transfer). This option may be
|
|
specified multiple times, in which case all jobs requesting any of the
|
|
commands will be listed.
|
|
.TP 5
|
|
.B \-C command
|
|
List all jobs requesting execution of some command other than the
|
|
named command, or, if
|
|
.B command
|
|
is
|
|
.I ALL,
|
|
list all jobs that simply request a file transfer (as opposed to
|
|
requesting the execution of some command). This option may be
|
|
specified multiple times, in which case no job requesting one of the
|
|
specified commands will be listed. This option may not be used with
|
|
.B \-c.
|
|
.TP 5
|
|
.B \-o hours
|
|
List all queued jobs older than the given number of hours.
|
|
.TP 5
|
|
.B \-y hours
|
|
List all queued jobs younger than the given number of hours.
|
|
.TP 5
|
|
.B \-k jobid
|
|
Kill the named job. The job id is shown by the default output format,
|
|
as well as by the
|
|
.B \-j
|
|
option to
|
|
.I uucp
|
|
(1) or
|
|
.I uux
|
|
(1). A job may only be killed by the user who created the job, or by
|
|
the UUCP administrator or the superuser. The
|
|
.B \-k
|
|
option may be used multiple times on the command line to kill several
|
|
jobs.
|
|
.TP 5
|
|
.B \-r jobid
|
|
Rejuvenate the named job. This will mark it as having been invoked at
|
|
the current time, affecting the output of the
|
|
.B \-o
|
|
or
|
|
.B \-y
|
|
options and preserving it from any automated cleanup daemon. The job
|
|
id is shown by the default output format, as well as by the
|
|
.B \-j
|
|
option to
|
|
.I uucp
|
|
(1) or
|
|
.I uux
|
|
(1). A job may only be rejuvenated by the user who created the job,
|
|
or by the UUCP administrator or the superuser. The
|
|
.B \-r
|
|
option may be used multiple times on the command line to rejuvenate
|
|
several jobs.
|
|
.TP 5
|
|
.B \-q
|
|
Display the status of commands, executions and conversations for all
|
|
remote systems for which commands or executions are queued.
|
|
.TP 5
|
|
.B \-m
|
|
Display the status of conversations for all remote systems.
|
|
.TP 5
|
|
.B \-p
|
|
Display the status of all processes holding UUCP locks on systems or
|
|
ports.
|
|
.TP 5
|
|
.B \-i
|
|
For each listed job, prompt whether to kill the job or not. If the
|
|
first character of the input line is
|
|
.I y
|
|
or
|
|
.I Y
|
|
the job will be killed.
|
|
.TP 5
|
|
.B \-K
|
|
Automatically kill each listed job. This can be useful for automatic
|
|
cleanup scripts, in conjunction with the
|
|
.B \-M
|
|
and
|
|
.B \-N
|
|
options.
|
|
.TP 5
|
|
.B \-M
|
|
For each listed job, send mail to the UUCP administrator. If the job
|
|
is killed (due to
|
|
.B \-K
|
|
or
|
|
.B \-i
|
|
with an affirmative response) the mail will indicate that. A comment
|
|
specified by the
|
|
.B \-W
|
|
option may be included. If the job is an execution, the initial
|
|
portion of its standard input will be included in the mail message;
|
|
the number of lines to include may be set with the
|
|
.B \-B
|
|
option (the default is 100). If the standard input contains null
|
|
characters, it is assumed to be a binary file and is not included.
|
|
.TP 5
|
|
.B \-N
|
|
For each listed job, send mail to the user who requested the job. The
|
|
mail is identical to that sent by the
|
|
.B \-M
|
|
option.
|
|
.TP 5
|
|
.B \-W
|
|
Specify a comment to be included in mail sent with the
|
|
.B \-M
|
|
or
|
|
.B \-N
|
|
options.
|
|
.TP 5
|
|
.B \-Q
|
|
Do not actually list the job, but only take any actions indicated by
|
|
the
|
|
.B \-i,
|
|
.B \-K,
|
|
.B \-M,
|
|
.B \-N
|
|
options.
|
|
.TP 5
|
|
.B \-x type
|
|
Turn on particular debugging types. The following types are
|
|
recognized: abnormal, chat, handshake, uucp-proto, proto, port,
|
|
config, spooldir, execute, incoming, outgoing. Only abnormal, config,
|
|
spooldir and execute are meaningful for
|
|
.I uustat.
|
|
|
|
Multiple types may be given, separated by commas, and the
|
|
.B \-x
|
|
option may appear multiple times. A number may also be given, which
|
|
will turn on that many types from the foregoing list; for example,
|
|
.B \-x 2
|
|
is equivalent to
|
|
.B \-x abnormal,chat.
|
|
.TP 5
|
|
.B \-I file
|
|
Set configuration file to use. This option may not be available,
|
|
depending upon how
|
|
.I uustat
|
|
was compiled.
|
|
.SH EXAMPLES
|
|
.EX
|
|
uustat -a
|
|
.EE
|
|
Display status of all jobs. A sample output line is as follows:
|
|
.EX
|
|
bugsA027h bugs ian 04-01 13:50 Executing rmail ian@airs.com (sending 1283 bytes)
|
|
.EE
|
|
The format is
|
|
.EX
|
|
jobid system user queue-date command (size)
|
|
.EE
|
|
The jobid may be passed to the
|
|
.B \-k
|
|
or
|
|
.B \-r
|
|
options.
|
|
The size indicates how much data is to be transferred to the remote
|
|
system, and is absent for a file receive request.
|
|
The
|
|
.B \-s,
|
|
.B \-S,
|
|
.B \-u,
|
|
.B \-U,
|
|
.B \-c,
|
|
.B \-C,
|
|
.B \-o,
|
|
and
|
|
.B \-y
|
|
options may be used to control which jobs are listed.
|
|
|
|
.EX
|
|
uustat -e
|
|
.EE
|
|
Display status of queued up execution requests. A sample output line
|
|
is as follows:
|
|
.EX
|
|
bugs bugs!ian 05-20 12:51 rmail ian
|
|
.EE
|
|
The format is
|
|
.EX
|
|
system requestor queue-date command
|
|
.EE
|
|
The
|
|
.B \-s,
|
|
.B \-S,
|
|
.B \-u,
|
|
.B \-U,
|
|
.B \-c,
|
|
.B \-C,
|
|
.B \-o,
|
|
and
|
|
.B \-y
|
|
options may be used to control which requests are listed.
|
|
|
|
.EX
|
|
uustat -q
|
|
.EE
|
|
Display status for all systems with queued up commands. A sample
|
|
output line is as follows:
|
|
.EX
|
|
bugs 4C (1 hour) 0X (0 secs) 04-01 14:45 Dial failed
|
|
.EE
|
|
This indicates the system, the number of queued commands, the age of
|
|
the oldest queued command, the number of queued local executions, the
|
|
age of the oldest queued execution, the date of the last conversation,
|
|
and the status of that conversation.
|
|
|
|
.EX
|
|
uustat -m
|
|
.EE
|
|
Display conversation status for all remote systems. A sample output
|
|
line is as follows:
|
|
.EX
|
|
bugs 04-01 15:51 Conversation complete
|
|
.EE
|
|
This indicates the system, the date of the last conversation, and the
|
|
status of that conversation. If the last conversation failed,
|
|
.I uustat
|
|
will indicate how many attempts have been made to call the system. If
|
|
the retry period is currently preventing calls to that system,
|
|
.I uustat
|
|
also displays the time when the next call will be permitted.
|
|
|
|
.EX
|
|
uustat -p
|
|
.EE
|
|
Display the status of all processes holding UUCP locks. The output
|
|
format is system dependent, as
|
|
.I uustat
|
|
simply invokes
|
|
.I ps
|
|
(1) on each process holding a lock.
|
|
|
|
.EX
|
|
uustat -c rmail -o 168 -K -Q -M -N -W"Queued for over 1 week"
|
|
.EE
|
|
This will kill all
|
|
.I rmail
|
|
commands that have been queued up waiting for delivery for over 1 week
|
|
(168 hours). For each such command, mail will be sent both to the
|
|
UUCP administrator and to the user who requested the rmail execution.
|
|
The mail message sent will include the string given by the
|
|
.B \-W
|
|
option. The
|
|
.B \-Q
|
|
option prevents any of the jobs from being listed on the terminal, so
|
|
any output from the program will be error messages.
|
|
.SH FILES
|
|
The file names may be changed at compilation time or by the
|
|
configuration file, so these are only approximations.
|
|
|
|
.br
|
|
/usr/lib/uucp/config - Configuration file.
|
|
.br
|
|
/usr/spool/uucp -
|
|
UUCP spool directory.
|
|
.SH SEE ALSO
|
|
ps(1), rmail(1), uucp(1), uux(1), uucico(8), uuxqt(8)
|
|
.SH AUTHOR
|
|
Ian Lance Taylor
|
|
(ian@airs.com or uunet!airs!ian)
|