lpstat(1) USER COMMANDS 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 output (or 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. A list that includes spaces or
shell special characters must be enclosed in double quotes.
For example:
-u "user1, user2, user3"
Specifying all after any keyletters that take 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
information relevant to the key letter to be prined. For
example, the command
lpstat -o
prints the status of all output requests.
-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
1
lpstat(1) USER COMMANDS lpstat(1)
requests.
-f [list] [-l]
Prints a verification that the forms in list are recog-
nized by the LP print service. list is a list of
forms; the default is all. The -l option will list the
form descriptions.
-o [list]
Reports the status of output requests. list is a list
of intermixed printer names, class names, and request-
IDs.
-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 confi-
guration is given, including the form mounted, the
acceptable content and printer types, a printer
description, the interface 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 shar-
ing print services, a list of all forms currently
mounted, and a list of all recognized character 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 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.
-t Displays all status information: all the information
2
lpstat(1) USER COMMANDS lpstat(1)
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:
user_name a user on the local system
system_name!user_name
a user on system_name
system_name!all
all users on system_name
all!user_name a user not on the local system
all!all all users not on the local system
all all users on the local system
-v [list]
Reports the names of printers and the pathnames of the
devices associated with them. list is a list of
printer names.
FILES
/var/spool/lp/*
/etc/lp/*
SEE ALSO
enable(1), lp(1).
3