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 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 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, POSIX-style
(server:destination), or Federated Naming Service
(FNS) (.../service/printer/...) names. See
printers.conf(4) for information regarding the naming
conventions for atomic and FNS names, and 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 char-
acter 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 network 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 com-
patible 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 confi-
guration 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 char-
acter 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 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
/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.
fns.ctx_dir.domain
FNS version of /etc/printers.conf.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| 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), attri-
butes(5), standards(5)
Man(1) output converted with
man2html