lpstat(1)lpstat(1)NAMElpstat - 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 Syn‐
tax 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 environ‐
ment variable If that variable is unset or empty,
checks for the default destination in the environ‐
ment 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 sub‐
system 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 setting, the utility will behave as if none of the vari‐
ables had been defined.
If set to a non-empty string value, override
the values of all the other internationalisation vari‐
ables.
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 writ‐
ten to standard output.
Determine the format of date and time
strings output when displaying line printer status infor‐
mation 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 net‐
work, 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:
FILESSEE ALSOcancel(1), enable(1), lp(1), rlpstat(1M).
STANDARDS CONFORMANCElpstat(1)