lp(1)                                                       lp(1)



NAME
     lp - spools print requests to printers

SYNOPSIS
     lp [-c] [-ddest] [-m] [-nnumber] [-ooption] [-s] [-ttitle]
     [-w] [file]...

ARGUMENTS
     -c   Makes copies of the files specified by files
          immediately after you enter the lp command.  Normally,
          the system doesn't copy files, but links files whenever
          possible.  If you don't include this option, be careful
          not to remove any of the files being printed until all
          printing is complete.  Also note that without this
          option, any changes you make to the files after you
          enter the lp command and before printing is complete
          will appear in the printed output.

     -ddest
          Specifies the printer or class of printers to use when
          printing particular jobs.  If dest specifies a printer,
          then the system uses that specific printer.  If dest
          specifies a class of printers, then the system prints
          on the first available printer that is a member of the
          class.  Under certain conditions (printer
          unavailability, insufficient file space, and so forth),
          the system can not accept requests for specific
          destinations (see accept(1M) and lpstat(1)).  By
          default, the system uses dest from the environment
          variable LPDEST (if it is set).  Otherwise, lp goes to
          the default destination (if one exists) for the system
          you are using.  Destination names vary between systems
          (see lpstat(1)).

     file Specifies the file to be spooled.

     -m   Sends mail by means of mail(1) after the files have
          been printed.  By default, the system sends no mail
          upon normal completion of the print request.

     -nnumber
          Specifies the number of copies to be printed for
          particular jobs.  The default is 1.

     -ooption
          Specifies the printer-dependent or class-dependent
          options.  You can specify multiple options by using the
          key character -o more than once.  For more information
          about valid options, see ``Models'' in lpadmin(1M).

     -s   Suppresses messages from lp such as request id is id.




January 1992                                                    1

lp(1)                                                       lp(1)



     -ttitle
          Specifies the title that prints on the banner page for
          particular jobs.

     -w   Writes a message on your terminal after the the system
          prints the files.  If you aren't logged on at the time
          the message is written, the system sends mail instead.

DESCRIPTION
     lp spools the named files (or standard input if it is used
     at the end of a pipe) for printing.

     If you don't include filenames, the lp command waits to
     receive text data typed on the standard input followed by an
     end-of-file character.  You can also use a hyphen (-) on the
     command line (with or without filenames) to represent the
     standard input, which could be a pipe rather than text typed
     at the keyboard.  (See the ``Limitations''section later in
     this manual page.)  The lp command prints the files
     (including the standard input) in the same order as that in
     which they appear on the command line.

     The lp command associates a unique job identification number
     with each request and displays that number as part of its
     status message (sent to the standard output).  You can use
     this ID to stop a job which is printing or is scheduled to
     print (see cancel(1)).

LIMITATIONS
     Any files specified must be readable by the lp user account
     because /usr/bin/lp changes the effective user ID to lp.  If
     the file permissions assigned to files don't allow lp to
     read them, you must use a pipe to direct the files to lp, as
     shown here.  (Besides cat, other frequently used printer-
     formatting utilities are pr and troff.)

        cat files|lp


FILES
     /usr/bin/lp
          Executable file
     /usr/spool/lp/*
          Print job information files
SEE ALSO
     cancel(1), enable(1), lpq(1), lpr(1), lpstat(1), mail(1)

     accept(1M), lpadmin(1M), lpsched(1M) in A/UX System
     Administrator's Reference






2                                                    January 1992