LPSTAT ( 1 ) USER COMMANDSLPSTAT ( 1 )

NAME

lpstat - report printer status information

SYNOPSIS

lpstat [ options ] [ ID ... ]

DESCRIPTION

The lpstat utility writes to standard output information about the current status of the printer system.

OPTIONS

-a, --acceptance[=list]
Write acceptance status of destinations for output requests. The option value may be omitted.
-c, --class[=list]
Write class names and their members. See section CLASS NAMES below for a description on the naming syntax. The option value may be omitted.
-d, --default
Write system default destination for output requests.
-l, --limit=level
Limit the recursion depth of class expansion to level. Output of job information is not affected.
-o, --ouput[=list]
Write status of output requests. The option value may be omitted.
-p, --printers[=list]
Write status of printers. The option value may be omitted.
-r, --request
Write status of printer request scheduler.
-s, --status|summary
Write a status summary.
-t, --total|all
Write all status information.
-u, --users[=list]
Write status of output requests for users The option value may be omitted.
-v[list]
Write the names of printers and pathnames of the associated devices. The option value may be omitted.

CLASS NAMES

A class name consists of three optional parts, a print provider, a domain and a server, seperated by exclamation marks.

Typical print providers are "Windows NT Remote Printers" or "Windows 95 Local Print Provider".

A server name must be prepended with //.

An example for a fully specified class name is Windows NT Remote Printers!mydomain!//myserver. Alternatively one could have used Windows NT Remote Printers!!//myserver or just //myserver.

When listing servers and printers on a specific domain the print provider must be specified, e.g. Windows NT Remote Printers!mydomain.

EXAMPLES

List all local printers and print providers:
lpstat -c -l1

CAVEATS

Listing printer classes may take a long time. Use more specific class names or the --limit option to restrict the search.

BUGS

lpstat is not completely case-insensitive.

DIAGNOSTICS

lpstat exits with non-zero exit status if an error ocurred.

SEE ALSO

lp(1), cancel(1)

IMPLEMENTATION

version
lpstat (Omnium Software Engineering) 2002-09-20
author
Karsten Fleischer <K.Fleischer@omnium.de >
license
http://www.opensource.org/licenses/mit-license.html