lpstat(1) General Commands Manual lpstat(1)
NAME
lpstat - report status information of the LP subsystem
SYNOPSIS
[list]] [list]] [list]] [list]] [list]] [list]] [ID]... [dest]...
DESCRIPTION
The utility writes to standard output information about the current status of the LP subsystem.
If no arguments are given, writes the status of all requests made to by the user that are still in the output queue.
Options
The utility supports the XBD specification, Section 10.2, Utility Syntax Guidelines, except the option-arguments are optional and cannot be
presented as separate arguments.
Some of the options below can be followed by an optional list that can be in one of two forms: a list of items separated from one another
by a comma, or a quoted list of items separated from one another by a comma or one or more blank characters. See
The omission of a list following such options causes all information relevant to the option to be written to standard output; for example:
writes the status of all output requests that are still in the output queue.
Write the acceptance status of destinations for output requests.
The list argument is a list of intermixed printer names and class names.
Write the class names and their members. The
list argument is a list of class names.
Write the system default destination for output requests.
checks for the default destination in the environment variable If that variable is unset or empty, checks for the
default destination in the environment variable If that variable is unset or empty, checks for the default destination
in the default queue.
Inhibit the reporting of remote status.
Write the status of output requests. The
list argument is a list of intermixed printer names, class names and request IDs. Also see the option.
Write the status of printers. The
list argument is a list of printer names.
Write the status of the LP request scheduler.
Write a status summary, including the status
of the LP scheduler, the system default destination, the list of class names and their members and the list of printers
and their associated devices.
Write all status information.
Same as specifying See the option.
Write the status of output requests for users. The
list argument is a list of login names. The maximum number of login names allowed in a list is 50.
Write the names of printers and the pathnames of the devices
associated with them. The list argument is a list of printer names.
Operands and Arguments
Any arguments that are not options are assumed to be request ids (as returned by or LP destinations. prints the status of requests corre-
sponding to such request ids or the status of requests belonging to such destinations. options can appear in any order and can be repeated
and intermixed with other arguments.
The following operands are supported:
ID Write the status of output request for ID. ID is a request ID, as returned by
dest Write the status of output request for dest. dest is a printer name or class name.
Security Restriction
Only users who have the subsystem authorization or the secondary subsystem authorization can view the entire queue. Unauthorized users can
view only their own jobs whose sensitivity levels are dominated by the user's current sensitivity level.
The privilege allows viewing jobs at higher sensitivity levels.
EXTERNAL INFLUENCES
Environment Variables
The following environment variables affect the execution of
Provide a default value for the internationalisation variables that are unset or null. If is unset or null, the corresponding value
from the implementation-specific default locale will be used. If any of the internationalisation variables contains an invalid set-
ting, the utility will behave as if none of the variables had been defined.
If set to a non-empty string value, override
the values of all the other internationalisation variables.
Determine the locale for the interpretation
of sequences of bytes of text data as characters (for example, single- as opposed to multi-byte characters in arguments).
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.
Determine the format of date and time
strings output when displaying line printer status information with the or options.
Determine the location of message catalogues
for the processing of
Determine the timezone used with date and time strings.
Determine the output device or destination.
If the environment variable is not set, the environment variable is used.
Determine the output device or destination.
If the environment variable is not set, the default queue is used. environment variable takes precedence over
STDOUT
The standard output is a text file containing the information described in an unspecified format.
STDERR
Used only for diagnostic messages.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
APPLICATION USAGE
The utility cannot reliably determine the status of print requests in all conceivable circumstances. When the printer is under the control
of another operating system or resides on a remote system across a network, it need not be possible to determine the status of the print
job after it has left the control of the local operating system. Even on local printers, spooling hardware in the printer may make it
appear that the print job has been completed long before the final page is printed.
EXAMPLES
Check whether your job is queued:
Check the relative position of a queued job:
Verify that the job scheduler is running:
Obtain the status of two printers, the pathnames of two printers, a list of all class names and the status of the request named HiPri-33:
Obtain user print job status using the obsolescent mixed blank and comma form:
FILES
SEE ALSO
cancel(1), enable(1), lp(1), rlpstat(1M).
STANDARDS CONFORMANCE
lpstat(1)