User Commands lpstat(1)
NAME
lpstat - print information about the status of the print
serviceSYNOPSIS
lpstat [-d] [-r] [-R] [-s] [-t] [-a [list]] [-c [list]]
[-f [list]] [-o [list]] [-p [list] [-D]] [-S [list]]
[-u [login- ID -list]] [-v [list]] [-l level]
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 argumentsthat are not options are assumed to be request-IDs as
returned by lp. The lpstat command prints the status of such
requests. options appears in any order and can be repeated and intermixed with other arguments. Some key letters 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 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 command:example% lpstat -o
SunOS 5.11 Last change: 10 Dec 2009 1
User Commands lpstat(1)
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:-a [list] Reports whether print destinations are
accepting requests. list is a list of intermixed printer names and class names. If the print queue is remote and IPP is in use, the information provided is very close to that reported for local queues. If the print queue is remote and IPP is not in use (the print server is older than Solaris 9, Update6 or another RFC-1179-based print ser-
vice), this option does not report any useful information.-c [list] Prints name of all classes and their
members. list is a list of class names. If the print queue is remote and IPP is in use, the information provided is very close to that reported for local queues. If the print queue is remote and IPP is not in use (the print server is older than Solaris 9, Update6 or another RFC-1179-based print ser-
vice), this option does not report any useful information.-d Prints the default destination for
output requests.-f[list] [-l] Prints a verification that the forms
in list are recognized by the LP print service. list is a list of forms; thedefault is all. The -l option lists
the form descriptions.SunOS 5.11 Last change: 10 Dec 2009 2
User Commands lpstat(1)
If the print queue is remote and IPP is in use, the information provided is very close to that reported for local queues. If the print queue is remote and IPP is not in use (the print server is older than Solaris 9, Update6 or another RFC-1179-based print ser-
vice), this option does not report any useful information.-l [level] Specifies the verbosity level for
extended reporting of printer or jobobjects (-o, -p, -r, -u). Without this
option, a level of 0 is used, which reports summary information. When no level is specified, a level of 1is used, which provides more information about the object. A level of 2 or moreenumerates all of the object's attri-
butes. If the print queue is remote and IPP is in use, the information provided is very close to that reported for local queues. If the print queue is remote and IPP is not in use (the print server is older than Solaris 9, Update6 or another RFC-1179-based print ser-
vice), this option does not report any useful information.-o [list] Prints the status of output requests.
list is a list of intermixed printernames, class names, and request-IDs.
The key letter -o can be omitted.
Specify printer and class names usingatomic, URI-style (scheme://endpoint),
or POSIX-style (server:destination)
names. See printers.conf(4) for more information.-p [list] [-D] 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'sSunOS 5.11 Last change: 10 Dec 2009 3
User Commands lpstat(1)
configuration is returned, includingthe form mounted, the acceptable con-
tent and printer types, a printer description, and the interface used. If the print queue is remote and IPP is in use, correct job id is reported. If the print queue is remote and IPP is not in use (the print server is older than Solaris 9, Update 6 oranother RFC-1179-based print service),
-p [list] always reports the first job
in the queue irrespective of its status.-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.-S [list] Prints a verification that the charac-
ter sets or the print wheels specified in list are recognized by the LP printservice. Items in list can be charac-
ter sets or print wheels; the defaultfor 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 specifiesthe built-in character set into which
it maps. If the print queue is remote and IPP is in use, the information provided is very close to that reported for localSunOS 5.11 Last change: 10 Dec 2009 4
User Commands lpstat(1)
queues. If the print queue is remote and IPP is not in use (the print server is older than Solaris 9, Update6 or another RFC-1179-based print ser-
vice), this option does not report any useful information.-t Prints all status information. This
includes all the information obtainedwith the -s option, plus the accep-
tance and idle/busy status of all printers.-u [login-ID-list] Prints the status of output requests
for users. The login-ID-list argument
can include any or all of the follow-
ing constructs:login-ID a user on any
systemsystem_name!login-ID a user on sys-
temsystem_name
system_name!all all users on
systemsystem_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 network printers. list is a list of printer names. EXIT STATUSSunOS 5.11 Last change: 10 Dec 2009 5
User Commands lpstat(1)
The following exit values are returned: 0 Successful completion.non-zero An error occurred.
FILES/etc/printers.conf System printer configuration data-
base$HOME/.printers User-configurable printer database
ou=printers LDAP version of /etc/printers.conf printers.conf.byname NIS version of /etc/printers.confATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWlp-cmds |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| Standard | See standards(5). ||_____________________________|_____________________________|
SEE ALSO
cancel(1), lp(1), lpq(1B), lpr(1B), lprm(1B),nsswitch.conf(4), printers(4), printers.conf(4), attri-
butes(5), standards(5) NOTES For remote print queues, the BSD print protocol provides a very limited set of information. The Internet Print Protocol (IPP) is preferred. When IPP is in use, the user is prompted for a passphrase if the remote print service is configured to requireSunOS 5.11 Last change: 10 Dec 2009 6
User Commands lpstat(1)
authentication.SunOS 5.11 Last change: 10 Dec 2009 7