diff options
Diffstat (limited to 'upstream/debian-unstable/man1/lpf.1')
| -rw-r--r-- | upstream/debian-unstable/man1/lpf.1 | 149 |
1 files changed, 149 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man1/lpf.1 b/upstream/debian-unstable/man1/lpf.1 new file mode 100644 index 00000000..dae94ecd --- /dev/null +++ b/upstream/debian-unstable/man1/lpf.1 @@ -0,0 +1,149 @@ +.TH LPF 1 2006-12-09 "LPRng" "lpf filter" +.SH NAME +lpf \- general printer filter +.SH SYNOPSIS +.B lpf +.BI \-P printer +.BI \-w width +.BI \-l length +.BI \-x width +.BI \-y length +[ +.BI \-c +] +.BI \-K controlfilename +.BI \-L bnrname +[ +.BI \-i indent +] [ +.BI \-Z options +] [ +.BI \-C class +] [ +.BI \-J job +] [ +.BI \-R accntname +] +.BI \-n login +.BI \-h Host +.BI \-F format +[ +.BI \-T [crlf,debug] +.BI \-D level +] [ +affile +] +.SH DESCRIPTION +.B Lpf +is a general printer filter. Usually it is used as filter in the +printcap file and is called by lpd. +The -Tcrlf option will suppress translation of LF to CR/LF pairs. +The -Tdebug option will increment the debug level. + +The following options passes lpd by default: +.IP "\fB\-P\fIprinter\fR" 5 +The name of the printer. +.IP "\fB\-w\fIwidth\fR" 5 +The page width in chars, as given in the :pw field in the printcap file +.IP "\fB\-l\fIlength\fR" 5 +The page length in lines, as given in the :pl field in the printcap file +.IP "\fB\-x\fIwidth\fR" 5 +The page width in pixels, as given in the :px field in the printcap file +.IP "\fB\-y\fIlength\fR" 5 +The page length in pixels, as given in the :py field in the printcap file +.IP "\fB\-K\fIcontrolfilename\fR" 5 +The name of the control file. +.IP "\fB\-L\fIbnrname\fR" 5 +The banner name. +This is set by the lpr -T option. +.IP "\fB\-n\fIlogin\fR" 5 +The user login name. +.IP "\fB\-h\fIHost\fR" 5 +The host where the job was submitted. +.IP "\fB\-F\fIformat\fR" 5 +The job format from the lpr -F option or other option. +.PP +These options are optionally set by lpd: +.IP "\fB\-Z\fIoptions\fR" 5 +Extra options. They are passed from the \fB\-Z\fR parameter given on +the lpr command command line and can be interpreted by the filter. +.PP +These remaining options can be added +to the filter entry in the printcap file: +.IP "\fB\-c\fR" 5 +ignore control characters, set by lpr -b (binary) or -l (literal) options. +.IP "\fB\-i\fIindent\fR" 5 +The indentation amount, set by lpr -i indent option. +.IP "\fB\-C\fIclass\fR" 5 +The class name, set by lpr -C class option. +.IP "\fB\-J\fIjob\fR" 5 +The job name, set by lpr -J job option. +.IP "\fB\-R\fIaccntname\fR" 5 +The name of the accounting file, from printcap information. +.IP "\fB\-D\fIlevel\fR" 5 +Sets debug level. The level must be an integer, a nonzero value +switches debugging on. +.IP "\fB\-T\fIcrlf\fR" 5 +Turn LF to CR/LF translation off. +.IP "\fB\-T\fIdebug\fR" 5 +Increment the debug level. +.SH "EXIT STATUS" +.PP +The following exit values are returned: +.TP 15 +.B "zero (0)" +Successful completion. +.TP +.B "non-zero (!=0)" +An error occurred. +.SH FILES +.PP +The files used by LPRng are set by values in the +printer configuration file. +The following are a commonly used set of default values. +.nf +.ta \w'/var/spool/lpd/printcap.<hostname> 'u +/etc/lprng/lpd.conf LPRng configuration file +${HOME}/.printcap user printer description file +/etc/printcap printer description file +/etc/lprng/lpd.perms permissions +/var/run/lprng/lpd lock file for queue control +/var/spool/lpd spool directories +/var/spool/lpd/QUEUE/control queue control +/var/spool/lpd/QUEUE/log trace or debug log file +/var/spool/lpd/QUEUE/acct accounting file +/var/spool/lpd/QUEUE/status status file +.fi +.SH "SEE ALSO" +lpd.conf(5), +lpc(8), +lpd(8), +lpr(1), +lpq(1), +lprm(1), +printcap(5), +lpd.perms(5), +pr(1), lprng_certs(1), lprng_index_certs(1). +.SH "AUTHOR" +Patrick Powell <papowell@lprng.com>. +.SH DIAGNOSTICS +Most of the diagnostics are self explanatory. +If you are puzzled over the exact cause of failure, +set the debugging level on (-D5) and run again. +The debugging information will +help you to pinpoint the exact cause of failure. +.SH "HISTORY" +LPRng is a enhanced printer spooler system +with functionality similar to the Berkeley LPR software. +The LPRng developer mailing list is lprng-devel@lists.sourceforge.net; +subscribe by visiting +.B https://lists.sourceforge.net/lists/listinfo/lprng-devel +or sending mail to +.B lprng-request@lists.sourceforge.net +with +the word +.I subscribe +in the body. +.br +The software is available via +.B http://lprng.sourceforge.net |