lpstat(1) DG/UX R4.11 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
information relevant to the key letter to be printed. For example,
the command
lpstat -o
prints the status of all output requests.
On a DG/UX system with security features added, the user will only
see the jobs that his current process clearance (MAC label)
dominates.
-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
all. The -l option will list the form descriptions.
On a generic DG/UX system: -o [list] [-l]
On a system with DG/UX information security:
-o [list] [-l] [-M]
Reports the status of output requests: list is a list of intermixed
printer names, class names, and request-IDs. The keyletter -o may be
omitted. If the -l option is given, then additional status is
provided including the target printer queue, the requested form and
the character set. On a system with DG/UX information security, if
the -M option is used, then the MAC label of the process that
submitted the job is printed.
On a generic DG/Ux system:
-p [list] [-D] [-l]
On a system with DG/UX information security:
-p [list] [-D] [-l] [-M] 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 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. On a system with DG/UX information security, if
the -M option is used, then if the user has appropriate
privilege or if the process clearance dominates the upper
bound of the printer MAC range, the printer MAC range is
displayed. If the process clearance dominates the lower bound
of the printer MAC range, that lower bound is displayed.
-r Reports whether the LP request scheduler is on or off.
On a system with DG/UX information security: -R
Reports the Rank in the queue of the job.
-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 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.
On a generic DG/UX system: -t
On a system with DG/UX information security: -t [-M]
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
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.
FILES
/var/spool/lp/*
/etc/lp/*
SEE ALSO
enable(1), lp(1).
NOTES
On a generic DG/UX system, appropriate privilege is granted by having
an effective UID of 0 (root). See the appropriateprivilege(5) man
page for more information.
On a system with DG/UX information security, appropriate privilege is
granted by having one or more specific capabilities enabled in the
effective capability set of the user. See the capdefaults(5) man
page for more information.
Only local printers are supported on this release of the DG/UX System
with security features added.
Licensed material--property of copyright holder(s)