lpstat(1)lpstat(1)NAMElpstat - Displays line printer status information
SYNOPSISlpstat [-a[list]] [-c[list]] [-d | -r | -s | -t] [-o[list]]
[-p[list]] [-u[list]] [-v[list]] [request_ID...]
The lpstat command displays information about the current status of the
line printer.
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
lpstat: XCU5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
OPTIONS
Specifies the display of acceptance status (with respect to the lp and
lpr commands) of destinations for requests. The list argument is a
list of intermixed printer names and request IDs. Write the class
names and their members. The list argument is a list of class names.
Specifies the display of the system default destination for the lp and
lpr commands. Specifies the display of the status of printer requests.
The list argument is a list of intermixed printer names and request
IDs. Note that when combined, the -o and -u options do not produce
merged output. Specifies the display of the status of printers. The
list argument is a list of printer names. Specifies the display of the
status of the line printer daemon. Specifies the display of a status
summary, including the status of the line printer scheduler, the system
default destination, and a list of printers and their associated
devices. Specifies the display of all status information. Specifies
the display of the status of all printer requests. The list argument
is a list of usernames. The list argument is a list of intermixed
printer names and request IDs. Note that when combined, the -o and -u
options do not produce merged output. Specifies the display of the
names of printers and the path names of the devices associated with
them. The list argument is a list of printer names.
OPERANDS
A request ID as returned by lp or lpr.
DESCRIPTION
If no options are given, then lpstat displays the status of all
requests made by the lp and lpr commands. Any arguments that are not
options are assumed to be a request_ID (as returned by the lp or lpr
commands). The lpstatcommand displays the status of such requests.
Options can appear in any order and can be repeated and intermixed with
other options. Some options can be followed by an optional list that
is either a list of items separated from one another by a , (comma), or
a list of items enclosed in " " (double quotes) and separated from one
another by a comma or one or more spaces. For example:
-u"user1, user2, user3"
Specifying just the option with no arguments causes all information
pertaining to that option to be displayed.
If the LPDEST environment variable is set to a valid printer name, this
becomes the default destination; otherwise, PRINTER is tried and, as a
last resort, a system-specific printer.
NOTES
The lpstat utility is marked LEGACY in XCU Issue 5.
[Tru64 UNIX] Output produced by the lpstat command is very similar to
output from lpq and lpc, rather than output from earlier versions of
lpstat.
EXIT STATUS
The following exit values are returned: Successful completion. An
error occurred.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of lpstat:
Provides a default value for the internationalization variables that
are unset or null. If LANG is unset or null, the corresponding value
from the default locale is used. If any of the internationalization
variables contain an invalid setting, the utility behaves as if none of
the variables had been defined. If set to a non-empty string value,
overrides the values of all the other internationalization variables.
Determines 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). Determines the locale for the format
and contents of diagnostic messages written to standard error. Deter‐
mines the location of message catalogues for the processing of LC_MES‐
SAGES. Determines the time zone used with date and time strings.
FILES
Printer description file. Spool directories. Minimum free space to
leave. Line printer devices. Socket for local requests. Daemon con‐
trol files. Data files specified in cf files. Temporary copies of cf
files. Lock file used to obtain the process ID of the current daemon
and the request ID of the currently active request.
SEE ALSO
Commands: lp(1), lpc(8), lpd(8), lpq(1), lpr(1), lprm(1)
Files: printcap(4)
Standards: standards(5)lpstat(1)