Return to 5.t CVS log

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

Annotation of 43BSDReno/share/doc/smm/06.lpd/5.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: .\"    @(#)5.t 6.5 (Berkeley) 3/7/89
        !            17: .\"
        !            18: .NH 1
        !            19: Output filter specifications
        !            20: .PP
        !            21: The filters supplied with 4.3BSD
        !            22: handle printing and accounting for most common
        !            23: line printers, the Benson-Varian, the wide (36") and
        !            24: narrow (11") Versatec printer/plotters. For other devices or accounting
        !            25: methods, it may be necessary to create a new filter.
        !            26: .PP
        !            27: Filters are spawned by \fIlpd\fP
        !            28: with their standard input the data to be printed, and standard output
        !            29: the printer.  The standard error is attached to the
        !            30: .B lf
        !            31: file for logging errors or \fIsyslogd\fP may be used for logging errors.
        !            32: A filter must return a 0 exit
        !            33: code if there were no errors, 1 if the job should be reprinted,
        !            34: and 2 if the job should be thrown away.
        !            35: When \fIlprm\fP
        !            36: sends a kill signal to the \fIlpd\fP process controlling
        !            37: printing, it sends a SIGINT signal 
        !            38: to all filters and descendents of filters.
        !            39: This signal can be trapped by filters that need
        !            40: to do cleanup operations such as
        !            41: deleting temporary files.
        !            42: .PP
        !            43: Arguments passed to a filter depend on its type.
        !            44: The
        !            45: .B of
        !            46: filter is called with the following arguments.
        !            47: .DS
        !            48: \fIfilter\fP \fB\-w\fPwidth \fB\-l\fPlength
        !            49: .DE
        !            50: The \fIwidth\fP and \fIlength\fP values come from the
        !            51: .B pw
        !            52: and
        !            53: .B pl
        !            54: entries in the printcap database.
        !            55: The
        !            56: .B if
        !            57: filter is passed the following parameters.
        !            58: .DS
        !            59: \fIfilter\fP [\|\fB\-c\fP\|] \fB\-w\fPwidth \fB\-l\fPlength \fB\-i\fPindent \fB\-n\fP login \fB\-h\fP host accounting_file
        !            60: .DE
        !            61: The
        !            62: .B \-c
        !            63: flag is optional, and only supplied when control characters
        !            64: are to be passed uninterpreted to the printer (when using the
        !            65: .B \-l
        !            66: option of
        !            67: .I lpr
        !            68: to print the file).
        !            69: The
        !            70: .B \-w
        !            71: and
        !            72: .B \-l
        !            73: parameters are the same as for the
        !            74: .B of
        !            75: filter.
        !            76: The
        !            77: .B \-n
        !            78: and
        !            79: .B \-h
        !            80: parameters specify the login name and host name of the job owner.
        !            81: The last argument is the name of the accounting file from
        !            82: .IR printcap .
        !            83: .PP
        !            84: All other filters are called with the following arguments:
        !            85: .DS
        !            86: \fIfilter\fP \fB\-x\fPwidth \fB\-y\fPlength \fB\-n\fP login \fB\-h\fP host accounting_file
        !            87: .DE
        !            88: The
        !            89: .B \-x
        !            90: and
        !            91: .B \-y
        !            92: options specify the horizontal and vertical page
        !            93: size in pixels (from the
        !            94: .B px
        !            95: and
        !            96: .B py
        !            97: entries in the printcap file).
        !            98: The rest of the arguments are the same as for the
        !            99: .B if
        !           100: filter.

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