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