1 files changed, 380 insertions, 0 deletions
diff --git a/gnu/libexec/uucp/uustat/uustat.1 b/gnu/libexec/uucp/uustat/uustat.1
new file mode 100644
index 000000000000..5d0ed2a08bbc
--- /dev/null
+++ b/gnu/libexec/uucp/uustat/uustat.1
@@ -0,0 +1,380 @@
+''' $Id: uustat.1,v 1.1 1993/08/05 18:28:04 conklin 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)