NAME
uustat — uucp status inquiry and job control
SYNOPSIS
uustat -a
uustat -m
uustat -p
uustat -q
uustat -k
jobid]
uustat -r
jobid]
uustat
[-s
sys]
[-u
user]
DESCRIPTION
uustat
displays the status of, or cancels, previously specified
uucp
commands, or provide general status on
uucp
connections to other systems (see
uucp(1)).
Only one of the following options can be specified with
uustat
per command execution:
- -a
Output all jobs in queue.
- -m
Report the status of accessibility of all machines.
- -p
Execute a
ps -flp
for all the process
IDs that are in the lock files.
- -q
List the jobs queued for each machine.
If a status file exists for the machine,
its date, time and status information are reported.
In addition, if a number appears in
()
next to the number of
C
or
X
files it is the age in days of the oldest
C.
or
X.
file for that system.
The Retry field is the number of hours until the next possible call.
The Count field is the number of failure attempts.
Note that for systems with a moderate number of outstanding jobs,
this could take 30 seconds or more of real time to execute.
As an example of the output produced by
uustat -q :
eagle 3C 04/07-11:07 NO DEVICES AVAILABLE
mh3bs3 2C 07/07-10:42 SUCCESSFUL
The above output tells how many command files are waiting for each system.
Each command file can have zero or more files to be sent
(a command file with no files to be sent causes the
uucp
system to call the remote system and see if work is waiting).
The date and time refer to the previous interaction with the system
followed by the status of interaction.
- -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 the command is executed by the super-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 jobs modification time reaches the limit
imposed by the cleanup daemon.
The following options can be used singly or together
but cannot be used with the options listed above:
- -s sys
Report the status of all
uucp
requests for remote system
sys.
- -u user
Report the status of all
uucp
requests issued by
user.
Output for both the
-s
and
-u
options has the following format:
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.3b2a12cd4924
4/07-11:07 S eagle dan rmail mike
With the
-s
and
-u
options, the first field is the
jobid
of the job.
This is followed by the date and time.
The next field is either an
S
or
R,
depending on whether the job is to send or request a file.
The next field is the destination system name.
This is followed by the user
ID
of the user who queued the job.
The next field contains the size of the file,
or in the case of a remote execution the name of the command
(such as
rmail
which is the command used for remote mail).
When the size appears in this field, the file name is also given.
This can either be the name given by the user
or an internal name (such as
D.3b2alce4924)
that is created for data files associated with remote execution
(rmail
in this example).
When no options are given,
uustat
outputs the status of all
uucp
requests issued by the current user.
The format used is the same as with the
-s
or
-u
options.
EXTERNAL INFLUENCES
Environment Variables
LC_TIME
determines the format and contents of date and time strings.
LANG
determines the language in which messages are displayed.
If
LC_TIME
is not specified in the environment or is set to the empty string,
the value of
LANG
is used as a default for each unspecified or empty variable.
If
LANG
is not specified or is set to the empty string, a default of "C" (see
lang(5))
is used instead of
LANG.
If any internationalization variable contains an invalid setting,
uustat
behaves as if all internationalization variables are set to "C".
See
environ(5).
FILES
- /var/spool/uucp/*
spool directories
SEE ALSO
uucp(1).
- Tim O'Reilly and Grace Todino,
Managing UUCP and Usenet,
O'Reilly & Associates, Inc. USA.
- Grace Todino and Dale Dougherty,
Using UUCP and Usenet,
O'Reilly & Associates, Inc. USA.
STANDARDS CONFORMANCE
uustat: SVID2, SVID3, XPG2, XPG3, XPG4
Printable version
