lpstat - print information about the status of the LP
print service
SYNOPSIS
lpstat [ -A ] [ -d ] [ -r ] [ -R ] [ -s ] [ -t ] [ -a
[list] ]
[ -c [list] ] [ -f [list] [ -l ] ] [ -o [list] ]
[ -p [list] [ -D ] [ -l ] ] [ -P ]
[ -S [list] [ -l ] ] [ -u [login-ID-list] ]
[ -v [list] ] [ -Tdebugoptions ] [list]
DESCRIPTION
The lpstat command prints information about the current
status of the LP print service. This is implemented as a
front end to the LPRng lpq(1) program, and does not have
the full functionality of the native lpstat program.
If no options are given, then lpstat prints the status of
all the user's print requests made by lp on the default
printer. (see lp(1) and lpr(1)). Any arguments that are
not options are assumed to be request-IDs as returned by
lp or printer names. The lpstat command prints the status
of such requests. The options may appear in any order and
may be repeated and intermixed with other arguments. Some
of the keyletters below may be followed by an optional
list that can be in one of two forms: a list of items sep
arated 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 keyletter that takes list as an
argument causes all information relevant to the keyletter
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.
OPTIONS
The following options are supported:
-A Use authentication specified by the value
of the AUTH environment variable.
accepting requests. list is a list of
printer names.
-c [list] Print name of all classes and their mem
bers. list is a list of class names.
(Same effect as -o.)
-d Print the system default destination for
output requests.
-f [list] [-l] Print list of printers supporting the spec
ified forms option is ignored.
-o [list] Print the status of output requests: list
is a list of intermixed printer names,
class names, and request-IDs. The keylet
ter -o may be omitted.
-p [list] Print the status of printers. list is a
list of printer names. (Same effect as
-o.)
-P Print the paper types. Ignored.
-r Print the status of the LP request sched
uler.
-R Print a number showing the position of each
job in the print queue. Ignored.
-s Print a status summary. Produces a short
status listing.
-S [list] [-l] List or verify character sets of printers.
(Ignored.)
-t Print all status information.
-u [login-ID-list]
Print the status of output requests for
users. (Same effect as -o.)
-v [list] Print the path names of the printer output
devices. (Ignored.)
-Toptions Set debugging options. Use -D= to get
lpstat to provide a list.
ENVIRONMENT
By default, the destination printer is taken from the com
mand line dest value, then the environment variables
PRINTER, LPDEST, NPRINTER, NGPRINTER, then first entry in
the printcap information, and and finally the
then the compile time default.
EXIT STATUS
The following exit values are returned:
zero (0) Successful completion.
non-zero (!=0) An error occurred.
FILES
The files used by LPRng are set by values in the printer
configuration file. The following are a commonly used set
of default values.
/etc/lpd.conf LPRng configuration file
${HOME}/.printcap user printer description file
/etc/printcap system printer description file
/etc/lpd.perms printer permissions
/var/spool/printer* spool directories
/var/spool/printer*/printer lock file for queue control
/var/spool/printer*/control.printer queue control
/var/spool/printer*/active.printer active job
/var/spool/printer*/log.printer log file
SEE ALSO
lpd.conf(5), lpc(8), lpd(8), checkpc(8), lpr(1), lpq(1),
lprm(1), printcap(5), lpd.perms(5), pr(1).
DIAGNOSTICS
Most of the diagnostics are self explanatory.
If you are puzzled over the exact cause of failure,
set the debugging level on (-D5) and run again.
The debugging information will
help you to pinpoint the exact cause of failure.
HISTORY
LPRng is a enhanced printer spooler system with function
ality similar to the Berkeley LPR software. The LPRng
mailing list is lprng@lprng.com; subscribe by sending mail
to lprng-request@lprng.com with the word subscribe in the
body. The software is available from
ftp://ftp.astart.com/pub/LPRng.
AUTHOR
Patrick Powell <papowell@lprng.com>.
Man(1) output converted with
man2html