Copyright 1989 AT&T
Copyright (c) 1995, Sun Microsystems, Inc.
All Rights Reserved
Portions Copyright (c) 1992, X/Open Company Limited
All Rights Reserved
If no options are given, then \f3lpstat\f1 prints the status of all the user's print requests made by \f3lp\f1 on the default printer. (see lp (1) and lpr (1)). Any arguments that are not \f2options\f1 are assumed to be \f2request-IDs\f1 as returned by \f3lp\f1 or printer names. The \f3lpstat\f1 command prints the status of such requests. The \f2options\f1 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 separated from one another by a comma, or a list of items separated from one another by spaces enclosed in quotes. For example:
\f3 example% lpstat -u "user1 user2 user3"\f1
Specifying \f3all\f1 after any keyletter that takes \f2list\f1 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 \f2list\f1 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.
15 \f3-A\f1 Use authentication specified by the value of the AUTH environment variable.
15 \f3-a\f1 [\f2list\f1] Reports whether print destinations are accepting requests. list is a list of printer names.
\f3-c\f1 [\f2list\f1] Print name of all classes and their members. list is a list of class names. (Same effect as \f3-o.)
-d Print the system default destination for output requests.
\f3-f \f1[\f2list\f1] [\f3-l\f1] Print list of printers supporting the specified forms option is ignored.
\f3-o\f1 [\f2list\f1] Print the status of output requests: list is a list of intermixed printer names, class names, and \f2request-IDs\f1. The keyletter \f3-o may be omitted.
\f3-p\f1 [\f2list\f1] Print the status of printers. \f2list\f1 is a list of printer names. (Same effect as \f3-o.)
-P Print the paper types. Ignored.
-r Print the status of the LP request scheduler.
-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.
\f3-S \f1[\f2list\f1] [\f3-l\f1] List or verify character sets of printers. (Ignored.)
-t Print all status information.
\f3-u\f1 [\f2login-ID-list\f1] Print the status of output requests for users. (Same effect as \f3-o.)
15 \f3-v\f1 [\f2list\f1] Print the path names of the printer output devices. (Ignored.) -D Combined with the -p flag prints description of printer.
15 \f3-Toptions\f1 Set debugging options. Use -T= to get lpstat to provide a list.
By default, the destination printer is taken from the command line dest value, then the environment variables PRINTER, LPDEST, NPRINTER, NGPRINTER, then first entry in the printcap information, and and finally the default_printer entry from the configuration file, and then the compile time default.
The following exit values are returned:
15 "zero (0)" Successful completion.
"non-zero (!=0)" An error occurred.
The files used by LPRng are set by values in the printer configuration file. The following are a commonly used set of default values.
_LPD_CONF_PATH_ LPRng configuration file
${HOME}/.printcap user printer description file
_PRINTCAP_PATH_ printer description file
_LPD_PERMS_PATH_ permissions
_LOCKFILE_ lock file for queue control
/var/spool/lpd spool directories
/var/spool/lpd/QUEUE/control queue control
/var/spool/lpd/QUEUE/log trace or debug log file
/var/spool/lpd/QUEUE/acct accounting file
/var/spool/lpd/QUEUE/status status file
Most of the diagnostics are self explanatory. If you are puzzled over the exact cause of failure, set the debugging level on (-T5) and run again. The debugging information will help you to pinpoint the exact cause of failure.