1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
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
|
