Annotation of 43BSDReno/share/doc/smm/06.lpd/4.t, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted
                      5: .\" provided that the above copyright notice and this paragraph are
                      6: .\" duplicated in all such forms and that any documentation,
                      7: .\" advertising materials, and other materials related to such
                      8: .\" distribution and use acknowledge that the software was developed
                      9: .\" by the University of California, Berkeley.  The name of the
                     10: .\" University may not be used to endorse or promote products derived
                     11: .\" from this software without specific prior written permission.
                     12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
                     13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
                     14: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     15: .\"
                     16: .\"    @(#)4.t 6.5 (Berkeley) 3/7/89
                     17: .\"
                     18: .NH 1
                     19: Setting up
                     20: .PP
                     21: The 4.3BSD release comes with the necessary programs 
                     22: installed and with the default line printer queue
                     23: created.  If the system must be modified, the
                     24: makefile in the directory /usr/src/usr.lib/lpr
                     25: should be used in recompiling and reinstalling
                     26: the necessary programs.
                     27: .PP
                     28: The real work in setting up is to create the
                     29: .I printcap
                     30: file and any printer filters for printers not supported
                     31: in the distribution system.
                     32: .NH 2
                     33: Creating a printcap file
                     34: .PP
                     35: The 
                     36: .I printcap
                     37: database contains one or more entries per printer.
                     38: A printer should have a separate spooling directory;
                     39: otherwise, jobs will be printed on
                     40: different printers depending on which printer daemon starts first.
                     41: This section describes how to create entries for printers that do not
                     42: conform to the default printer description (an LP-11 style interface to a
                     43: standard, band printer).
                     44: .NH 3
                     45: Printers on serial lines
                     46: .PP
                     47: When a printer is connected via a serial communication line
                     48: it must have the proper baud rate and terminal modes set.
                     49: The following example is for a DecWriter III printer connected
                     50: locally via a 1200 baud serial line.
                     51: .DS
                     52: .DT
                     53: lp|LA-180 DecWriter III:\e
                     54:        :lp=/dev/lp:br#1200:fs#06320:\e
                     55:        :tr=\ef:of=/usr/lib/lpf:lf=/usr/adm/lpd-errs:
                     56: .DE
                     57: The
                     58: .B lp
                     59: entry specifies the file name to open for output. Here it could
                     60: be left out since ``/dev/lp'' is the default.
                     61: The
                     62: .B br
                     63: entry sets the baud rate for the tty line and the
                     64: .B fs
                     65: entry sets CRMOD, no parity, and XTABS (see \fItty\fP\|(4)).
                     66: The
                     67: .B tr
                     68: entry indicates that a form-feed should be printed when the queue
                     69: empties so the paper can be torn off without turning the printer off-line and
                     70: pressing form feed.
                     71: The
                     72: .B of
                     73: entry specifies the filter program
                     74: .I lpf
                     75: should be used for printing the files;
                     76: more will be said about filters later.
                     77: The last entry causes errors
                     78: to be written to the file ``/usr/adm/lpd-errs''
                     79: instead of the console.  Most errors from \fIlpd\fP are logged using
                     80: \fIsyslogd\fP\|(8) and will not be logged in the specified file.  The
                     81: filters should use \fIsyslogd\fP to report errors; only those that
                     82: write to standard error output will end up with errors in the \fBlf\fP file.
                     83: (Occasionally errors sent to standard error output have not appeared
                     84: in the log file; the use of \fIsyslogd\fP is highly recommended.)
                     85: .NH 3
                     86: Remote printers
                     87: .PP
                     88: Printers that reside on remote hosts should have an empty
                     89: .B lp
                     90: entry.
                     91: For example, the following printcap entry would send output to the printer
                     92: named ``lp'' on the machine ``ucbvax''.
                     93: .DS
                     94: .DT
                     95: lp|default line printer:\e
                     96:        :lp=:rm=ucbvax:rp=lp:sd=/usr/spool/vaxlpd:
                     97: .DE
                     98: The
                     99: .B rm
                    100: entry is the name of the remote machine to connect to; this name must
                    101: be a known host name for a machine on the network.
                    102: The
                    103: .B rp
                    104: capability indicates
                    105: the name of the printer on the remote machine is ``lp'';
                    106: here it could be left out since this is the default value.
                    107: The
                    108: .B sd
                    109: entry specifies ``/usr/spool/vaxlpd''
                    110: as the spooling directory instead of the
                    111: default value of ``/usr/spool/lpd''.
                    112: .NH 2
                    113: Output filters
                    114: .PP
                    115: Filters are used to handle device dependencies and to
                    116: do accounting functions.  The output filtering of
                    117: .B of
                    118: is used when accounting is
                    119: not being done or when all text data must be passed through a filter.
                    120: It is not intended to do accounting since it is started only once,
                    121: all text files are filtered through it, and no provision is made for passing
                    122: owners' login name, identifying the beginning and ending of jobs, etc.
                    123: The other filters (if specified) are started for each file
                    124: printed and do accounting if there is an
                    125: .B af
                    126: entry.
                    127: If entries for both
                    128: .B of
                    129: and other filters are specified,
                    130: the output filter is used only to print the banner page;
                    131: it is then stopped to allow other filters access to the printer.
                    132: An example of a printer that requires output filters
                    133: is the Benson-Varian.
                    134: .DS
                    135: .DT
                    136: va|varian|Benson-Varian:\e
                    137:        :lp=/dev/va0:sd=/usr/spool/vad:of=/usr/lib/vpf:\e
                    138:        :tf=/usr/lib/rvcat:mx#2000:pl#58:px=2112:py=1700:tr=\ef:
                    139: .DE
                    140: The
                    141: .B tf
                    142: entry specifies ``/usr/lib/rvcat'' as the filter to be
                    143: used in printing \fItroff\fP\|(1) output.
                    144: This filter is needed to set the device into print mode
                    145: for text, and plot mode for printing
                    146: .I troff
                    147: files and raster images (see \fIva\fP\|(4V)).
                    148: Note that the page length is set to 58 lines by the
                    149: .B pl
                    150: entry for 8.5" by 11" fan-fold paper.
                    151: To enable accounting, the varian entry would be
                    152: augmented with an
                    153: .B af
                    154: filter as shown below.
                    155: .DS
                    156: .DT
                    157: va|varian|Benson-Varian:\e
                    158:        :lp=/dev/va0:sd=/usr/spool/vad:of=/usr/lib/vpf:\e
                    159:        :if=/usr/lib/vpf:tf=/usr/lib/rvcat:af=/usr/adm/vaacct:\e
                    160:        :mx#2000:pl#58:px=2112:py=1700:tr=\ef:
                    161: .DE
                    162: .NH 2
                    163: Access Control
                    164: .PP
                    165: Local access to printer queues is controlled with the
                    166: .B rg
                    167: printcap entry.
                    168: .DS
                    169:        :rg=lprgroup:
                    170: .DE
                    171: Users must be in the group
                    172: .I lprgroup
                    173: to submit jobs to the specified printer.
                    174: The default is to allow all users access.
                    175: Note that once the files are in the local queue, they can be printed
                    176: locally or forwarded to another host depending on the configuration.
                    177: .PP
                    178: Remote access is controlled by listing the hosts in either the file
                    179: /etc/hosts.equiv or /etc/hosts.lpd, one host per line. Note that
                    180: .IR rsh (1)
                    181: and
                    182: .IR rlogin (1)
                    183: use /etc/hosts.equiv to determine which hosts are equivalent for allowing logins
                    184: without passwords. The file /etc/hosts.lpd is only used to control
                    185: which hosts have line printer access.
                    186: Remote access can be further restricted to only allow remote users with accounts
                    187: on the local host to print jobs by using the \fBrs\fP printcap entry.
                    188: .DS
                    189:        :rs:
                    190: .DE

unix.superglobalmegacorp.com

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