lpstat(1) (AT&T Spooler only) lpstat(1)
NAME
lpstat - print information about the status of the LP print service
SYNOPSIS
lpstat [options]
DESCRIPTION
The lpstat command prints information about the current status of the
LP print service.
If no options are given, then 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. 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 separated from
one another by a comma, or a list of items separated from one another
by spaces enclosed in quotes. For example:
-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
lpstat -o all
prints the status of all output requests.
The omission of a list following such key letters causes all informa-
tion relevant to the key letter to be printed. For example, the com-
mand
lpstat -o
prints the status of all output requests.
OPTIONS
-a [list]
Reports whether print destinations are accepting requests. list
is a list of intermixed printer names and class names.
-c [list]
Reports name of all classes and their members. list is a list of
class names.
-d Reports the system 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
Page 1 Reliant UNIX 5.44 Printed 11/98
lpstat(1) (AT&T Spooler only) lpstat(1)
all. The -l option will list the form descriptions.
-o [list]
Reports the status of output requests: list is a list of inter-
mixed printer names, class names, and request-IDs. The keyletter
-o may be omitted.
-p [list] [-D] [-l]
Reports 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 given, including the form mounted, the accept-
able content and printer types, a printer description, the inter-
face used, and so on. If the -l option is given and the printer
is remote, the only information given is the remote machine and
printer names, and the shell-commands used for file transfer and
remote execution.
-r Reports whether the LP request scheduler is on or off.
-R Reports a number showing the position of the job in the print
queue.
-s Displays a status summary, including the status of the LP
scheduler, the system default destination, a list of class names
and their members, 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 charac-
ter sets and print wheels.
-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 charac-
ter 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.
-t Displays all status information: all the information obtained
with the -s option, plus the acceptance and idle/busy status of
all printers.
-u [login-ID-list]
Displays 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
systemname!login-ID
Page 2 Reliant UNIX 5.44 Printed 11/98
lpstat(1) (AT&T Spooler only) lpstat(1)
a user on system systemname
systemname!all
all users on system systemname
all!login-ID a user on all systems
all all users on all systems
-v [list]
Reports the names of printers and the pathnames of the devices
associated with them or remote system names for network printers:
list is a list of printer names.
INTERNATIONALIZED ENVIRONMENT
The LCMESSAGES environment variable governs the language in which
message texts are displayed. LCTIME governs the format and contents
of date specifications in the output of status information.
If LCMESSAGES or LCTIME is undefined or defined as the null string,
it defaults to the value of LANG. If LANG is likewise undefined or
null, the system acts as if it were not internationalized.
The LCALL environment variable governs the entire locale. LCALL
takes precedence over all other environment variables which affect
internationalization.
ENVIRONMENT VARIABLES
TZ Defines the time zone within date and time specifications.
FILES
/var/spool/lp/*
/etc/lp/*
SEE ALSO
enable(1), lp(1).
Page 3 Reliant UNIX 5.44 Printed 11/98