# uustat

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           uustat — uucp status enquiry and job control
    


## SYNOPSIS



           uustat **[** -q|-k _jobid_ |-r _jobid_**]**
    
           uustat **[** -s _system_**] [** -u _user_**]**
    


## DESCRIPTION



           The _uustat_ utility shall display the status of, or cancel,
           previously specified _uucp_ requests, or provide general status on
           _uucp_ connections to other systems.
    
           When no options are given, _uustat_ shall write to standard output
           the status of all _uucp_ requests issued by the current user.
    
           Typical implementations of this utility require a communications
           line configured to use the Base Definitions volume of
           POSIX.1‐2017, _Chapter 11_ , _General Terminal Interface_ , but other
           communications means may be used. On systems where there are no
           available communications means (either temporarily or
           permanently), this utility shall write an error message describing
           the problem and exit with a non-zero exit status.
    


## OPTIONS



           The _uustat_ utility shall conform to the Base Definitions volume of
           POSIX.1‐2017, _Section 12.2_ , _Utility Syntax Guidelines_.
    
           The following options shall be supported:
    
           **-q** Write the jobs queued for each machine.
    
           **-k** _jobid_  Kill the _uucp_ request whose job identification is _jobid_.
                     The application shall ensure that the killed _uucp_
                     request belongs to the person invoking _uustat_ unless
                     that user has appropriate privileges.
    
           **-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 program from
                     deleting the job until the jobs modification time
                     reaches the limit imposed by the program.
    
           **-s** _system_ Write the status of all _uucp_ requests for remote system
                     _system_.
    
           **-u** _user_   Write the status of all _uucp_ requests issued by _user_.
    


## OPERANDS



           None.
    


## STDIN



           Not used.
    


## INPUT FILES



           None.
    


## ENVIRONMENT VARIABLES



           The following environment variables shall affect the execution of
           _uustat_ :
    
           _LANG_      Provide a default value for the internationalization
                     variables that are unset or null. (See the Base
                     Definitions volume of POSIX.1‐2017, _Section 8.2_ ,
                     _Internationalization Variables_ for the precedence of
                     internationalization variables used to determine the
                     values of locale categories.)
    
           _LC_ALL_    If set to a non-empty string value, override the values
                     of all the other internationalization variables.
    
           _LC_CTYPE_  Determine the locale for the interpretation of sequences
                     of bytes of text data as characters (for example,
                     single-byte as opposed to multi-byte characters in
                     arguments).
    
           _LC_MESSAGES_
                     Determine the locale that should be used to affect the
                     format and contents of diagnostic messages written to
                     standard error, and informative messages written to
                     standard output.
    
           _NLSPATH_   Determine the location of message catalogs for the
                     processing of _LC_MESSAGES_.
    


## ASYNCHRONOUS EVENTS



           Default.
    


## STDOUT



           The standard output shall consist of information about each job
           selected, in an unspecified format. The information shall include
           at least the job ID, the user ID or name, and the remote system
           name.
    


## STDERR



           The standard error shall be used only for diagnostic messages.
    


## OUTPUT FILES



           None.
    


## EXTENDED DESCRIPTION



           None.
    


## EXIT STATUS



           The following exit values shall be returned:
    
            0    Successful completion.
    
           >0    An error occurred.
    


## CONSEQUENCES OF ERRORS



           Default.
    
           _The following sections are informative._
    


## APPLICATION USAGE



           This utility is part of the UUCP Utilities option and need not be
           supported by all implementations.
    


## EXAMPLES



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *