l

lpstat(1)

lpstat(1)

NAME

lpstat - report line printer status information

SYNOPSIS

lpstat [-drst] [-a[list]] [-c[list]] [-o[list]] [-p[list]] [-u[list]] [-v[list]] [ID...]

DESCRIPTION

The lpstat utility writes to standard output information about the current status of the line printer sys- tem.

If no arguments are given, lpstat writes the status of all requests made to lp by the user that are still in the output queue.

OPTIONS

The lpstat utility supports the XBD speci®cation, Section 10.2, Utility Syntax Guidelines, except the option-arguments are optional and cannot be presented as separate arguments.

Some of the options below can 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 quoted list of items separated from one another by a comma or one or more blank characters, or combinations of both. See EXAMPLES.

The omission of a list following such options causes all information relevant to the option to be written to standard output; for example:

lpstat -o

writes the status of all output requests that are still in the output queue.

-a[list ]

Write the acceptance status of destinations for output requests. The list argument is a

 

list of intermixed printer names and class names.

-c[list ]

Write the class names and their members. The list argument is a list of class names.

-d

Write the system default destination for output requests.

-o[list ]

Write the status of output requests. The list argument is a list of intermixed printer

 

names, class names and request IDs.

-p[list ]

Write the status of printers. The list argument is a list of printer names.

-r

Write the status of the line printer request scheduler.

-s

Write a status summary, including the status of the line printer scheduler, the system

 

default destination, a list of class names and their members and a list of printers and

 

their associated devices.

-t

Write all status information.

-u[list ]

Write the status of output requests for users. The list argument is a list of login names.

-v[list ]

Write the names of printers and the pathnames of the devices associated with them. The

 

list argument is a list of printer names.

OPERANDS

The following operand is supported:

ID

A request ID, as returned by lp.

 

STDIN

 

 

Not used.

 

 

INPUT FILES

 

 

None.

 

 

ENVIRONMENT VARIABLES

 

The following environment variables affect the execution of lpstat:

 

LANG

Provide a default value for the internationalisation variables that are unset

 

or null. If LANG is unset or null, the corresponding value from the

 

implementation-speci®c default locale will be used. If any of the interna-

 

tionalisation variables contains an invalid setting, the utility will behave as

Section 1−476

− 1 −

HP-UX Release 11i: December 2000