Return to 4.t CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / doc / smm / 06.lpd

Annotation of 43BSDReno/share/doc/smm/06.lpd/4.t, revision 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

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