1.ds VE LPRng-3.9.0 2.TH LPF 1 \*(VE "LPRng" 3.ig 4Thu Jul 20 07:19:29 PDT 1995 Patrick Powell 5.. 6.SH NAME 7lpf \- general printer filter 8.SH SYNOPSIS 9.B lpf 10.BI \-P printer 11.BI \-w width 12.BI \-l length 13.BI \-x width 14.BI \-y length 15[ 16.BI \-c 17] 18.BI \-K controlfilename 19.BI \-L bnrname 20[ 21.BI \-i indent 22] [ 23.BI \-Z options 24] [ 25.BI \-C class 26] [ 27.BI \-J job 28] [ 29.BI \-R accntname 30] 31.BI \-n login 32.BI \-h Host 33.BI \-F format 34[ 35.BI \-T [crlf,debug] 36.BI \-D level 37] [ 38affile 39] 40.SH DESCRIPTION 41.B Lpf 42is a general printer filter. Usually it is used as filter in the 43printcap file and is called by lpd. 44The -Tcrlf option will suppress translation of LF to CR/LF pairs. 45The -Tdebug option will increment the debug level. 46 47The following options passes lpd by default: 48.IP "\fB\-P\fIprinter\fR" 5 49The name of the printer. 50.IP "\fB\-w\fIwidth\fR" 5 51The page width in chars, as given in the :pw field in the printcap file 52.IP "\fB\-l\fIlength\fR" 5 53The page length in lines, as given in the :pl field in the printcap file 54.IP "\fB\-x\fIwidth\fR" 5 55The page width in pixels, as given in the :px field in the printcap file 56.IP "\fB\-y\fIlength\fR" 5 57The page length in pixels, as given in the :py field in the printcap file 58.IP "\fB\-K\fIcontrolfilename\fR" 5 59The name of the control file. 60.IP "\fB\-L\fIbnrname\fR" 5 61The banner name. 62This is set by the lpr -T option. 63.IP "\fB\-n\fIlogin\fR" 5 64The user login name. 65.IP "\fB\-h\fIHost\fR" 5 66The host where the job was submitted. 67.IP "\fB\-F\fIformat\fR" 5 68The job format from the lpr -F option or other option. 69.PP 70These options are optionally set by lpd: 71.IP "\fB\-Z\fIoptions\fR" 5 72Extra options. They are passed from the \fB\-Z\fR parameter given on 73the lpr command command line and can be interpreted by the filter. 74.PP 75These remaining options can be added 76to the filter entry in the printcap file: 77.IP "\fB\-c\fR" 5 78ignore control characters, set by lpr -b (binary) or -l (literal) options. 79.IP "\fB\-i\fIindent\fR" 5 80The indentation amount, set by lpr -i indent option. 81.IP "\fB\-C\fIclass\fR" 5 82The class name, set by lpr -C class option. 83.IP "\fB\-J\fIjob\fR" 5 84The job name, set by lpr -J job option. 85.IP "\fB\-R\fIaccntname\fR" 5 86The name of the accounting file, from printcap information. 87.IP "\fB\-D\fIlevel\fR" 5 88Sets debug level. The level must be an integer, a nonzero value 89switches debugging on. 90.IP "\fB\-T\fIcrlf\fR" 5 91Turn LF to CR/LF translation off. 92.IP "\fB\-T\fIdebug\fR" 5 93Increment the debug level. 94.SH "EXIT STATUS" 95.PP 96The following exit values are returned: 97.TP 15 98.B "zero (0)" 99Successful completion. 100.TP 101.B "non-zero (!=0)" 102An error occurred. 103.SH FILES 104.PP 105The files used by LPRng are set by values in the 106printer configuration file. 107The following are a commonly used set of default values. 108.nf 109.ta \w'/var/spool/lpd/printcap.<hostname> 'u 110_LPD_CONF_PATH_ LPRng configuration file 111${HOME}/.printcap user printer description file 112_PRINTCAP_PATH_ printer description file 113_LPD_PERMS_PATH_ permissions 114_LOCKFILE_ lock file for queue control 115/var/spool/lpd spool directories 116/var/spool/lpd/QUEUE/control queue control 117/var/spool/lpd/QUEUE/log trace or debug log file 118/var/spool/lpd/QUEUE/acct accounting file 119/var/spool/lpd/QUEUE/status status file 120.fi 121.SH "SEE ALSO" 122lpd.conf(5), 123lpc(8), 124lpd(8), 125lpr(1), 126lpq(1), 127lprm(1), 128printcap(5), 129lpd.perms(5), 130pr(1), lprng_certs(1), lprng_index_certs(1). 131.SH DIAGNOSTICS 132.nf 133Most of the diagnostics are self explanatory. 134If you are puzzled over the exact cause of failure, 135set the debugging level on (-D5) and run again. 136The debugging information will 137help you to pinpoint the exact cause of failure. 138.fi 139.SH "HISTORY" 140LPRng is a enhanced printer spooler system 141with functionality similar to the Berkeley LPR software. 142The LPRng mailing list is lprng@lprng.com; 143subscribe by sending mail to lprng-request@lprng.com with 144the word subscribe in the body. 145The software is available from ftp://ftp.lprng.com/pub/LPRng. 146.SH "AUTHOR" 147Patrick Powell <papowell@lprng.com>. 148