Loading
Online Man Page
This form may be used to access the UNIX man pages. Note this form runs on a Solaris machine, so the results may disagree with other operating system implementations of the commands.
NAME
lpstat - print information about the status of the print
service
SYNOPSIS
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 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 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
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, Update
6 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, Update
6 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; the
default is all. The -l option lists
the form descriptions.
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, Update
6 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 job
objects (-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 more
enumerates 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, Update
6 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 printer
names, class names, and request-IDs.
The key letter -o can be omitted.
Specify printer and class names using
atomic, 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's
configuration is returned, including
the form mounted, the acceptable con-
tent and printer types, a printer
description, and the interface used.
-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 print
service. Items in list can be charac-
ter 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.
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, Update
6 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 obtained
with 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
system
system_name!login-ID a user on sys-
tem
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
network 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
/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.conf
printers.org_dir NIS+ version of /etc/printers.conf
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWlp-cmds |
|_____________________________|_____________________________|
| Interface Stability | Standard |
|_____________________________|_____________________________|
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 require authenti-
cation.