lpstat(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | FILES | SUMMARY OF TRUSTED SOLARIS CHANGES | ATTRIBUTES | SEE ALSO

NAME

lpstat- Print information about the status of the print service

SYNOPSIS

lpstat [-d] [-r] [-R] [-s] [-t] [-a[list]] [-c[list]] [-f[list][-l]] [-o[list]] [-p[list][-D][-l]] [-P] [-S[list][-l]] [-u[login-ID-list]] [-v[list]] [-M]

DESCRIPTION

lpstat displays information about the current status of the LP print service to standard output.

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:

---

example% lpstat -u "user1 user2 user3"

---

Specifying all after any key letter that takes list as an argument causes all information relevant to the key letter to be printed. For example, the command:

---

example% 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:

---

example% lpstat -o

---

prints the status of all output requests.

The print client commands locate printer information in a very specific order. See printers.conf(4) and printers(4) for details.

OPTIONS

The following options are supported:

-a [list]

Reports whether print destinations are accepting requests. list is a list of intermixed printer names and class names.

-c [list]

Print name of all classes and their members. list is a list of class names.

-d

Print the system default destination for output requests.

-f[list] [-l]

Print 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.

-M

Include multilabel queue information in the output for the -o option. If the -M option is not used, only jobs at the user's current sensitivity label are displayed. If the -M option is used, all jobs at sensitivity labels dominated by the the user's sensitivity label are displayed. If the -M option is used and the user has the bypass system mac check authorization, jobs at all sensitivity labels are displayed.

-o [list]

Print the status of output requests: list is a list of intermixed printer names, class names, and request-IDs. The keyletter -o may be omitted. Normally, lpstat displays only the invoking user's output requests. If the user has the list all print jobs authorization, lpstat displays other users' print jobs as well.

-p [list] [-D] [-l]

Print 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.

-P

Print the paper types.

-r

Print the status of the LP request scheduler.

-R

Print a number showing the position of each job in the print queue.

-s

Print 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]

Print 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

Print all status information. This includes all the information obtained with the -s option, plus the acceptance and idle/busy status of all printers.

-u [login-ID-list]

Print 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

system_name!login-ID

a user on system system_name

system_name!all

all users on system system_name

all!login-ID

a user on all systems

all

all users on all systems

-v [list]

Print the names of printers and the path names of the devices associated with them. For network printers, print the remote system names for the printers. list is a list of printer names.

EXIT STATUS

The following exit values are returned:

0

Successful completion.

non-zero

An error occurred.

FILES

/var/spool/print/*

LP print queue

$HOME/.printers

User-configurable printer database

/etc/printers.conf

System configuration database

SUMMARY OF TRUSTED SOLARIS CHANGES

The -M option is now included. The list all jobs authorization is required for display of other users' print jobs, unless the PRINT_LIST option is set in /etc/default/print. The bypass system mac check authorization is required for display of print jobs at sensitivity labels not dominated by the user's sensitivity label.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWpcu

SEE ALSO

Trusted Solaris 8 Reference Manual

cancel(1), enable(1), lp(1), lpq(1B), lpr(1B), lprm(1B)

SunOS 5.8 Reference Manual

printers( 4), printers.conf(4), attributes(5), standards(5)

Trusted Solaris 8  Last Revised 05 Nov 1999

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | FILES | SUMMARY OF TRUSTED SOLARIS CHANGES | ATTRIBUTES | SEE ALSO