NAME

lpr − print files off-line

USAGE

lpr [ options ] [ file(s) ]

DESCRIPTION

Lpr uses the spooling daemon lpd(8) to queue and print the named files when facilities become available.  If you don’t specify any files, lpr reads from the standard input, up to an end-of-file (EOF).  Normally, lpr sends the files to the default printer, or to the printer specified in the environment variable PRINTER, although there is an option that will force the output to a specific printer.  (See OPTIONS below.) 

OPTIONS

The following single letter 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 Assume that the files contain data from troff(1) (phototypesetter commands). 

−n Assume that the files contain data from device-independent troff. 

−d Assume that the files contain data from DVI (Stanford) format. 

−g Assume that the files contain standard plot data as produced by plot routines. 

−v Assume that the files contain a raster image for devices like the Benson Varian. 

−c Assume that the files contain data produced by cifplot. 

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

The remaining single letter options have the following meaning. 

−r Remove the file once it is spooled or once it is printed (with the −s option). 

−m Send mail once the file is spooled. 

−h Suppress the printing of the burst, or header, page. 

−s Use symbolic links.  Usually, files are copied to the spool directory.  The −s option uses symlink(2) to link files to the spooling directory, rather than copying them, so that large files can be printed.  This means that the files should not be modified or removed until after they have been printed. 

−Pprinter Force output to print on printer, rather than the default destination. 

−Cclass Use class as the job classification to print on the burst (or header) page.  The argument specified by class will replace the system name (the name returned by hostname(1)) on the burst page. 

−Jjob Print job as the name of the job on the header page, rather than the name of the first file printed. 

−Ttitle Make pr(1) print title instead of the file name on the header page. 

−#num Print num copies of the file(s), instead of only one. 

−icols Indent the output by cols number of blanks.  If cols is not specified, print eight (8) blank characters before each line of output. 

−wnum Set the page width for pr to num. 

−1234font Specify a font to be mounted on font positions 1 through 4.  The daemon will construct a .railmag file that references /usr/lib/vfont/name.size. 

NOTES

Fonts for troff and tex reside on the host with the printer. It is not currently possible to use local font libraries. 

DIAGNOSTICS

If you try to spool too large a file, it will be truncated.  Lpr does not print binary files.  It returns the message “lpr: filename is not an ascii file and is unprintable.” If spooling is disabled and a user other than “root” prints a file, lpr will print a message saying that spooling is disabled 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 about missing spool files may be printed in the daemon’s log file by lpd.  DOMAIN/IX lpr operates over a TCP/IP connection; diagnostics dealing with sockets and other communications problems may mean that TCP/IP is not running, or has not been configured properly.  See Appendix J to the DOMAIN/IX User’s Guide for details about configuring TCP/IP under DOMAIN/IX, and Appendix K to the DOMAIN/IX User’s Guide for details about Line Printer System Management. 
 

FILES

/etc/passwd personal identification

/etc/printcap printer capabilities data base

/usr/lib/lpd* line printer daemons

/usr/spool/lpd/* directories used for spooling

/usr/spool/lpd/*/cf* daemon control files

/usr/spool/lpd/*/df* data files specified in “cf” files

/usr/spool/lpd/*/tf* temporary copies of “cf” files

RELATED INFORMATION

lpq(1) lprm(1) pr(1) symlink(2) printcap(5) lpc(8) lpd(8) rc(8)