Sun Microsystems, Inc. gratefully acknowledges The Open Group for
permission to reproduce portions of its copyrighted documentation.
Original documentation from The Open Group can be obtained online at
http://www.opengroup.org/bookstore/.
The Institute of Electrical and Electronics Engineers and The Open
Group, have given us permission to reprint portions of their
documentation.
In the following statement, the phrase ``this text'' refers to portions
of the system documentation.
Portions of this text are reprinted and reproduced in electronic form
in the SunOS Reference Manual, from IEEE Std 1003.1, 2004 Edition,
Standard for Information Technology -- Portable Operating System
Interface (POSIX), The Open Group Base Specifications Issue 6,
Copyright (C) 2001-2004 by the Institute of Electrical and Electronics
Engineers, Inc and The Open Group. In the event of any discrepancy
between these versions and the original IEEE and The Open Group
Standard, the original IEEE and The Open Group Standard is the referee
document. The original Standard can be obtained online at
http://www.opengroup.org/unix/online.html.
This notice shall appear on any product containing this material.
The contents of this file are subject to the terms of the
Common Development and Distribution License (the "License").
You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions
and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each
file and include the License file at usr/src/OPENSOLARIS.LICENSE.
If applicable, add the following below this CDDL HEADER, with the
fields enclosed by brackets "[]" replaced with your own identifying
information: Portions Copyright [yyyy] [name of copyright owner]
Copyright 1989 AT&T
Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved.
Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved.
uustat [ [-m] | [-p] | [-q] | [-k jobid [-n]] | [-r jobid [-n]]]
uustat [-a] [-s system [-j]] [-u user] [-S qric]
uustat -t system [-c] [-d number]
The uustat utility functions in the following three areas:
1. Displays the general status of, or cancels, previously specified uucp commands.
2. Provides remote system performance information, in terms of average transfer rates or average queue times.
3. Provides general remote system-specific and user-specific status of uucp connections to other systems.
The following options are supported:
These options obtain general status of, or cancel, previously specified uucp commands: -a
Lists all jobs in queue.
Lists the total number of jobs displayed. The -j option can be used in conjunction with the -a or the -s option.
Kills the uucp request whose job identification is jobid. The killed uucp request must belong to the user issuing the uustat command unless the user is the super-user or uucp administrator. If the job is killed by the super-user or uucp administrator, electronic mail is sent to the user.
Reports the status of accessibility of all machines.
Suppresses all standard output, but not standard error. The -n option is used in conjunction with the -k and -r options.
Executes the command ps -flp for all the process-ids that are in the lock files.
Lists 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 parentheses next to the number of C or X files, it is the age in days of the oldest C./X. file for that system. The Retry field represents the number of hours until the next possible call. The Count is the number of failure attempts. Note: For systems with a moderate number of outstanding jobs, this could take 30 seconds or more of real-time to execute. An example of the output produced by the -q option is:
eagle 3C 04/07-11:07 NO DEVICES AVAILABLE mh3bs3 2C 07/07-10:42 SUCCESSFULThis indicates the number of command files that are waiting for each system. Each command file may have zero or more files to be sent (zero means to call the system and see if work is to be done). The date and time refer to the previous interaction with the system followed by the status of the interaction.
Rejuvenates 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 daemon.
These options provide remote system performance information, in terms of average transfer rates or average queue times. The -c and -d options can only be used in conjunction with the -t option: -tsystem
Reports the average transfer rate or average queue time for the past 60 minutes for the remote system. The following parameters can only be used with this option:
Average queue time is calculated when the -c parameter is specified and average transfer rate when -c is not specified. For example, the command:
example% uustat -teagle -d50 -c
produces output in the following format:
average queue time to eagle for last 50 minutes: 5 secondsThe same command without the -c parameter produces output in the following format:
average transfer rate with eagle for last 50 minutes: 2000.88 bytes/sec
number is specified in minutes. Used to override the 60 minute default used for calculations. These calculations are based on information contained in the optional performance log and therefore may not be available. Calculations can only be made from the time that the performance log was last cleaned up.
These options provide general remote system-specific and user-specific status of uucp connections to other systems. Either or both of the following options can be specified with uustat. The -j option can be used in conjunction with the -s option to list the total number of jobs displayed: -ssystem
Reports the status of all uucp requests for remote system system.
Reports the status of all uucp requests issued by user.
Output for both the -s and -u options has the following format:
eagleN1bd7 4/07-11:07 S eagle dan 522 /home/dan/A eagleC1bd8 4/07-11:07 S eagle dan 59 D.3b2al2ce4924 4/07-11:07 S eagle dan rmail mike
With the above two options, the first field is the jobid of the job. This is followed by the date/time. The next field is an S if the job is sending a file or an R if the job is requesting a file. The next field is the machine where the file is to be transferred. 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 (rmail is the command used for remote mail), the name of the command. 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 (for example, D.3b2alce4924) that is created for data files associated with remote executions (rmail in this example). -Sqric
Reports the job state: q
for queued jobs
for running jobs
for interrupted jobs
for completed jobs
eagleC1bd3 completed
When no options are given, uustat writes to standard output the status of all uucp requests issued by the current user.
See environ(7) for descriptions of the following environment variables that affect the execution of uustat: LANG, LC_ALL, LC_COLLATELC_CTYPE, LC_MESSAGES, LC_TIME, NLSPATH, and TZ.
The following exit values are returned: 0
Successful completion.
An error occurred.
spool directories
accounting log
performance log
See attributes(7) for descriptions of the following attributes:
| ATTRIBUTE TYPE ATTRIBUTE VALUE |
| Interface Stability Standard |
uucp (1C), attributes (7), environ (7), standards (7)
The -t option produces no message when the data needed for the calculations is not being recorded.
After the user has issued the uucp request, if the file to be transferred is moved, deleted or was not copied to the spool directory (-C option) when the uucp request was made, uustat reports a file size of -99999. This job will eventually fail because the file(s) to be transferred can not be found.