lp(1)

Print each named file. If no file names are specified, standard input is assumed. The hyphen symbol (-) also specifies standard input and can be intermixed on the command line with file names. If more than one - is specified, all but first are ignored. Files are printed in the same order in which they are specified. A maximum of 832 file names can be specified.

Copy the named files to LP subsystem spooling directories.

Normally, the files are linked into a spool directory. The ownership and mode of the linked files remain unchanged. If the -c option is given, or linking is not possible (perhaps because the files do not reside on the same filesystem as that of the spooling directory), the files are copied into the spool directories. The ownership and mode of the copies are set to allow read and write access to owner lp and read access to group lp only.

If the files are linked rather than copied, any changes made to the named files after the request is made but before it is printed will be reflected in the printed output. Standard input is always copied instead of linked.

Select dest as the printer or class of printers that is to do the printing. If dest is a printer, the request will be printed only on that specific printer. If dest is a class, the request will be printed on the first available printer that is a member of the class. Under certain conditions (printer unavailability, file space limitation, etc.), requests for a specific dest might not be accepted (see accept(1M) and lpadmin(1M)).

If the -d option is omitted, dest is taken from the environment variable LPDEST. If that variable is unset or empty, dest is taken from the environment variable PRINTER. If that variable is unset or empty, the default queue is used. If there is no default queue, or default queue exists but is empty or has invalid destination entry, or LPDEST is set but invalid, PRINTER is set but invalid, lp issues an error message and the request is not queued. Printer and class names and the default queue are defined by your LP subsystem administrator (see lpadmin(1M) and lpstat(1)).

Send a mail message (see mail(1)) to the user after the request has been printed. By default, no mail is sent upon normal completion of the print request.

Print number copies of the output. If illegal number of copies is specified with this option, the default number of copies is 1.

Specify a printer-dependent option. You can specify several printer options by repeating the -o option. For information about the options that are available for a printer supported on your system, see the interface script for the printer name in the /etc/lp/interface directory.

Set the priority of the print request. priority must be in the range 0 (lowest priority) to 7 (highest priority). The priority is used by the lpsched scheduler to select the next spooled file for the targeted printer or class of printers. If the priority is less than the fence, the minimum priority set for the printer, the print request is deferred until the fence is lowered or the priority is raised. The default for a printer queue is the default priority set by the lpadmin or lpfence command (see lpadmin(1M) and lpsched(1M)). The default for a class queue is the highest default priority among printers in the class.

Suppress standard output messages from lp such as "request id is ...". Error messages are still displayed on standard error.

Print title on the banner page of the output. The maximum length of the title is 79 bytes. title of length greater than 79 bytes is truncated to 79 bytes.

Write a message to the user's terminal after the request has been printed. If the user is not logged in, or if the user has denied messages to his terminal (see mesg(1)), or (for remote printing) if rlpdaemon (see rlpdaemon(1M)) is not running on the user's local system, mail will be sent instead.

Specifies the request to be altered. id is a request ID returned by lp or lpalt.

Requeue the request to the named printer or class dest. A new unique request ID is written to standard output.

Alter only local requests.

Send mail upon normal completion of the print request.

Change the number of copies to number.

Specify a printer-dependent option. You can specify several printer options by repeating the -o option. All -o options from previous lp and lpalt commands for this request ID are deleted.

Change the request's priority to priority.

Suppress standard output messages from lpalt such as "new request id is ...". Error messages are still displayed on standard error.

Change the title on the banner page of the output.

Write a message to the user's terminal after the request has been printed. If the user is not logged in or if the user has denied messages to his terminal (see mesg(1)) or (for remote printing) if rlpdaemon (see rlpdaemon(1M)). is not running on the user's local system, mail will be sent instead.

Specifies one or more requests to be canceled. id is a request ID returned by lp or lpalt.

Specifies one or more printers or printer classes. If a -a, -e, or -u option is not specified, cancel the request that is currently printing on each dest. In this case, dest must be a printer, not a class. If a -a, -e, or -u option is specified, specify the destination on which to perform the corresponding cancel operation. In this case, dest can be a printer or a class.

Remove all requests the user owns on each dest, or if dest is not specified and -f option is specified, remove all requests the user owns on all destinations in the system. The owner of a request is determined by the user's login name and the host name of the machine where the lp command was invoked.

Empty the spool queue of each dest, or if dest is not specified and -f option is specified, empty the spool queue of all destinations in the system. Only users with appropriate privileges can use this option.

Cancel only local requests.

Remove all requests belonging to user on each dest, or if dest is not specified and -f option is specified, remove all requests belonging to user on all destinations in the system. You can repeat the -u option to specify more users. Only users with appropriate privileges can use this option.

Force cancel -a/-e/-u to act on all destinations in the system.