lpstat.1 (2010 09)

l
lpstat(1) lpstat(1)
Security Restriction
Only users who have the lp subsystem authorization or the
printqueue secondary subsystem authori-
zation can view the entire queue. Unauthorized users can view only their own jobs whose sensitivity lev-
els are dominated by the user’s current sensitivity level.
The
allowmacaccess
privilege allows viewing jobs at higher sensitivity levels.
EXTERNAL INFLUENCES
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-specific default locale will be used. If any of the international-
isation variables contains an invalid setting, the utility will behave as if none
of the variables had been defined.
LC_ALL If set to a non-empty string value, override the values of all the other interna-
tionalisation variables.
LC_CTYPE Determine the locale for the interpretation of sequences of bytes of text data as
characters (for example, single- as opposed to multi-byte characters in argu-
ments).
LC_MESSAGES Determine the locale that should be used to affect the format and contents of
diagnostic messages written to standard error, and informative messages writ-
ten to standard output.
LC_TIME Determine the format of date and time strings output when displaying line
printer status information with the -a, -o, -p, -t
,or-u options.
NLSPATH Determine the location of message catalogues for the processing of
LC_MESSAGES.
TZ Determine the timezone used with date and time strings.
LPDEST Determine the output device or destination. If the LPDEST environment vari-
able is not set, the PRINTER environment variable is used.
PRINTER Determine the output device or destination. If the PRINTER environment
variable is not set, the default queue is used. LPDEST environment variable
takes precedence over PRINTER.
STDOUT
The standard output is a text file containing the information described Options , in an unspecified format.
STDERR
Used only for diagnostic messages.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
APPLICATION USAGE
The
lpstat utility cannot reliably determine the status of print requests in all conceivable cir-
cumstances. When the printer is under the control of another operating system or resides on a remote
system across a network, it need not be possible to determine the status of the print job after it has left
the control of the local operating system. Even on local printers, spooling hardware in the printer may
make it appear that the print job has been completed long before the final page is printed.
EXAMPLES
Check whether your job is queued:
lpstat
Check the relative position of a queued job:
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010