LP(1)                                SysV                                LP(1)



NAME
     lp, cancel - send/cancel requests to an LP line printer

SYNOPSIS
     lp [-c] [-ddest] [-m] [-nnumber] [-ooption] [-s] [-ttitle] [-wfiles]
     cancel [ids] [printers]

DESCRIPTION
     lp arranges for the named files and associated information (collectively
     called a "request") to be printed by a line printer.  If no file names
     are mentioned, the standard input is assumed.  A dash (-) used as a file
     name indicates the standard input and may be supplied on the command line
     in conjunction with named files.  The order in which files appear is the
     same order in which they will be printed.

     lp associates a unique "id" with each request and prints it on the
     standard output.  This id can be used later to cancel (see cancel) or
     find the status (see lpstat(1)) of the request.

OPTIONS
     The following options to lp may appear in any order and may be intermixed
     with file names:

     -c        Makes copies of the file(s) to be printed immediately when lp
               is invoked.  Normally, files will not be copied, but will be
               linked whenever possible.  If the -c option is not given, then
               you should be careful not to remove any of the file(s) before
               the request has been printed completely.  Without the -c
               option, any changes made to the named files after the request
               is made, but before it is printed, will be reflected in the
               printed output.

     -ddest    Chooses dest as the printer or class of printers where printing
               will take place. If dest is a printer, the request will be
               printed only on that specific printer.  If dest is a class of
               printers, the request will be printed on the first available
               printer that is a member of the class.  Under certain
               conditions (printer availability, file space limitation, etc.),
               requests for specific destinations may not be accepted (see
               accept(1M) and lpstat(1)).  By default, dest is taken from the
               environment variable LPDEST (if it is set).  Otherwise, a
               default destination (if one exists) for the computer system is
               used.  Destination names vary between systems (see lpstat(1)).

     -m        Sends mail after the files have been printed (see mail(1)).  By
               default, no mail is sent.

     -nnumber  Prints number copies of the output (default is 1).

     -ooption  Specifies a printer-dependent or class-dependent option.
               Several such options may be collected by specifying -o more
               than once. For more information about what are valid options,
               see Models in lpadmin(1M).

     -s        Suppresses messages from lp(1) such as "request id is ...".

     -ttitle   Prints title on the banner page of the output.

     -w        Writes a message to your terminal after the files have been
               printed.  If you are not logged in, mail is sent instead.

     Cancel cancels line printer requests made by lp(1).  The command line
     arguments can be either request ids (as returned by lp(1)) or printer
     names (for a complete list of printer names, use lpstat(1)).  Specifying
     a request id cancels the associated request even if it is currently
     printing.  Specifying a printer cancels the request which is currently
     printing on that printer.  In either case, the cancellation of a request
     that is currently printing frees the printer to print its next available
     request.

FILES
     /usr/spool/lp/*

SEE ALSO
     enable(1), lpstat(1), mail(1).
     accept(1M), lpadmin(1M), lpsched(1M) in the Managing SysV System
     Software.