lpstat(1) — Commands
NAME
lpstat − Displays line printer status information
SYNOPSIS
lpstat [−a[list]] [−c[list]] [−d | −r | −s | −t] [−o[list]] [−p[list]] [−u[list]] [−v[list]] [request_ID...]
The lpstat command displays information about the current status of the line printer.
FLAGS
−a[list]Specifies the display of acceptance status (with respect to the lp and lpr commands) of destinations for requests. The list argument is a list of intermixed printer names and request IDs.
−c[clist]Write the class names and their members. The list argument is a list of class names.
−dSpecifies the display of the system default destination for the lp and lpr commands.
−o[list]Specifies the display of the status of printer requests. The list argument is a list of intermixed printer names and request IDs.
−p[list]Specifies the display of the status of printers. The list argument is a list of printer names.
−rSpecifies the display of the status of the line printer daemon.
−sSpecifies the display of a status summary, including the status of the line printer scheduler, the system default destination, and a list of printers and their associated devices.
−tSpecifies the display of all status information.
−u[list]Specifies the display of the status of all printer requests. The list argument is a list of usernames.
−v[list]Specifies the display of the names of printers and the path names of the devices associated with them. The list argument is a list of printer names.
PARAMETERS
request_IDA request ID as returned by lp or lpr.
DESCRIPTION
If no flags are given, then lpstat displays the status of all requests made by the lp and lpr commands. Any arguments that are not flags are assumed to be a request_ID (as returned by the lp or lpr commands). The lpstat command displays the status of such requests.
Flags can appear in any order and can be repeated and intermixed with other flags. Some flags can be followed by an optional list that is either 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 or one or more spaces. For example:
−u"user1, user2, user3"
Specifying just the flag with no arguments causes all information pertaining to that flag to be displayed.
If the LPDEST environment variable is set to a valid printer name, this becomes the default destination; otherwise, PRINTER is tried and, as a last resort, a system-specific printer.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of lpstat:
LANGProvides a default value for the internationalization variables that are unset or null. If LANG is unset or null, the corresponding value from the default locale is used. If any of the internationalization variables contain an invalid setting, the utility behaves as if none of the variables had been defined.
LC_ALLIf set to a non-empty string value, overrides the values of all the other internationalization variables.
LC_CTYPEDetermines the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte as opposed to multibyte characters in arguments).
LC_MESSAGESDetermines the locale for the format and contents of diagnostic messages written to standard error.
NLSPATHDetermines the location of message catalogues for the processing of LC_MESSAGES.
TZDetermines the time zone used with date and time strings.
NOTES
[Digital] Output produced by the lpstat command is very similar to output from lpq and lpc, rather than output from earlier versions of lpstat.
FILES
/etc/printcapPrinter description file.
/var/spool/∗Spool directories.
/var/spool/∗/minfreeMinimum free space to leave.
/dev/lp∗Line printer devices.
/dev/printerSocket for local requests.
/var/spool/∗/cf∗Daemon control files.
/var/spool/∗/df∗Data files specified in cf files.
/var/spool/∗/tf∗Temporary copies of cf files.
/var/spool/∗/lockLock file used to obtain the process ID of the current daemon and the request ID of the currently active request.
EXIT VALUES
The following exit values are returned:
0Successful completion
>0An error occurred
RELATED INFORMATION
Commands: lp(1)/cancel(1), lpc(8), lpd(8), lpq(1), lpr(1), lprm(1)