lpr(1)                              CLIX                              lpr(1)



  NAME

    lpr - Prints files

  SYNOPSIS

    lpr [-P printer] [-# num] [-C class] [-J job] [-T title] [-i [numcols]]
    [-w num] [-pltngvfrmhs] [name ... ]

  FLAGS

    -p             Use pr to format the files.

    -l             Use a filter that allows control characters to be printed
                   and suppresses page breaks.

    -t             The files are assumed to contain data from troff (cat
                   phototypesetter commands).

    -n             The files are assumed to contain data from ditroff
                   (device-independent troff).

    -g             The files are assumed to contain standard plot data as
                   produced by the plot routines.

    -v             The files are assumed to contain a raster image for devices
                   like the Benson® Varian.

    -f             Use a filter that interprets the first character of each
                   line as a standard FORTRAN carriage control character.

    -r             Remove the file when spooling or printing (with the -s
                   flag) is complete.

    -m             Send mail on completion.

    -h             Suppress the printing of the burst page.

    -s             Uses symbolic links to link data files rather than trying
                   to copy them so that large files can be printed.  This
                   means the files should not be modified or removed until
                   they have been printed.

    -C class       Uses the argument that follows it as a job classification
                   to use on the burst page.  For example,

                   lpr -C EECS foo.c

                   causes the system name (the name returned by hostname) to
                   be replaced on the burst page by EECS and the file foo.c to
                   be printed.



  2/94 - Intergraph Corporation                                              1

  lpr(1)                              CLIX                              lpr(1)



    -J job         Uses the argument that follows it as the job name that is
                   printed on the burst page.  Normally, the first file's name
                   is used.

    -T title       Uses the argument that follows it as the title used by pr
                   in place of the filename.

    -# num         Prints multiple copies of output, where num is the number
                   of copies for each file named.  For example,

                   lpr -#3 foo.c bar.c more.c

                   would result in three copies of the foo.c file, followed by
                   three copies of the bar.c file, and so on.  On the other
                   hand,

                   cat foo.c bar.c more.c | lpr -#3

                   will give three copies of the concatenation of the files.

    -i [numcols]   Indents the output.  If the next argument is numeric, it is
                   used as the number of blanks to be printed before each
                   line; otherwise, eight characters are printed.

    -w num         Takes num to be the page width for pr.

    -P printer     Used to force output to a specific printer.

  DESCRIPTION

    The lpr command uses a spooling daemon to print the named files when
    facilities become available.  If no names appear, stdin is assumed.
    Normally, the default printer is used (site dependent), or the value of
    the environment variable $PRINTER is used.

  EXAMPLES

    1.  To print two copies of the foo file on the printer laser1 with the
        page title of report1, enter the following:

        lpr -P laser -T report1 -#2 foo


    2.  To print the troff file foo.t with kiick on the burst page, enter the
        following:

        lpr -t -J "kiick" -m foo.t


    3.  To print the foo.c file, using pagination and indentation on a page 50
        characters wide, enter the following:



  2                                              Intergraph Corporation - 2/94

  lpr(1)                              CLIX                              lpr(1)



        lpr -p -i -w 50 foo.c


  FILES

    /etc/passwd
           Personal identification

    /etc/printcap
           Printer capabilities database

    /usr/lib/lpd*
           Line printer daemons

    /usr/spool/*
           Directories used for spooling

    /usr/spool/*/cf*
           Daemon control files

    /usr/spool/*/df*
           Data files specified in ``cf'' files

    /usr/spool/*/tf*
           Temporary copies of ``cf'' files

  NOTES

    The lpr command truncates files that are too large.  Fonts for troff and
    TeX are on the host with the printer.  It is not currently possible to use
    local font libraries.

  DIAGNOSTICS

    The lpr command will object to printing binary files.

    If a user other than the superuser prints a file and spooling is disabled,
    lpr will print a message saying so and will not put jobs in the queue.

    If a connection to lpd on the local machine cannot be made, lpr will say
    that the daemon cannot be started.

    Diagnostics may be printed in the daemon's log file regarding missing
    spool files by lpd.

  EXIT VALUES

    The lpr command exits with a value of 0 if the job is successfully spooled
    and a value of 1 if the job is not successfully spooled.

  RELATED INFORMATION



  2/94 - Intergraph Corporation                                              3

  lpr(1)                              CLIX                              lpr(1)



    Commands: lpq(1), lprm(1), lpc(1) lpd(1), lpc(8), pr(1), lpd(8)

    Functions: symlink(2)

    Files: printcap(4)

















































  4                                              Intergraph Corporation - 2/94