lp(1)

lp(1)

-a

Remove all requests the user owns on each printer. The owner is determined by the user's

 

login name and the host name of the machine where the lp command was invoked.

-e

Empty the spool queue of all requests for each printer. Only users with appropriate

 

privileges can use this option.

-i

Cancel only local requests.

-uuser

Remove any requests belonging to user. You can repeat the -uoption to specify more

 

users. Only users with appropriate privileges can use this option.

Printing Overview

A printer can print requests from one or two destination queues: its own private queue and an optional class queue, which can serve one or more printers. The destination queues are set up with the lpadmin command. The lp command places a printing request into a printer or class destination queue as directed by a user. The lpsched scheduler directs the requests from the destination queues to the printers. The accept and reject commands control whether lp can place requests in the destination queues. The enable and disable commands control whether lpsched can send a queued request to a printer. If a printer has two queues and one queue is rejecting requests, users can still direct requests to the other destination queue and have the requests printed. lpstat reports the current status of the destination queues and the scheduler. See enable(1), lpstat(1), accept(1M), and lpadmin(1M).

EXTERNAL INFLUENCES

Environment Variables

LANG determines the locale to use for the locale categories when both LC_ALL and the corresponding environment variable (beginning with LC_) do not specify a locale. If LANG is not set or is set to the empty string, a default of "C" (see lang(5)) is used.

LC_ALL determines the locale to use to override any values for locale categories speci®ed by the setting of LANG or any environment variables beginning with LC_.

LC_CTYPE determines the locale for interpretation of sequences of bytes of text data as characters (e.g., single- verses multibyte characters in arguments and input ®les).

LC_MESSAGES determines the language in which messages are displayed.

LPDEST determines the output device or destination. If the LPDEST environment variable is not set, the PRINTER environment variable is used. The -ddest option takes precedence over LPDEST. Results are unde®ned when -dis not speci®ed and LPDEST contains a value that is not a valid device or destination name.

PRINTER determines the output device or destination. If the LPDEST and PRINTER environment variables are not set, an unspeci®ed output device is used. The -ddest option and the LPDEST environment variable takes precedence over PRINTER. Results are unde®ned when -dis not speci®ed, LPDEST is unset, and PRINTER contains a value that is not a valid device or destination name.

If any internationalization variable contains an invalid setting, the commands behave as if all internationalization variables are set to "C". See environ(5).

International Code Set Support

Single- and multibyte character code sets are supported.

RETURN VALUE

Exit values are:

0Successful completion. >0 Error condition occurred.

EXAMPLES

For a HP2934A printer named lp2, con®gured with an interface script that de®nes the -coption to cause the printer to print in a compressed mode, use the following command to print myfile with compressed print on lp2:

lp -dlp2 -oc myfile

lp can be used at the end of a pipeline to print the results of a previous command. It is commonly used with the pr command (see pr(1)) to print formatted output. For a default printer, to format ®le .pro- file into pages and print three copies of it:

HP-UX Release 11i: December 2000

− 3 −

Section 1−471

l