Debian Codegraph @

upstream/debian-unstable/man1/lpf.1

raw
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