lpstat(1) User Commands lpstat(1)
NAME
lpstat - print information about the status of the print service
SYNOPSIS
lpstat [-d] [-r] [-R] [-s] [-t] [ -a [list]] [ -c [list]] [ -f [list] [-l]] [ -o [list]] [ -p [list] [-D] [-l]] [ -S [list] [-l]] [ -u [
login- ID -list]] [ -v [list]]
DESCRIPTION
The lpstat utility displays information about the current status of the LP print service to standard output.
If no options are given, lpstat prints the status of all the user's print requests made by lp. See lp(1). Any arguments that are not
options are assumed to be request-IDs as returned by lp. The lpstat command prints the status of such requests. options may appear in any
order and may be repeated and intermixed with other arguments. Some key letters may 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 list of items separated from one another by spaces enclosed in
quotes. For example:
example% lpstat -u "user1 user2 user3"
Specifying all after any key letter that takes list as an argument causes all information relevant to the key letter to be printed. For
example, the command:
example% lpstat -o all
prints the status of all output requests.
The omission of a list following such key letters causes all information relevant to the key letter to be printed. For example, the com-
mand:
example% lpstat -o
prints the status of all output requests.
The print client commands locate destination information using the "printers" database in the name service switch. See nsswitch.conf(4),
printers(4), and printers.conf(4) for details.
OPTIONS
The following options are supported on all platforms.
-d Prints the default destination for output requests.
-o [list] Prints the status of output requests. list is a list of intermixed printer names, class names, and request-IDs. The
key letter -o may be omitted. Specify printer and class names using atomic or POSIX-style (server:destination)
names. See standards(5) for information regarding POSIX.
-r Prints the status of the LP request scheduler.
-R Prints a number showing the position of each request in the print queue.
-s Prints a status summary, including the status of the LP scheduler, the default destination, a list of printers and
their associated devices, a list of the machines sharing print services, a list of all forms currently mounted, and
a list of all recognized character sets and print wheels.
-t Prints all status information. This includes all the information obtained with the -s option, plus the acceptance
and idle/busy status of all printers.
-u [login-ID-list] Prints the status of output requests for users. The login-ID-list argument may include any or all of the following
constructs:
login-ID
a user on any system
system_name!login-ID
a user on system system_name
system_name!all
all users on system system_name
all!login-ID
a user on all systems
all
all users on all systems
-v [list] Prints the names of printers and the path names of the devices associated with them or remote system names for net-
work printers. list is a list of printer names.
The following options return accurate results only if they are issued from a Solaris 2.6 Operating Environment or compatible version of the
LP print server.
-a [list] Reports whether print destinations are accepting requests. list is a list of intermixed printer names and class
names.
-c [list] Prints name of all classes and their members. list is a list of class names.
-f [list] [-l] Prints a verification that the forms in list are recognized by the LP print service. list is a list of forms; the
default is all. The -l option will list the form descriptions.
-p [list] [-D] [-l] Prints the status of printers. list is a list of printer names. If the -D option is given, a brief description is
printed for each printer in list. If the -l option is given and the printer is on the local machine, a full
description of each printer's configuration is returned, including the form mounted, the acceptable content and
printer types, a printer description, and the interface used.
-S [list] [-l] Prints a verification that the character sets or the print wheels specified in list are recognized by the LP print
service. Items in list can be character sets or print wheels; the default for the list is all. If the -l option is
given, each line is appended by a list of printers that can handle the print wheel or character set. The list also
shows whether the print wheel or character set is mounted, or specifies the built-in character set into which it
maps.
-d Prints the default destination for output requests.
-o [list] Prints the status of output requests. list is a list of intermixed printer names, class names, and request-IDs. The
key letter -o may be omitted.
-r Prints the status of the LP request scheduler.
-R Prints a number showing the position of each request in the print queue.
-s Prints a status summary, including the status of the LP scheduler, the default destination, a list of printers and
their associated devices, a list of the machines sharing print services, a list of all forms currently mounted, and
a list of all recognized character sets and print wheels.
-t Prints all status information. This includes all the information obtained with the -s option, plus the acceptance
and idle/busy status of all printers.
-u [login-ID-list] Prints the status of output requests for users. The login-ID-list argument may include any or all of the following
constructs:
login-ID
a user on any system
system_name!login-ID
a user on system system_name
system_name!all
all users on system system_name
all!login-ID
a user on all systems
all
all users on all systems
-v [list] Prints the names of printers and the path names of the devices associated with them or remote system names for net-
work printers. list is a list of printer names.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
non-zero An error occurred.
FILES
/var/spool/print/* LP print queue.
$HOME/.printers User-configurable printer database.
/etc/printers.conf System configuration database.
printers.conf.byname NIS version of /etc/printers.conf.
printers.org_dir NIS+ version of /etc/printers.conf.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWpcu |
+-----------------------------+-----------------------------+
SEE ALSO
cancel(1), lp(1), lpq(1B), lpr(1B), lprm(1B), nsswitch.conf(4), printers( 4), printers.conf(4), attributes(5), standards(5)
SunOS 5.10 23 May 2003 lpstat(1)