uustat -- Command

UUCP status inquiry and control
uustat [-eKiMNQ] [-B lines] [-cC command] [-o hours] [-sS system]      [-uU
user] [-y hours]
uustat -a
uustat [-k jobid] [-r jobid]
uustat -m
uustat -p
uustat -q

The command uustat displays  status information about the UUCP system.  You
can also use it to cancel  or rejuvinate requests made by via commands uucp
or uux.

By default, uustat  displays every job queued by the  user who invokes this
command.  If the command line includes any of the options -a, -e, -s, -S, -
u, -U, -c, -C, -o, or -y, then uustat displays information about all of the
jobs that match given specifications.

The option  -K can be  used to kill a  selected group of jobs,  such as all
jobs more than seven days old.

Command-line Options

uustat recognizes the following command-line options:

-a   List all queued requests to transfer files.

-C command
     List all  jobs except those that request the  execution of command. If
     command is ALL, list all jobs  that simply request a file transfer (as
     opposed to requesting the  execution of some command).  You cannot use
     this option  with the option -c.  A uustat command can  hold more than
     one -C option.

-c command
     List every  job that requests the execution of  command. If command is
     ALL, uustat lists all jobs that request the execution of a command (as
     opposed to  simply requesting a file transfer).   A uustat command can
     hold more than one -c option.

-e   List queued  requests to execute a program on  a remote system, rather
     than queued requests to transfer files.  Queued execution requests are
     processed by uuxqt rather  than uucico. A queued execution request may
     await a file  from a remote system.  These requests  are created by an
     invocation of the command uux.

-I file
     Read configuration  information from file instead  of from the default
     file /usr/lib/uucp/sys.

-i   For each  listed job, prompt  whether to kill  the job.  If  the first
     character of the input line is y or Y, the job will be killed.

-K   Kill each  listed job without  prompting for permission.   This can be
     used in a script to clean up obsolete jobs automatically.

-k jobid
     Kill the job with the identifier jobid. A job's identifier is shown by
     the default output format, as well as by the commands uucp or uux when
     invoked with option -j. A job  may only be killed only by the user who
     created the  job, the UUCP  administrator, or the  superuser root. You
     can use the option -k more than once on a uustat command line, to kill
     several jobs simultaneously.

-M   For each listed job, send mail  to the UUCP administrator.  If the job
     is killed  (due to -K  or -i with  an affirmative response),  the mail
     will  indicate that.   A comment  specified  by the  -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  option (the default is 100).
     If the standard input contains null  characters, it is assumed to be a
     binary file and is not included.

-m   Display the status of conversations for all remote systems.

-N   For each listed job, send mail to the user who requested the job.  The
     mail is identical to that sent by the option -M.

-o hours
     List all jobs that have been queued longer than hours.

-p   Display the  status of all processes holding UUCP  locks on systems or
     ports.

-Q   Work quietly: Do not list  the job, just perform the actions indicated
     by the options -i, -K, -M, or -N.

-q   Display the status  of commands, executions, and conversations for all
     remote systems for which commands or executions are queued.

-r jobid
     Rejuvinate the  job with job  identifier jobid. This marks  the job as
     having been  invoked at the current time; which,  in turn, affects the
     output  of  the options  -o  or  -y and  preserves  the  job from  any
     automated cleanup daemon.  The  job identifier is shown by the default
     output format,  as well as by  the commands uucp and  uux when invoked
     with option -j. A job may  only be rejuvenated by the user who created
     the job, by the UUCP administrator, or the superuser root. You can use
     the option -r  more than once on a uustat  command line, to rejuvinate
     several jobs simultaneously.

-S system
     List all jobs  except the ones queued for system.  You cannot use this
     option with the option -s. A  uustat command can hold more than one -S
     option.

-s system
     List every job queued for system.  A uustat command can hold more than
     one -s option.

-U user
     List all  jobs except the  ones queued for  user. You cannot  use this
     option with the option -u. A  uustat command can hold more than one -U
     option.

-u user
     List every  job queued for user.  A uustat command can  hold more than
     one -u option.

-W   Specify  a comment  to be  included  in mail  sent with  the -M  or -N
     options.

-x type
     Turn  on   particular  debugging  types.   The   following  types  are
     recognized:

          abnormal       chat           config
          execute        handshake      incoming
          outgoing       port           proto
          spooldir       uucp-proto

     Only  abnormal,  config,  spooldir,  and  execute are  meaningful  for
     uustat.

     Multiple types  may be given,  separated by commas, and  the -x option
     can appear  multiple times on  the uustat command line.   A number may
     also be given,  which will turn on that many  types from the foregoing
     list; for example, -x 2 is equivalent to -x abnormal,chat.

-y hours
     List all jobs that have been queued less than hours.

Examples

The first example displays the status of all jobs:

    uustat -a

The output has the format:

    jobid system user queue-date command (size)

The  job  identifier may  be  passed to  the  options -k  or  -r. The  size
indicates how much  data is to be transferred to  the remote system, and is
absent for a file-receive request.  The options -s, -S, -u, -U, -c, -C, -o,
and -y may be used to control which jobs are listed.

The next example displays the status of queued execution requests:

    uustat -e

The output has the format:

    system requestor queue-date command

The options -s, -S, -u, -U, -c, -C, -o, and -y can be used to control which
requests are listed.

The next example displays the status for all systems with queued commands:

    uustat -q

This displays the system, the number  of commands queued for it, 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.

The next example displays conversation status for all remote systems:

    uustat -m

The output  gives the system,  the date of  the last conversation,  and the
status  of that  conversation.   If the  last  conversation failed,  uustat
indicates how  many attempts  have been  made to call  the system.   If the
retry period  is preventing calls to that system,  uustat also displays the
time when the next call will be permitted.

The next example displays the status of all processes that hold UUCP locks:

    uustat -p

The output is  exactly the same as that of  the command ps for each process
that holds a lock.

The next example kills all rmail  commands that have been queued up waiting
for delivery for over one week (168 hours).

    uustat -c rmail -o 168 -K -Q -M -N -W"Queued for over 1 week"

uustat  sends mail  both to  the  UUCP administrator  and to  the user  who
requested the rmail execution.   The mail message includes the string given
by the -W option.  The option -Q prevents any of the jobs from being listed
on the terminal, so any output from the program will be error messages.

Files

/usr/lib/uucp/config -- Configuration file.
/usr/spool/uucp -- UUCP spool directory.

See Also

commands,
ps,
rmail,
uucico,
UUCP,
uucp,
uux,
uuxqt

Notes

uustat was written by Ian Lance Taylor (ian@airs.com).

© 2012 by Stephen A. Ness