COHERENT manpages
This page displays the COHERENT manpage for uustat [UUCP status inquiry and control].
List of available manpages
Index
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).