NAME

lpstat − print LP status information

SYNOPSIS

lpstat [options] [id...]

DESCRIPTION

lpstat prints information about the current status of the LP line printer system. 

If no options are given, lpstat prints the status of all requests made to lp by the user (see lp(1)). Any arguments that are not options are assumed to be request ids (as returned by lp).  lpstat prints the status of such requests.  options can appear in any order and can be repeated and intermixed with other arguments.  Some of the keyletters 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 list of items enclosed in double quotes and separated from one another by a comma and/or one or more spaces as in:

-u"user1, user2, user3"

Omission of a list following such keyletters causes all information relevant to the keyletter to be printed.  For example:

lpstat -o

prints the status of all output requests. 

-a[list] Print acceptance status (with respect to lp) of destinations for requests.  list is a list of intermixed printer names and class names. 

-c[list] Print class names and their members.  list is a list of class names. 

-d Print the system default destination for lp. 

-i Inhibit the reporting of remote status. 

-o[list] Print the status of output requests.  list is a list of intermixed printer names, class names, and request ids. See the -i option. 

-p[list] Print the status of printers.  list is a list of printer names. 

-r Print the status of the LP request scheduler

-s Print 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 Print all status information.  Same as specifying -r, -s, -a, -p, -o.  See the -i option. 

-u[list] Print status of output requests for users.  list is a list of login names. 

-v[list] Print the names of printers and the path names of the devices associated with them.  list is a list of printer names. 

HP Clustered Environment

In the HP Clustered Environment, all spooling is handled as if the cluster nodes were a single system and all printers attached to either the cluster server or clients can be available.  Remote spooling applies to spooling from or to machines outside of the cluster nodes. 

EXTERNAL INFLUENCES

Environment Variables

LC_TIME determines the format and contents of date and time strings. 

LANG determines the language in which messages are displayed. 

If LC_TIME is not specified in the environment or is set to the empty string, the value of LANG is used as a default for each unspecified or empty variable.  If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG.  If any internationalization variable contains an invalid setting, lpstat behaves as if all internationalization variables are set to "C".  See environ(5).

EXAMPLES

Check whether your job is queued:

lpstat

Check the relative position of a queued job:

lpstat -t

Verify that the job scheduler is running:

lpstat -r

FILES

/usr/spool/lp/*

SEE ALSO

enable(1), lp(1), rlpstat(1M). 

STANDARDS CONFORMANCE

lpstat: SVID2, XPG2, XPG3

Hewlett-Packard Company  —  HP-UX Release 9.10: April 1995