lpstat - Displays line printer status information
lpstat [-a[list]] [-c[list]] [-d | -r | -s | -t]
[-o[list]] [-p[list]] [-u[list]] [-v[list]]
The lpstat command displays information about the current
status of the line printer.
Interfaces documented on this reference page conform to
industry standards as follows:
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
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.
A request ID as returned by lp or lpr.
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 systemspecific
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.
The following exit values are returned: Successful completion.
An error occurred.
ENVIRONMENT VARIABLES [Toc] [Back]
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 multibyte
characters in arguments). Determines the locale for the
format and contents of diagnostic messages written to
standard error. Determines the location of message catalogues
for the processing of LC_MESSAGES. Determines the
time zone used with date and time strings.
Printer description file. Spool directories. Minimum
free space to leave. Line printer devices. Socket for
local requests. Daemon control 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.
Commands: lp(1), lpc(8), lpd(8), lpq(1), lpr(1), lprm(1)
[ Back ]