lpstat(1) DG/UX R4.11MU05 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(1) print service.
If no options are given, then lpstat prints the status of all the
user's print requests made by lp. 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 if the current process has read access to the files of
the request.
-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 least upper bound(LUB) MAC label of
the job is printed. The LUB is the least MAC label that still
dominates the MAC labels of all the files of this request.
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 the MAC tuple of the printer is
displayed. Unless the user has appropriate privilege, the
user will only see the labels of the tuple to which they have
MAC read access. If the user has no MAC access to any label
of the MAC tuple, then status for this printer will not be
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
admlpsched(1M), enable(1), lp(1).
NOTES
The lp subsystem supports running with multiple lp schedulers. When
more than one lpsched is defined, each scheduler will appear as an
independent spooler with it's own set of printer queues, lp forms,
classes and user definitions. The lpstat command can operate with
only one lpsched at a time. To "target" a specific lpsched, the
environment variable DGLPSCHED should be set to the desired lpsched
name before executing the lpstat command. If the DGLPSCHED variable
is unset, then the default lpsched will be targeted. The currently
defined lpscheds can be listed with the admlpsched -o list command.
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)