Annotation of 43BSDTahoe/man/man1/lpr.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)lpr.1       6.1 (Berkeley) 4/29/85
                      6: .\"
                      7: .TH LPR 1 "April 29, 1985"
                      8: .UC 4
                      9: .SH NAME
                     10: lpr \- off line print
                     11: .SH SYNOPSIS
                     12: .B lpr
                     13: [
                     14: .BI \-P printer
                     15: ] [
                     16: .BI \-# num
                     17: ] [
                     18: .B \-C
                     19: .I class
                     20: ] [
                     21: .B \-J
                     22: .I job
                     23: ] [
                     24: .B \-T
                     25: .I title
                     26: ] [
                     27: .B \-i
                     28: [
                     29: .I numcols
                     30: ]] [
                     31: .B \-1234
                     32: .I font
                     33: ] [
                     34: .BI \-w num
                     35: ] [
                     36: .B \-pltndgvcfrmhs
                     37: ] [
                     38: name ...
                     39: ]
                     40: .SH DESCRIPTION
                     41: .B Lpr
                     42: uses a spooling daemon to print the named files when facilities
                     43: become available.  If no names appear, the standard input is assumed.
                     44: The
                     45: .B \-P
                     46: option may be used to force output to a specific printer.  Normally,
                     47: the default printer is used (site dependent), or the value of the
                     48: environment variable PRINTER is used.
                     49: .PP
                     50: The following single letter options are used to notify the line printer
                     51: spooler that the files are not standard text files. The spooling daemon will
                     52: use the appropriate filters to print the data accordingly.
                     53: .IP \fB\-p\fP 5
                     54: Use
                     55: .IR pr (1)
                     56: to format the files (equivalent to
                     57: .IR print ).
                     58: .IP \fB\-l\fP 5
                     59: Use a filter which allows control characters to be printed and suppresses
                     60: page breaks.
                     61: .IP \fB\-t\fP 5
                     62: The files are assumed to contain data from
                     63: .IR troff (1)
                     64: (cat phototypesetter commands).
                     65: .IP \fB\-n\fP 5
                     66: The files are assumed to contain data from
                     67: .I ditroff
                     68: (device independent troff).
                     69: .IP \fB\-d\fP 5
                     70: The files are assumed to contain data from
                     71: .IR tex (l)
                     72: (DVI format from Stanford).
                     73: .IP \fB\-g\fP 5
                     74: The files are assumed to contain standard plot data as produced by the
                     75: .IR plot (3X)
                     76: routines (see also
                     77: .IR plot (1G)
                     78: for the filters used by the printer spooler).
                     79: .IP \fB\-v\fP 5
                     80: The files are assumed to contain a raster image for devices like the
                     81: Benson Varian.
                     82: .IP \fB\-c\fP 5
                     83: The files are assumed to contain data produced by
                     84: .IR cifplot (l).
                     85: .IP \fB\-f\fP 5
                     86: Use a filter which interprets the first character of each line as a
                     87: standard FORTRAN carriage control character.
                     88: .PP
                     89: The remaining single letter options have the following meaning.
                     90: .IP \fB\-r\fP 5
                     91: Remove the file upon completion of spooling or upon completion of
                     92: printing (with the \fB\-s\fP option).
                     93: .IP \fB\-m\fP 5
                     94: Send mail upon completion.
                     95: .IP \fB\-h\fP 5
                     96: Suppress the printing of the burst page.
                     97: .IP \fB\-s\fP 5
                     98: Use symbolic links.  Usually files are copied to the spool directory.
                     99: .PP 
                    100: The
                    101: .B \-C
                    102: option takes the following argument as a job classification
                    103: for use on the burst page.  For example,
                    104: .PP
                    105: .ti +0.5i
                    106: lpr \-C EECS foo.c
                    107: .PP
                    108: causes the system name (the name returned by
                    109: .IR hostname (1))
                    110: to be replaced on the burst page by EECS,
                    111: and the file foo.c to be printed.
                    112: .PP
                    113: The
                    114: .B \-J
                    115: option takes the following argument as the job name to print on the burst page.
                    116: Normally, the first file's name is used.
                    117: .PP
                    118: The
                    119: .B \-T
                    120: option uses the next argument as the title used by
                    121: .IR pr (1)
                    122: instead of the file name.
                    123: .PP
                    124: To get multiple copies of output, use the
                    125: .BI \-# num
                    126: option,
                    127: where
                    128: .I num
                    129: is the number of copies desired of each file named.  For example,
                    130: .PP
                    131: .ti +0.5i
                    132: lpr \-#3 foo.c bar.c more.c
                    133: .PP
                    134: would result in 3 copies of the file foo.c, followed by 3 copies
                    135: of the file bar.c, etc.  On the other hand, 
                    136: .PP
                    137: .ti +0.5i
                    138: cat foo.c bar.c more.c | lpr \-#3
                    139: .PP
                    140: will give three copies of the concatenation of the files.
                    141: .PP
                    142: The
                    143: .B \-i
                    144: option causes the output to be indented. If the next argument
                    145: is numeric, it is used as the number of blanks to be printed before each
                    146: line; otherwise, 8 characters are printed.
                    147: .PP
                    148: The
                    149: .B \-w
                    150: option takes the immediately following number to be
                    151: the page width for
                    152: .IR pr .
                    153: .PP
                    154: The
                    155: .B \-s
                    156: option will use
                    157: .IR symlink (2)
                    158: to link data files rather than trying to copy them so large files can be
                    159: printed.  This means the files should
                    160: not be modified or removed until they have been printed.
                    161: .PP
                    162: The option
                    163: .B \-1234
                    164: Specifies a font to be mounted on font position \fIi\fR.  The daemon
                    165: will construct a \fI.railmag\fR file referencing
                    166: \fI/usr/lib/vfont/name.size\fR.
                    167: .SH FILES
                    168: .nf
                    169: .ta \w'/usr/spool/*/cf*       'u
                    170: /etc/passwd    personal identification
                    171: /etc/printcap  printer capabilities data base
                    172: /usr/lib/lpd*  line printer daemons
                    173: /usr/spool/*   directories used for spooling
                    174: /usr/spool/*/cf*       daemon control files
                    175: /usr/spool/*/df*       data files specified in "cf" files
                    176: /usr/spool/*/tf*       temporary copies of "cf" files
                    177: .fi
                    178: .SH "SEE ALSO"
                    179: lpq(1),
                    180: lprm(1),
                    181: pr(1),
                    182: symlink(2),
                    183: printcap(5),
                    184: lpc(8),
                    185: lpd(8)
                    186: .SH DIAGNOSTICS
                    187: If you try to spool too large a file, it will be truncated.
                    188: .I Lpr
                    189: will object to printing binary files.
                    190: If a user other than root prints a file and spooling is disabled,
                    191: .I lpr
                    192: will print a message saying so and will not put jobs in the queue.
                    193: If a connection to
                    194: .I lpd
                    195: on the local machine cannot be made,
                    196: .I lpr
                    197: will say that the daemon cannot be started.
                    198: Diagnostics may be printed in the daemon's log file
                    199: regarding missing spool files by
                    200: .IR lpd .
                    201: .SH BUGS
                    202: Fonts for
                    203: .I troff
                    204: and
                    205: .I tex
                    206: reside on the host with the printer. It is currently not possible to
                    207: use local font libraries.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.