lpr(1) lpr(1)
NAME
lpr - off line print
SYNOPSIS
lpr [-Pprinter] [-#num] [-Cclass] [-Jjob] [-Ttitle]
[-i[numcols]] [-1234font] [-wnum] [-pltndgvcfrmhs] [name...]
DESCRIPTION
lpr uses a spooling daemon to print the named files when
facilities become available. If no names appear, the
standard input is assumed. The -P flag option may be used
to force output to a specific printer. Normally, the
default printer is used (site-dependent), or the value of
the environment variable PRINTER is used.
The following flag options are used to notify the line
printer spooler that the files are not standard text files
(the spooling daemon will use the appropriate filters to
print the data accordingly):
-p Use pr(1) to format the files (equivalent to print).
-l Use a filter which allows control characters to be
printed and suppresses page breaks.
-t The files are assumed to contain data from otroff(1).
-n The files are assumed to contain data from troff(1).
-d The files are assumed to contain data from tex(l) (DVI
format from Stanford).
-g The files are assumed to contain standard plot data as
produced by the plot(3X) routines (see also plot(1G)
for the filters used by the printer spooler).
-v The files are assumed to contain a raster image for
devices like the Benson Varian.
-c The files are assumed to contain data produced by
cifplot(l).
-f Use a filter which interprets the first character of
each line as a standard FORTRAN carriage control
character.
The remaining flag options have the following meaning:
-r Remove the file upon completion of spooling or upon
completion of printing (with the -s flag option).
-m Send mail upon completion.
Page 1 (last mod. 1/20/87)
lpr(1) lpr(1)
-h Suppress the printing of the burst page.
-s Use symbolic links. Usually files are copied to the
spool directory.
The -C flag option takes the following argument as a job
classification for use on the burst page. For example,
lpr -C EECS foo.c
causes the system name (the name returned by hostname(1)) to
be replaced on the burst page by EECS, and the file foo.c to
be printed.
The -J flag option takes the following argument as the job
name to print on the burst page. Normally, the first file's
name is used.
The -T flag option uses the next argument as the title used
by pr(1) instead of the filename.
To get multiple copies of output, use the -#num flag option,
where num is the number of copies desired of each file
named. For example,
lpr -#3 foo.c bar.c more.c
would result in 3 copies of the file foo.c, followed by 3
copies of the file bar.c, etc. On the other hand,
cat foo.c bar.c more.c | lpr -#3
will give three copies of the concatenation of the files.
The -i flag option causes the output to be indented. If the
next argument is numeric, it is used as the number of blanks
to be printed before each line; otherwise, 8 characters are
printed.
The -w flag option takes the immediately following number to
be the page width for pr.
The -s flag option will use symlink(2) to link data files,
rather than trying to copy them, so large files can be
printed. This means the files should not be modified or
removed until they have been printed.
The flag option -1234 specifies a font to be mounted on font
position i. The daemon will construct a .railmag file
referencing /usr/lib/vfont/name.size.
FILES
Page 2 (last mod. 1/20/87)
lpr(1) lpr(1)
/usr/ucb/lpr
SEE ALSO
lpq(1), lprm(1), pr(1), symlink(2).
DIAGNOSTICS
If you try to spool too large a file, it will be truncated.
lpr will object to printing binary files.
If a user other than root 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.
NOTES
lpr is a BSD command useful with many output devices. lp(1)
performs a parallel function, but is nevertheless a distinct
command.
BUGS
Fonts for troff and tex reside on the host with the printer.
It is not currently possible to use local font libraries.
Page 3 (last mod. 1/20/87)