Online Man Page

This form may be used to access the UNIX man pages. Note this form runs on a Solaris machine, so the results may disagree with other operating system implementations of the commands.

Topic:     Section:   Keyword search:

NAME

     lpr - submit print requests

SYNOPSIS

     /usr/ucb/lpr [-P destination] [-# number] [-C class]
         [-J job] [-T title] [-i [indent]]
         [-1 | -2 | -3 | -4 font] [-w cols] [-m] [-h] [-s]
         [-filter_option] [file]...

DESCRIPTION

     The lpr utility submits print requests to a destination. lpr
     prints files (file) and associated information, collectively
     called a print  request.  If  file  is  not  specified,  lpr
     assumes the standard input.

     The print client  commands  locate  destination  information
     using  the  "printers"  database in the name service switch.
     See nsswitch.conf(4), printers(4), and printers.conf(4)  for
     details.

     Print requests with more than 52 files  specified  is  trun-
     cated  to  52  files when the BSD print protocol is used for
     job submission.

OPTIONS

     The following options are supported:

     -C class

         Prints class as the job  classification  on  the  banner
         page of the output. Enclose class in double quotes if it
         contains blanks. If class is not specified, the name  of
         the  system  (as returned by hostname) is printed as the
         job classification. See hostname(1).

     -h

         Suppresses printing of the banner page of the output.

     -i indent

         Indents the output a specific number  of  SPACE  charac-
         ters. Use indent to indicate the number of SPACE charac-
         ters to  be  indented.  Specify  indent  as  a  positive
         integer.  If  the  optional  argument  to  indent is not
         specified, then eight SPACE characters is  the  default.
         The -i option is ignored unless it is specified with the
         -p filter option.

     -J job

         Prints job as the job name on the  banner  page  of  the
         output.  Enclose  job  in  double  quotes if it contains
         blanks. If job is not specified, file (or in the case of
         multiple  files, the first file specified on the command
         line) is printed as the job name on the banner  page  of
         the output.

     -m

         Sends mail after  file  has  printed.  See  mail(1).  By
         default,  no  mail  is  sent upon normal completion of a
         print request.

     -P destination

         Prints file on a specific printer or class  of  printers
         (see  lpadmin(1M)).  Specify  destination  using atomic,
         URI-style    (scheme://endpoint),     or     POSIX-style
         (server:destination)  names.  See  printers.conf(4)  for
         information regarding destination names.

     -s

         Prints files by reference rather than copying them. This
         means that files should not be modified or removed until
         they have completed printing. This option only  prevents
         copying  of  files  when the print queue is on the local
         machine and the files are specified on the command line.

     -T title

         Prints a title on the page header of the output. Enclose
         title  in  double  quotes  if it contains blanks. The -T
         option is ignored unless it is  specified  with  the  -p
         filter option.

     -w cols

         Prints file with pages of a specific width.  cols  indi-
         cates  the  number  of  columns  wide.  The -w option is
         ignored unless  it  is  specified  with  the  -p  filter
         option.

     -1|-2|-3|-4 font

         Mounts the specified font in the font position 1, 2,  3,
         or 4. Specify font as a valid font name.

     - filter_option

         Notifies the print spooler that file is not  a  standard
         text  file.  Enables  the  spooling  daemon  to  use the
         appropriate filters to print file.

         filter_options offer  a  standard  user  interface.  All
         filter options might not be available for, or applicable
         to, all printers.

         Specify filter_option as a single character.

         If filter_option is not specified and  the  printer  can
         interpret  PostScriptO,  inserting `%!' as the first two
         characters of file causes  file  to  be  interpreted  as
         PostScript.

         The following filter options are supported:

         c    file contains data produced by cifplot.

         d    file contains tex data in DVI format from Stanford.

         f    Interprets the first character of each  line  as  a
              standard FORTRAN carriage control character.

         g    file  contains  standard  plot  data  produced   by
              plot(1B) routines.

         l    Print control characters and suppress page breaks.

         n    file contains ditroff data from device  independent
              troff.

         p    Use pr to format the files. See pr(1).

         t    file contains troff  (cat  phototypesetter)  binary
              data.

         v    file contains a raster image. printer must  support
              an  appropriate imaging model such as PostScript in
              order to print the image.

     -# number

         Prints a specific number of copies. Specify number as  a
         positive integer. The default for number is 1.

OPERANDS

     The following operand is supported:

     file    The name of the file to be printed. Specify file  as
             a  pathname.  If file is not specified, lpr uses the
             standard input.

USAGE

     See largefile(5) for the description of the behavior of  lpr
     when  encountering  files greater than or equal to 2 Gbyte (
     2^31 bytes).

EXIT STATUS

     The following exit values are returned:

     0           Successful completion.

     non-zero    An error occurred.

FILES

     /etc/printers.conf      System printer  configuration  data-
                             base

     $HOME/.printers         User-configurable printer database

     ou=printers             LDAP version of /etc/printers.conf

     printers.conf.byname    NIS version of /etc/printers.conf

     printers.org_dir        NIS+ version of /etc/printers.conf

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWlpr_cmds                |
    |_____________________________|_____________________________|
    | Interface Stabilitly        | Standard                    |
    |_____________________________|_____________________________|
    | CSI                         | Enabled. See NOTES          |
    |_____________________________|_____________________________|

SEE ALSO

     hostname(1), lp(1), lpc(1B), lpq(1B),  lprm(1B),  lpstat(1),
     mail(1),    plot(1B),    pr(1),    troff(1),    lpadmin(1M),
     nsswitch.conf(4),  printers(4),   printers.conf(4),   attri-
     butes(5), largefile(5), standards(5)

DIAGNOSTICS

     lpr: destination |: unknown destination

         destination was not found in the LP configuration  data-
         base.  Usually this is a typing mistake; however, it can
         indicate that the destination does not exist on the sys-
         tem.  Use  lpstat  -p  to  display information about the
         status of the print service.

NOTES

     lpr is CSI-enabled except for the printer name.

     Print jobs are assumed to contain one  type  of  data.  That
     type  of  data  is  either  specified on the command line or
     autodetected (simple, PostScript) based on the  contents  of
     the first file in the job.

     When IPP is in use, the user is prompted for a passphrase if
     the  remote print service is configured to require authenti-
     cation.