uustat(C)

uustat -- uucp status inquiry and job control

Syntax

uustat [ -a | -k jobid | -m | -p | -q | -r jobid ]

uustat [ -s system ] [ -u user ]

Description

uustat displays the status of, or cancels, previously specified uucp commands, or provides general status on UUCP connections to other systems.

When no options are given, uustat outputs the status of all uucp requests issued by the current user.

uustat accepts the following options:

-a

Output all jobs in queue.

-m

Report the status of accessibility of all machines.

-p

Execute ps -flp for all the process ID's that are in the lock files.

-q

List the jobs queued for each machine if a status file for it exists. The output has the following fields:

The system name on which jobs may be queued.
The number of C or X files waiting for the system. If the number is zero, the system is to be called to request jobs from it. A additional number in parentheses indicates the age in days of the oldest C. or X. file for that system.
The date and time that the system was last called.
The status of the remote system on last being called.
The number of hours until the next possible retry call.
A count of the number of failure attempts.

Following is an example of output produced by the -q option:

   eagle     3C     04/07-11:07     NO DEVICES AVAILABLE
   mh3bs3    2C     07/07-10:42     SUCCESSFUL

-k jobid

Kill the uucp request whose job identification is jobid. The killed uucp request must belong to the person issuing the uustat command unless they are the ``root'' user.

-r jobid

Rejuvenate jobid. The files associated with jobid are touched so that their modification time is set to the current time. This prevents the cleanup daemon from deleting the job until the job's modification time reaches the limit imposed by the daemon.

-s system

Report the status of all uucp requests for a remote system. (May be combined with the -u option.)

-u user

Report the status of all uucp requests issued by user. (May be combined with the -s option.)

For options -s and -u, the output fields are:

The jobid of the job.
The date and time.
S or R depending on whether the job is to send or request a file.
The system on which the job is to be run.
The user who queued the job.
The size of the file, or in the case of a remote execution the name of the command (in the example, the remote mail command rmail). When the size appears in this field, the filename is also given. This can either be the name given by the user or an internal name (for example, D.3b2alce4924) that is created for data files associated with remote executions (rmail in this example).

Following is an example of output from either the -s or -u option:

   eaglen0000 4/07-11:01:03 (POLL)
   eagleN1bd7 4/07-11:07    S      eagle dan 522 /usr/dan/A
   eagleC1bd8 4/07-11:07    S      eagle dan 59 D.3b2al2ce4924
              4/07-11:07    S      eagle dan rmail mike

Limitations

The -q option can take more than 30 seconds to execute on systems with a moderate number of outstanding jobs.

Files

/usr/spool/uucp/: spool directories

Standards conformance

uustat is conformant with: