HP-UX Reference (11i v3 07/02) - 1 User Commands A-M (vol 1)

l
lpstat(1) lpstat(1)
NAME
lpstat - report status information of the LP subsystem
SYNOPSIS
lpstat [-drst][-a
[list]] [-c[list]] [-o[list]] [-p
[list]] [-u[list]] [-v[list]] [
-i][ID]... [dest]...
DESCRIPTION
The
lpstat utility writes to standard output information about the current status of the LP subsystem.
If no arguments are given, lpstat writes the status of all requests made to
lp by the user that are still
in the output queue.
Options
The
lpstat 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 EXAMPLES.
The omission of a list following such options causes all information relevant to the option to be written to
standard output; for example:
lpstat -o
writes the status of all output requests that are still in the output queue.
-a[list] Write the acceptance status of destinations for output requests. The list argument is a
list of intermixed printer names and class names.
-c[list] Write the class names and their members. The list argument is a list of class names.
-d Write the system default destination for output requests. lpstat checks for the default
destination in the environment variable
LPDEST. If that variable is unset or empty,
lpstat checks for the default destination in the environment variable PRINTER.If
that variable is unset or empty, lpstat checks for the default destination in the default
queue.
-i Inhibit the reporting of remote status.
-o[list] Write the status of output requests. The list argument is a list of intermixed printer
names, class names and request IDs. Also see the
-i option.
-p[list] Write the status of printers. The list argument is a list of printer names.
-r Write the status of the LP request scheduler.
-s 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.
-t Write all status information. Same as specifying -r,
-s, -a, -p, -o. See the -i
option.
-u[list] 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.
-v[list] 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 lp) or LP destinations.
lpstat prints the status of requests corresponding 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 argu-
ments.
The following operands are supported:
ID Write the status of output request for ID. ID is a request ID, as returned by lp.
dest Write the status of output request for dest. dest is a printer name or class name.
HP-UX 11i Version 3: February 2007 1 Hewlett-Packard Company 603