Annotation of cci/usr/src/man/man1/lpr.1, revision 1.1.1.1

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