lp - send requests to an LPRng print service


SYNOPSIS

       lp [ -A ] [ -B ] [ -c ] [ -G ] [ -m ] [ -p ] [ -s ] [ -w ]
       [ -d dest ]
            [ -f form-name [ -d any ] ] [ -H special-handling ]
            [ -n number ] [ -o option ] [ -P page-list ]
            [ -q priority-level ] [ -S character-set [ -d any ] ]
            [ -S print-wheel [ -t title ]
            [ -T content-type [ -r ] ] [ -y mode-list ]
            [ -X path ] [ -D debug-options ]
            [ file...  ]


DESCRIPTION

       The LPRng lpr client supports an lp interface when invoked
       with the lp program name.  This is usually done by  making
       a symbolic link to the lpr program with the name lp.  This
       is similar to the ex(1) and vi(1) programs.  The supported
       form  of the lp command arranges for the named file(s) and
       associated information (collectively called a request)  to
       be printed.  If no file names are specified on the command
       line, the standard input is assumed.  The  standard  input
       may be specified along with a named file(s) on the command
       line by listing the file name(s) and specifying `-´ (dash)
       for  the standard input.  The files will be printed in the
       order in which they appear on the shell command line.

       The LP print service associates a unique  request-ID  with
       each  request and displays it on the standard output.  The
       job number portion or full request-ID can  be  used  later
       with  cancel(1)  or  lprm(1)  when canceling a job or when
       determining its status.  See  cancel(1)  and  lprm(1)  for
       details  about  canceling  a  request,  and  lpstat(1) and
       lpq(1) for information about  checking  the  status  of  a
       print request.


OPTIONS

       Options  to  lp  always precede any file names, but may be
       specified in any order.  The following options are  avail­
       able for lp:

       -A             Use authenticated transfer.  Note that this
                      is not a standard lp(1) option but has been
                      added  for  compatibilty  with  LPRng.  The
                      authentication type is set by the value  of
                      the  AUTH environment variable.  -B Process
                      jobs using filters specified in the  print­
                      cap information.  The filter output is com­
                      bined into a single file and  sent  to  the
                      print spooler.

       -c             Make  a  copy  of the file before printing.
                      (This has no effect as LPRng  always  sends

                      printing.)

       -d dest        The print queue or printer to be used.   By
                      default,  the  destination printer is taken
                      from the command line dest value, then  the
                      environment   variables   PRINTER,  LPDEST,
                      NPRINTER, NGPRINTER, then  first  entry  in
                      the  printcap  information, and and finally
                      the default_printer entry from the configu­
                      ration  file,  and  then  the  compile time
                      default.

       -f form-name   Print the request on  the  form  form-name.
                      This sets the job class to form-name and is
                      similar to the lpr -C option.   -G  Process
                      jobs  using filters specified in the print­
                      cap information.   The  filter  output  for
                      individual  files  is  sent  to  the  print
                      spooler.

       -H special-handling
                      These options are ignored.

       -m             Send mail (see  mail(1))  after  the  files
                      have  been  printed.   The  mail address is
                      taken from the  USER  enviroment  variable.
                      By  default,  no  mail  is sent upon normal
                      completion of the print request.

       -n number      Print number copies (default is 1)  of  the
                      output.

       -o option      Specify printer-dependent options.  Several
                      such options may be collected by specifying
                      the -o keyletter more than once (-o $option
                      sub 1$ -o $option sub 2$ ... -o $option sub
                      n$), or by specifying the -o keyletter fol­
                      lowed by a list of options enclosed in dou­
                      ble  quotes  (that  is,  -o "$option sub 1$
                      $option sub 2$ ... $option sub  n$").   The
                      following  options have a immediate effect;
                      other options are passed as a Z line  entry
                      in the control file, i.e. - as an lpr(1) -Z
                      option.

                      nobanner  Do not print a banner  page  with
                                this  request.   This is the same
                                as  the  lpr(1)  -h  (no  header)
                                option.

                      width=number
                                Print  this  request  with  page-
                                width set to number.  This is the

                                option.

       -P page-list   Print the  pages  specified  in  page-list.
                      This option is ignored.

       -p             Enable  notification  on  completion of the
                      print request.  This option is ignored.

       -q priority-level
                      Assign this request priority-level  in  the
                      printing  queue.   The  values of priority-
                      level range from 0, the  highest  priority,
                      to  25, the lowest priority.  If a priority
                      is not specified, the default for the print
                      service  is used, as assigned by the system
                      administrator.  A  priority  limit  may  be
                      assigned  to individual users by the system
                      administrator.  The  numerical  values  are
                      translated to corresponding letter priority
                      values.

       -s             Suppress messages from  lp  such  as  those
                      that begin with "request id is..."
       -S character-set
       -S print-wheel Print  this  request  using  the  specified
                      character-set or print-wheel.  The  options
                      are passed as an lpr(1) -Z option.

       -t title       Print  title on the banner page of the out­
                      put.  If title is not supplied the name  of
                      the  file  is  printed  on the banner page.
                      Enclose title  in  quotes  if  it  contains
                      blanks.

       -T content-type [-r]
                      Print  the  request  on  a printer that can
                      support the  specified  content-type.   The
                      content-type  is  passed  as  an  lpr(1) -Z
                      option.

       -w             Write a  message  on  the  user's  terminal
                      after  the  files  have been printed.  This
                      option is ignored.

       -X path        Filter individual job files using the spec­
                      ified program and send the filter output to
                      the print spooler.

       -y mode-list   Print this request according to the  print­
                      ing  modes  listed in mode-list.  The mode-
                      list-type is passed as an lpr(1) -Z option.

                      A  list  of  debug options for the program.
                      These can be a number (debug level) or key­
                      word  and level (flag), such as 9, network,
                      network+2, etc.


OPERANDS

       The following operands are supported by lp:

       file           A path name of a file to be output.  If  no
                      file  operands  are specified, or if a file
                      operand is -, the standard  input  will  be
                      used.   The  -  option  must be last in the
                      list.


PRINTCAP INFORMATION

       The printer names and other  information  is  obtained  by
       using  a  printcap  file  or  some  other  database.   The
       ${HOME}/.printcap file can be used to specify  user  level
       options  and  configuration  information.  See printcap(5)
       for more information.


ENVIRONMENT

       By default, the destination printer is taken from the com­
       mand  line  dest  value,  then  the  environment variables
       PRINTER, LPDEST, NPRINTER, NGPRINTER, then first entry  in
       the    printcap   information,   and   and   finally   the
       default_printer entry from  the  configuration  file,  and
       then the compile time default.


EXIT STATUS

       The following exit values are returned:

       zero (0)       Successful completion

       nonzero (!= 0) An error occurred.


FILES

       The  files  used by LPRng are set by values in the printer
       configuration file.  The following are a commonly used set
       of default values.
       /etc/lpd.conf                                LPRng configuration file
       ${HOME}/.printcap                            user printer description file
       /etc/printcap                                system printer description file
       /etc/lpd.perms                               printer permissions
       /var/spool/printer*                          spool directories
       /var/spool/printer*/printer                  lock file for queue control
       /var/spool/printer*/control.printer          queue control
       /var/spool/printer*/active.printer           active job
       /var/spool/printer*/log.printer              log file


SEE ALSO

       lpd.conf(5),  lpc(8),  lpd(8),  lpr(1),  lpq(1),  lprm(1),
       printcap(5), lpd.perms(5), pr(1).

       Most of the diagnostics are self explanatory.
       If you are puzzled over the exact cause of failure,
       set the debugging level on (-D5) and run again.
       The debugging information will
       help you to pinpoint the exact cause of failure.


HISTORY

       LPRng is a enhanced printer spooler system with  function­
       ality  similar  to  the  Berkeley LPR software.  The LPRng
       mailing list is lprng@lprng.com; subscribe by sending mail
       to  lprng-request@lprng.com with the word subscribe in the
       body.      The     software     is     available      from
       ftp://ftp.astart.com/pub/LPRng.


AUTHOR

       Patrick Powell <papowell@lprng.com>.


Man(1) output converted with man2html