| 1 |
.ds VE LPRng-3.9.0 |
| 2 |
.TH LPD.CONF 5 \*(VE "LPRng" |
| 3 |
.SH NAME |
| 4 |
.nf |
| 5 |
lpd.conf \- configuration file for the LPRng line printer spooler system |
| 6 |
.fi |
| 7 |
.SH DESCRIPTION |
| 8 |
The file \fBlpd.conf\fR is used to provide configuration information for |
| 9 |
the LPRng Printer spooler system and defaults for printcap information. |
| 10 |
Leading spaces on lines are ignored, |
| 11 |
and blank lines and lines whose first nonblank character is a sharp |
| 12 |
(``#'') are ignored. |
| 13 |
Trailing blanks and tabs (whitespace) for an option value |
| 14 |
are deleted unless the last one is escaped with a backslash |
| 15 |
(``\\''). |
| 16 |
All other lines |
| 17 |
specify parameters and should be of the following form: |
| 18 |
.RS |
| 19 |
.nf |
| 20 |
keyword |
| 21 |
keyword@ |
| 22 |
keyword#value |
| 23 |
keyword=value |
| 24 |
.RE |
| 25 |
.fi |
| 26 |
Note that these values are the same format as |
| 27 |
.BR printcap (5) |
| 28 |
values. |
| 29 |
Values in the configuration can contain |
| 30 |
host or machine dependent information; |
| 31 |
to assist with this, |
| 32 |
the following |
| 33 |
.I "escape sequences" |
| 34 |
in the configuration information are |
| 35 |
replaced as follows: |
| 36 |
.TP |
| 37 |
\fB%h\fR |
| 38 |
the short form |
| 39 |
of the host name |
| 40 |
(i.e.- non fully qualified). |
| 41 |
.TP |
| 42 |
\fB%H\fR |
| 43 |
the fully qualified host name. |
| 44 |
.TP |
| 45 |
\fB%a\fR |
| 46 |
the abbreviated architecture name, |
| 47 |
\fIsun4\fR, \fIsol2\fR, \fIhpux\fR, \fIaix\fR, \fIirix5\fR, etc. |
| 48 |
This value can be set using the \fBarchitecture\fR |
| 49 |
keyword in the configuration file and is set to a |
| 50 |
default value at compile_time. |
| 51 |
.TP |
| 52 |
\fB%P\fR |
| 53 |
the printer name from the printcap entry |
| 54 |
(see below). |
| 55 |
.TP |
| 56 |
\fB%R\fR |
| 57 |
the remote printer name from the printcap entry. |
| 58 |
.TP |
| 59 |
\fB%M\fR |
| 60 |
the remote host name from the printcap entry. |
| 61 |
This is truncated to the short host name. |
| 62 |
.PP |
| 63 |
For example, |
| 64 |
on host |
| 65 |
.I dickory.sdsu.edu, |
| 66 |
the strings |
| 67 |
.I "short=\fB%h\fR" |
| 68 |
.I "long=\fB%H\fR" |
| 69 |
.I "arch=\fB%a\fR" |
| 70 |
would be expanded as |
| 71 |
.I "short=dickory" |
| 72 |
.I "long=dickory.sdsu.edu" |
| 73 |
.I "arch=sun4" . |
| 74 |
.PP |
| 75 |
The P, R, and M tags are provided for use with combined |
| 76 |
configuration and printcap information. |
| 77 |
These values are not expanded when the printcap information is |
| 78 |
initially processed, |
| 79 |
and can be used only in a limited number of printcap or |
| 80 |
other entries. |
| 81 |
Currently only the |
| 82 |
printcap :sd: (spool directory) |
| 83 |
and :forward_server: (forward server) entries use these. |
| 84 |
.PP |
| 85 |
.SH "GENERAL CONFIGURATION PARAMETERS" |
| 86 |
.PP |
| 87 |
Some of the following parameters take lists of files or directories. |
| 88 |
Unless otherwise explicitly stated, |
| 89 |
these lists can be separated by commas (,), |
| 90 |
semicolons (;), or colons, (punctuation) |
| 91 |
and possibly tabs or spaces (whitespace) as well. |
| 92 |
.PP |
| 93 |
Keyword names can use either underscores (_) or hyphens (-) |
| 94 |
in their names, |
| 95 |
but the underscore is preferred. |
| 96 |
.TP |
| 97 |
\fBinclude\fR pathname [pathname*] (no default) |
| 98 |
This can be used to include files into |
| 99 |
the \fBlpd.conf\fR file. |
| 100 |
The include file parameter a whitespace separated |
| 101 |
list of files; the files must have absolute pathnames and must |
| 102 |
be readable. |
| 103 |
.TP |
| 104 |
\fBae\fR (default: "jobend $H $n $P $k $b $t") |
| 105 |
This specifies either a script or a filter to be invoked |
| 106 |
at the send of a job for accounting purposes. |
| 107 |
See \fBas\fP for the matching accounting at start, |
| 108 |
and the |
| 109 |
.BR printcap (5) |
| 110 |
and |
| 111 |
.BR lpd (8) |
| 112 |
man pages for details. |
| 113 |
.TP |
| 114 |
\fBallow_getenv\fR (default: "LPD_CONF") |
| 115 |
This option specifies an environment variable |
| 116 |
whose value is a configuration file. |
| 117 |
Use of this is restricted to test purposes, |
| 118 |
and SUID ROOT client and server will not run when the variable is enabled. |
| 119 |
.TP |
| 120 |
\fBar\fR (default: yes) |
| 121 |
See |
| 122 |
.BR printcap (5) |
| 123 |
for details. |
| 124 |
.TP |
| 125 |
\fBarchitecture\fR |
| 126 |
The default value is set at compile time and can be |
| 127 |
overwritten with this parameter. |
| 128 |
The default value of this parameter is set at compile time |
| 129 |
and it is used when |
| 130 |
expanding the special sequence \fB%a\fR in |
| 131 |
pathname and filename strings in this config file. |
| 132 |
.TP |
| 133 |
\fBauth\fR (default: NULL) |
| 134 |
Authentication type to be used for client to server communication. |
| 135 |
.TP |
| 136 |
\fBauth_client_filter\fR (default: NULL) |
| 137 |
Program to be used for client to server communication. |
| 138 |
.TP |
| 139 |
\fBauth_forward\fR (default: NULL) |
| 140 |
Authentication type to be used for server to server communication. |
| 141 |
.TP |
| 142 |
\fBauth_forward_filter\fR (default: NULL) |
| 143 |
Program to be used for server to server communication. |
| 144 |
.TP |
| 145 |
\fBauth_forward_id\fR (default: NULL) |
| 146 |
Authentication id of remote server for server to server communication. |
| 147 |
.TP |
| 148 |
\fBauth_receive_filter\fR (default: NULL) |
| 149 |
Program to be used by server receive server or client communication. |
| 150 |
.TP |
| 151 |
\fBauth_server_id\fR (default: NULL) |
| 152 |
Authentication id of originating client or server. |
| 153 |
.TP |
| 154 |
\fBas\fR (default: "jobstart $H $n $P $k $b $t") |
| 155 |
See \fBas\fR. |
| 156 |
.TP |
| 157 |
\fBbk\fR (default: no) |
| 158 |
See \fBprintcap\fP(5) for details. |
| 159 |
.TP |
| 160 |
\fBbk_filter_options\fR |
| 161 |
(default: "$P $w $l $x $y $F $c $L $i $J $C $0n $0h $-a") |
| 162 |
If the "bkf" (backwards compatible filter) flags is set in the |
| 163 |
printcap entry and the original filter specification does not have |
| 164 |
a `$` in it, |
| 165 |
this option string is appended to a filter specification, |
| 166 |
and the string expanded with values from the printcap information |
| 167 |
and job information. |
| 168 |
(see of_filter_options, filter_options, bk_filter_options, bk_of_filter_options) |
| 169 |
.TP |
| 170 |
\fBbk_of_filter_options\fR |
| 171 |
(default: "$w $l $x $y") |
| 172 |
If the "bkf" (backwards compatible filter) flags is set in the |
| 173 |
printcap entry and the original filter specification does not have |
| 174 |
a `$` in it, |
| 175 |
this option string is appended to the OF filter specification, |
| 176 |
and the string expanded with values from the printcap information |
| 177 |
and job information. |
| 178 |
(see of_filter_options, filter_options, bk_filter_options, bk_of_filter_options) |
| 179 |
.TP |
| 180 |
\fBcheck_for_nonprintable\fR (default: "") |
| 181 |
(Used by LPR) check f and p formats |
| 182 |
for non_printable characters unless |
| 183 |
\fB\-b\fR (binary) |
| 184 |
or |
| 185 |
\fB\-l\fR (literal) |
| 186 |
command_line option is supplied. Note that |
| 187 |
files containing HPGL or other printer control |
| 188 |
languages would often be classed as ``non_printable''. |
| 189 |
.TP |
| 190 |
\fBconnect_grace\fR (default: 0 seconds) |
| 191 |
The time to pause before opening a new connection to a printer. |
| 192 |
This allows the printer time to recover from the previous job. |
| 193 |
.TP |
| 194 |
\fBconnect_interval\fR (default: 10 (seconds)) |
| 195 |
The time to pause after a failed connection or open |
| 196 |
of the printing device before attempting a new connection or open. |
| 197 |
.TP |
| 198 |
\fBconnect_timeout\fR (default: 10 (seconds)) |
| 199 |
The time to wait for a device open or connection to complete. |
| 200 |
A zero value is infinite timeout. |
| 201 |
.TP |
| 202 |
\fBretry_nolink\fR (default: true) |
| 203 |
When TRUE and the LPD server is printing or transferring a job, |
| 204 |
then an indefinite number of attempts to connect to or open the IO device |
| 205 |
will be made. |
| 206 |
.TP |
| 207 |
\fBdefault_banner_printer\fR (default: "") |
| 208 |
The default banner printer program to be used for printing banners. |
| 209 |
This should be specified in the LPD configuration file. |
| 210 |
.TP |
| 211 |
\fBdefault_format\fR (default: "f") |
| 212 |
Default format for printing jobs. |
| 213 |
.TP |
| 214 |
\fBdefault_logger_port\fR |
| 215 |
(default: 2001) |
| 216 |
specifies a default port number for logger information. |
| 217 |
See logger_destination for details. |
| 218 |
.TP |
| 219 |
\fBdefault_logger_protocol\fR |
| 220 |
(default: UDP) |
| 221 |
specifies a default protocol for logger information. |
| 222 |
See logger_destination for details. |
| 223 |
.TP |
| 224 |
\fBdefault_permission\fR (default: ACCEPT) |
| 225 |
Default permission for operations. |
| 226 |
.TP |
| 227 |
\fBdefault_printer\fR (default: "") |
| 228 |
The default printer to use if there is no |
| 229 |
PRINTER environment variable, |
| 230 |
the user has not specified a printer, |
| 231 |
or there is no printcap information. |
| 232 |
.TP |
| 233 |
\fBdefault_priority\fR (default: "A") |
| 234 |
Default priority (class) for printing jobs. |
| 235 |
This is also used as the job class. |
| 236 |
.TP |
| 237 |
\fBdefault_remote_host\fR (default: "%H") |
| 238 |
The default remote host to use. |
| 239 |
.TP |
| 240 |
\fBdefault_tmp_dir\fR (default: /tmp) |
| 241 |
Directory for temporary files. |
| 242 |
.TP |
| 243 |
\fBdomain_name\fR (default: "") |
| 244 |
This parameter is optional, and is appended to |
| 245 |
the hostname to make it into a fully_qualified |
| 246 |
domain name, ie. \fIclass.iona.ie\fR. It will only |
| 247 |
be used if the software cannot determine the domain name |
| 248 |
using other means, such as \fBgethostbyname(3n)\fR. |
| 249 |
.TP |
| 250 |
\fBff\fR (default: \\f) |
| 251 |
Formfeed string. |
| 252 |
.TP |
| 253 |
\fBfilter_ld_path\fR |
| 254 |
(default: ) |
| 255 |
The value for the environment variable LD_LIBRARY_PATH, |
| 256 |
both used when executing, and passed on to filters. |
| 257 |
This variable is used to find shared libraries on |
| 258 |
SunOS, Solaris and Linux. |
| 259 |
.TP |
| 260 |
\fBfilter_options\fR |
| 261 |
(default: "$C $F $H $J $L $P $Q $R $Z |
| 262 |
$a $c $d $e $f $h $i $j $k $l $n $p $r $s $w $x $y $-a") |
| 263 |
If the "bkf" (backwards compatible filter) flags is not set in the |
| 264 |
printcap entry and the original filter specification does not have |
| 265 |
a `$` in it, |
| 266 |
this option string is appended to a filter specification, |
| 267 |
and the string expanded with values from the printcap information |
| 268 |
and job information. |
| 269 |
(see of_filter_options, filter_options, bk_filter_options, bk_of_filter_options) |
| 270 |
.TP |
| 271 |
\fBfilter_path\fR |
| 272 |
(default: /bin:/usr/bin:/usr/local/bin) |
| 273 |
The value for the environment variable PATH, both used to find filters |
| 274 |
and passed on to filters run by \fBlpd\fR and \fBlpr\fR. |
| 275 |
.TP |
| 276 |
\fBforce_poll\fR (default: no) |
| 277 |
Some software packages put print jobs directly into the spool queues. |
| 278 |
The |
| 279 |
\fBforce_poll\fR flag forces lpd to periodically poll spool queues |
| 280 |
looking for jobs and no server. |
| 281 |
The |
| 282 |
\fBpoll_time\fR variable sets the interval between polls. |
| 283 |
.TP |
| 284 |
\fBfull_time\fR (default: no) |
| 285 |
Use full time and date format in logging and error messages. |
| 286 |
.TP |
| 287 |
\fBfx\fR (default: "") |
| 288 |
See \fBprintcap\fP(5) for details. |
| 289 |
This specifies the job formats allowed for this queue. |
| 290 |
.TP |
| 291 |
\fBgroup\fR (default "daemon") |
| 292 |
The group to use for file ownership and process permissions. |
| 293 |
Used only by lpd; |
| 294 |
this can be the name of a group or a number. |
| 295 |
All filters will run as the specified group. |
| 296 |
Note that if the group value is 0, |
| 297 |
then the real user group of the process at startup will be used. |
| 298 |
.TP |
| 299 |
\fBkerberos_keytab\fR (default "/etc/lpd.keytab") |
| 300 |
The keytab file to be used by the LPD server when using |
| 301 |
built-in kerberos authentication. |
| 302 |
The keytab file should be owned by the LPD server, |
| 303 |
and be readable/writable only by it (i.e. - 600 permissions). |
| 304 |
.TP |
| 305 |
\fBkerberos_life\fR (default NULL) |
| 306 |
The lifetime of a Kerberos ticket. |
| 307 |
NULL selects the default lifetime. |
| 308 |
Time should be specified using the standard Kerberos time representations. |
| 309 |
.TP |
| 310 |
\fBkerberos_forward_principal\fR (default NULL) |
| 311 |
remote principal used by server when forwarding |
| 312 |
.TP |
| 313 |
\fBkerberos_renew\fR (default NULL) |
| 314 |
The renewal of a Kerberos ticket. |
| 315 |
NULL selects a non-renewable ticket. |
| 316 |
Time should be specified using the standard Kerberos time representations. |
| 317 |
.TP |
| 318 |
\fBkerberos_server_principal\fR (default "lpr") |
| 319 |
Server principal used when client sending to server or |
| 320 |
when server is originating connection to another server for forwarding. |
| 321 |
.TP |
| 322 |
\fBkerberos_service\fR (default "lpr") |
| 323 |
The service name used to make requests to the LPD server |
| 324 |
when using kerberos authentication. |
| 325 |
For example, |
| 326 |
if kerberos_service has the value lpr, |
| 327 |
the server is on host alpha.com, |
| 328 |
and the kerberos domain is ALPHA.COM, |
| 329 |
then the kerberos principal name would be: |
| 330 |
.br |
| 331 |
lpr/[email protected]. |
| 332 |
.br |
| 333 |
.TP |
| 334 |
\fBla\fR (default: yes) |
| 335 |
See \fBprintcap\fP(5) for details. |
| 336 |
.TP |
| 337 |
\fBlf\fR (default: log) |
| 338 |
Name of the log file. |
| 339 |
.TP |
| 340 |
\fBlo\fR (default: lock) |
| 341 |
Name of the lock file. |
| 342 |
.TP |
| 343 |
\fBlocalhost\fR |
| 344 |
(default "localhost") |
| 345 |
The name of the localhost entry to be used for the TCP/IP |
| 346 |
loopback interface. |
| 347 |
The TCP/IP connection may originate from the local host; |
| 348 |
use this name to check to see if the local host address |
| 349 |
is in the IP address database, |
| 350 |
and use it as the origination address for local connections. |
| 351 |
This is done to avoid problems with multi-homed hosts |
| 352 |
who originate connections from different interfaces. |
| 353 |
.TP |
| 354 |
\fBlockfile\fR (default: /var/spool/lpd/lpd) |
| 355 |
The file used to indicate the presence of an \fBlpd\fR |
| 356 |
server running on the host. The lpd_port value is appended |
| 357 |
to the lockfile value to provide a unique lockfile |
| 358 |
even when different versions of LPRng are running |
| 359 |
on the same system. |
| 360 |
.TP |
| 361 |
\fBlogger_destination\fR |
| 362 |
(default: "") |
| 363 |
This specifies a destination for logger information generated by the lpd server. |
| 364 |
The formation of the destination specification is |
| 365 |
host[%port][,(TCP|UDP)]. |
| 366 |
For example, |
| 367 |
localhost%2001,UDP would send logger information to the localhost IP address, |
| 368 |
on port 2001 using the UPD protocol. |
| 369 |
The default port and protocol are set by the |
| 370 |
default_logger_port and default_logger_protocol configuration variables respectively. |
| 371 |
.TP |
| 372 |
\fBlongnumber\fR |
| 373 |
(default: no) |
| 374 |
RFC1179 requires 3 digit job numbers; |
| 375 |
setting longnumber to yes allows 6 digit numbers. |
| 376 |
If the backwards_compatible flag is set, |
| 377 |
only 3 digit numbers will be used. |
| 378 |
.TP |
| 379 |
\fBlpd_listen_port\fR (default: =off) [ipaddr%]port |
| 380 |
The port that \fBlpd\fR binds to. If the parameter is set to off then |
| 381 |
\fBlpd\fR does not listen to any TCP port. See \fBlpd_port\fR for |
| 382 |
details of the format of the argument. |
| 383 |
|
| 384 |
If this is not set at all, then \fBlpd\dP will listen on \fBlpd_port\fP. |
| 385 |
.TP |
| 386 |
\fBlpd_port\fR (default: \fIprinter\fR) [ipaddr%]port |
| 387 |
The port that \fBlpr\fR and |
| 388 |
the other client programs send their requests to. |
| 389 |
The specification has the format ipaddr%port. |
| 390 |
If the IP address is specified then a bind to only this address and |
| 391 |
port is done. |
| 392 |
If the port value is not a number |
| 393 |
a service lookup is performed and the corresponding |
| 394 |
service port is used; see services(5). |
| 395 |
This parameter is useful for debugging a new |
| 396 |
installation of LPRng, in that running LPRng on |
| 397 |
a different port from the default will not |
| 398 |
interfere with a previous installation of |
| 399 |
LPD or LPRng. |
| 400 |
.TP |
| 401 |
\fBlpd_printcap_path\fR (default: "") |
| 402 |
The location of |
| 403 |
.B lpd |
| 404 |
server only printcap database information. |
| 405 |
If this is nonblank the \fBprintcap_path\P will not be used by the |
| 406 |
.B lpd |
| 407 |
server. |
| 408 |
.TP |
| 409 |
\fBmail_operator_on_error\fR (default: "") |
| 410 |
Put this person on the CC-list of the mail, if it is not |
| 411 |
a success mail. (So in addition to the person who made the |
| 412 |
printer request, also this person gets error messages, but |
| 413 |
no success messages.) |
| 414 |
.TP |
| 415 |
\fBmax_status_line\fR (default: 79) |
| 416 |
An integer value specifying the numbers of characters to be |
| 417 |
used for displaying simple job status; this includes the queue position, |
| 418 |
job identifier, job contents, size, and time. |
| 419 |
A 0 (zero) value indicates no restrictions. |
| 420 |
.TP |
| 421 |
\fBmax_status_size\fR (default: 10 (Kbytes)) |
| 422 |
An integer value specifying (in K bytes) |
| 423 |
the maximum size of the status file |
| 424 |
to be generated during printing operations. |
| 425 |
A 0 value will create unlimited size status files. |
| 426 |
When the file size exceeds this value, |
| 427 |
it is truncated to |
| 428 |
.B min_status_size |
| 429 |
K bytes. |
| 430 |
.TP |
| 431 |
\fBmc\fR (default: 1) |
| 432 |
See \fBprintcap\fP(5) for details. |
| 433 |
.TP |
| 434 |
\fBmin_status_size\fR (default: 0 (Kbytes)) |
| 435 |
Minimum status size. |
| 436 |
If 0, defaults to 20 percent of max_status_size. |
| 437 |
.TP |
| 438 |
\fBminfree\fR (default: 0) |
| 439 |
The amount of free space (in Kbytes) |
| 440 |
needed in the spool directory in order |
| 441 |
for a job to be accepted. |
| 442 |
If 0, there is no limit; |
| 443 |
if the parameter is the name of a file rather than a number, |
| 444 |
the file must contain a numerical minimum free value (in Kbytes). |
| 445 |
This value is overridden by the printcap |
| 446 |
.I mi |
| 447 |
field value. |
| 448 |
.TP |
| 449 |
\fBms_time_resolution\fR |
| 450 |
(default: FALSE) |
| 451 |
This flag causes the time information to be printed to millisecond |
| 452 |
accuracy. |
| 453 |
This is overkill for most purposes. |
| 454 |
.TP |
| 455 |
\fBof_filter_options\fR |
| 456 |
(default: "") |
| 457 |
If this is not set, |
| 458 |
the value defaults to the same as the filter_options value. |
| 459 |
This string is appended to a OF filter specification, |
| 460 |
and the string expanded with values from the printcap information |
| 461 |
and job information. |
| 462 |
If the "bkf" (backwards compatible filter) flags is set in the |
| 463 |
printcap entry, |
| 464 |
of bk_of_filter_options value is appended instead |
| 465 |
(see of_filter_options, filter_options, bk_filter_options, bk_of_filter_options) |
| 466 |
.TP |
| 467 |
\fBoriginate_port\fR |
| 468 |
(default: "721 731") |
| 469 |
A range of port numbers to originate requests from. |
| 470 |
When sending service requests, |
| 471 |
the software will try to open and bind to these ports to |
| 472 |
originate a request to a server. |
| 473 |
If no port is given, |
| 474 |
or all of the requested ports are unavailable or cannot be |
| 475 |
bound to, |
| 476 |
then a normal use port is requested. |
| 477 |
Note that on UNIX systems, |
| 478 |
if a port in the range 0-1023 is requested the EUID of the |
| 479 |
process must be root for the request to be granted. |
| 480 |
Note that RFC1179 specifies that requests must |
| 481 |
originate from ports in the range 721-731. |
| 482 |
.TP |
| 483 |
\fBpass_env\fR |
| 484 |
(default: "LANG,LC_CTYPE,LC_NUMERIC,LC_TIME,LC_COLLATE,LC_MONETARY, LC_MESSAGES,LC_PAPER,LC_NAME,LC_ADDRESS,LC_TELEPHONE,LC_MEASUREMENT, LC_IDENTIFICATION,LC_ALL") |
| 485 |
Client programs such as LPR, LPC, etc., will pass these |
| 486 |
environment variables to any filter programs they start. |
| 487 |
.TP |
| 488 |
\fBpoll_time\fR (default: 6000) |
| 489 |
Interval in seconds at which LPD checks for queues with jobs and no |
| 490 |
server active. |
| 491 |
See |
| 492 |
\fBforce_poll\fR as well. |
| 493 |
.TP |
| 494 |
\fBpl\fR (default: 66) |
| 495 |
See \fBprintcap\fP(5) for details. |
| 496 |
.TP |
| 497 |
\fBpr\fR (default: /bin/pr) |
| 498 |
See \fBprintcap\fP(5) for details. |
| 499 |
.TP |
| 500 |
\fBprintcap_path\fR |
| 501 |
(default: "/etc/printcap") |
| 502 |
The location of the printcap database file. |
| 503 |
If a file or filter does not exist, it is considered a fatal error. |
| 504 |
All valid entries in these files will be used. |
| 505 |
See PRINTCAP LOOKUP for details. |
| 506 |
.TP |
| 507 |
\fBperms_path\fR |
| 508 |
(default: /etc/lpd.perms:/usr/etc/lpd.perms: /var/spool/lpd/lpd.perms.%h) |
| 509 |
The location of the printer permissions database. |
| 510 |
If a file or filter does not exist, it is skipped. |
| 511 |
The first file or filter that exists and is readable will be used. |
| 512 |
See PERMISSIONS LOOKUP for details. |
| 513 |
.TP |
| 514 |
\fBpw\fR (default: 80) |
| 515 |
See \fBprintcap\fP(5) for details. |
| 516 |
.TP |
| 517 |
\fBsave_on_error\fR |
| 518 |
(default: no) |
| 519 |
Save a job in the spool queue if it has an error |
| 520 |
rather than removing it. |
| 521 |
.TP |
| 522 |
\fBsave_when_done\fR |
| 523 |
(default: no) |
| 524 |
Save a job in the spool queue after completion |
| 525 |
rather than removing it. |
| 526 |
.TP |
| 527 |
\fBsend_data_first\fR |
| 528 |
(default: no) |
| 529 |
Send data files of a job first, |
| 530 |
followed by the control file. |
| 531 |
.TP |
| 532 |
\fBsend_failure_action\fR (default: "") |
| 533 |
The lpd server uses this to determine the action to take when |
| 534 |
unable to print or process a job. |
| 535 |
The keyword |
| 536 |
\fIabort\fR |
| 537 |
will cause it to terminate operations, |
| 538 |
leaving the job in the queue, |
| 539 |
\fIremove\fR |
| 540 |
will cause it to remove the job, |
| 541 |
\fIretry\fR |
| 542 |
will cause it to retry the job, |
| 543 |
and |
| 544 |
\fIhold\fR |
| 545 |
will cause it to hold the job with an error indication. |
| 546 |
If the value is a filter, |
| 547 |
then the filter will be invoked and the exit status of the |
| 548 |
filter used to determine the actions. |
| 549 |
.TP |
| 550 |
\fBsend_job_rw_timeout\fR (default: 6000) |
| 551 |
When printing or sending a job to a remote printer, |
| 552 |
use this as a write to the device or remote host timeout value. |
| 553 |
If a timeout occurs, |
| 554 |
then a FAIL status is returned and |
| 555 |
the send_failure_action value is used to determine what to do on failure. |
| 556 |
.TP |
| 557 |
\fBsend_try\fR (default: 3) |
| 558 |
Numbers of times to try to send a job to the printer or remote host. |
| 559 |
A 0 value means an infinite number of times. |
| 560 |
.TP |
| 561 |
\fBsendmail\fR (default: "/usr/lib/sendmail -oi -t") |
| 562 |
If the argument is empty then all mail_related |
| 563 |
functionality is disabled. |
| 564 |
The arguments are the command to run |
| 565 |
when mail is to be sent. |
| 566 |
The command used needs to be able to |
| 567 |
accept the message on stdin, with \fIno\fR arguments. |
| 568 |
The message will contain the \fBTo:\fR, \fBFrom:\fR, |
| 569 |
\fBCc:\fR and \fBSubject:\fR headers. |
| 570 |
.TP |
| 571 |
\fBserver_tmp_dir\fR (default: /tmp) |
| 572 |
Temporary dir for the server. |
| 573 |
.TP |
| 574 |
\fBspool_dir_perms\fR (default: 042700) |
| 575 |
Permissions of the spool directories. |
| 576 |
.TP |
| 577 |
\fBspool_file_perms\fR (default: 0600) |
| 578 |
Permissions of the spool files. |
| 579 |
.TP |
| 580 |
\fBsyslog_device\fR (default: /dev/console) |
| 581 |
Log to this device if all else fails. |
| 582 |
.TP |
| 583 |
.BR unix_socket_path " (default: /var/run/lprng/socket)" |
| 584 |
Location of the Unix socket that lpd listens on and LPRng clients |
| 585 |
attempt to communicate to when host is localhost. Set to \fIoff\fR |
| 586 |
to disable listening and connecting via a Unix socket. |
| 587 |
.TP |
| 588 |
\fBuse_date\fR (default: no) |
| 589 |
No information about this parameter available. |
| 590 |
.TP |
| 591 |
\fBuse_identifier\fR (default: no) |
| 592 |
Add a job identifier line to the control file, |
| 593 |
using the 'A' entry in the control file. |
| 594 |
.TP |
| 595 |
\fBuse_info_cache\fR (default: yes) |
| 596 |
If this is set to \fIyes\fR, lpd.perms and printcap information |
| 597 |
lookups will be cached for later use. |
| 598 |
Only lookups in the main databases will be cached, |
| 599 |
not lookups in the per_printer databases. |
| 600 |
You can force |
| 601 |
the \fBlpd\fR to flush its cache and reread the |
| 602 |
permissions file by sending it a SIGHUP. |
| 603 |
.TP |
| 604 |
\fBuse_queuename\fR (default: no) |
| 605 |
Put an entry into control files identifying the spool queue |
| 606 |
the job was originally sent to. |
| 607 |
The entry has the form 'Qspoolname', |
| 608 |
and its value can be passed to filters. |
| 609 |
This is useful for setting up a spool queue which formats |
| 610 |
jobs in different ways, |
| 611 |
depending on the name of the queue. |
| 612 |
.TP |
| 613 |
\fBuse_shorthost\fR (default: no) |
| 614 |
By default, names of lpr job files used the |
| 615 |
originating host fully qualified domain name. |
| 616 |
This can exceed 14 characters, |
| 617 |
the limit of file names on some UNIX systems. |
| 618 |
If this is set to \fIyes\fR, the non-qualified name will be used, |
| 619 |
and if the host name is at most 8 characters the file name will be at |
| 620 |
most 14 characters long. |
| 621 |
.TP |
| 622 |
\fBuser\fR (default: daemon) |
| 623 |
The user that \fBlpd\fR and its filters runs as, |
| 624 |
and the owner of the spool directories and |
| 625 |
other lpd_writable files. |
| 626 |
This can be the name of a user or a number. |
| 627 |
If the user value is 0, |
| 628 |
then the real UID of the program when started will be used. |
| 629 |
This allows a non_root user to test the functionality |
| 630 |
of the LRPng software. |
| 631 |
|
| 632 |
.SH "PRINTCAP LOOKUP, DATABASE FILES AND FILTERS" |
| 633 |
.PP |
| 634 |
The printcap_path |
| 635 |
and |
| 636 |
printer_perms_path |
| 637 |
variables specify a list of either data base files or filters to use to |
| 638 |
get printcap or permission entries for a printer. |
| 639 |
To get information, |
| 640 |
the filter is started and a single line with the printer name is |
| 641 |
sent to it. |
| 642 |
Note that the printer name |
| 643 |
.I all |
| 644 |
is used to request information either about all printers, |
| 645 |
or a specific printer entry that has a list of |
| 646 |
all printers. |
| 647 |
See |
| 648 |
.BR printcap (5) |
| 649 |
for more details. |
| 650 |
.PP |
| 651 |
To find the printcap information, |
| 652 |
LPRng programs will read the database files specified in the |
| 653 |
.I printcap_path |
| 654 |
entry. |
| 655 |
The |
| 656 |
.I lpd |
| 657 |
server will read any additional files specified in the |
| 658 |
.I lpd_printcap_path |
| 659 |
entry. |
| 660 |
If any of the files is missing or non-readable a fatal error will result. |
| 661 |
After having searched the various files, |
| 662 |
if a filter has been specified the filter will be started and |
| 663 |
the required printer name will be sent to the filter. |
| 664 |
The output from the filter will be used as the printcap information. |
| 665 |
.SH "SECURITY-RELATED PARAMETERS" |
| 666 |
.PP |
| 667 |
Environment variables are sanitized by \fBlpd\fR and the other |
| 668 |
executables, in that the variables \fIIFS\fR, \fILD_PRELOAD\fR |
| 669 |
and \fILD_PROFILE\fR are all deleted from the environment passed |
| 670 |
to filters and any other sub_processes. |
| 671 |
For more reliability, |
| 672 |
script filters should set their own |
| 673 |
PATH and LD_LIBRARY_PATH variables. |
| 674 |
.PP |
| 675 |
All filters will run as the user and group specified by the |
| 676 |
group and user variables. |
| 677 |
|
| 678 |
.SH EXAMPLE |
| 679 |
.nf |
| 680 |
# lpd.conf generated from on Wed Apr 7 07:59:48 PDT 1999 |
| 681 |
|
| 682 |
# The values in this file are the default values. |
| 683 |
# If you modify the file, set the value to something other than the default |
| 684 |
# For example, '# default force_localhost' means |
| 685 |
# the 'force_localhost' option value is on or 1. |
| 686 |
# Uncomment this and change it to read 'force_localhost@' |
| 687 |
|
| 688 |
# Purpose: always print banner, ignore lpr -h option |
| 689 |
# default ab@ |
| 690 |
# Purpose: query accounting server when connected |
| 691 |
# default achk@ |
| 692 |
# Purpose: accounting at end (see also af, la, ar, as) |
| 693 |
# default ae=jobend $H $n $P $k $b $t |
| 694 |
# Purpose: name of accounting file (see also la, ar) |
| 695 |
# default af= |
| 696 |
af=acct |
| 697 |
# Purpose: automatically hold all jobs |
| 698 |
# default ah@ |
| 699 |
ah |
| 700 |
# Purpose: Allow duplicate command line arguments (legacy requirement) |
| 701 |
# default allow_duplicate_args@ |
| 702 |
.fi |
| 703 |
.SH FILES |
| 704 |
.PP |
| 705 |
The files used by LPRng are set by values in the |
| 706 |
printer configuration file. |
| 707 |
The following are a commonly used set of default values. |
| 708 |
.nf |
| 709 |
.ta \w'/var/spool/lpd/printcap.<hostname> 'u |
| 710 |
/etc/lprng/lpd.conf LPRng configuration file |
| 711 |
${HOME}/.printcap user printer description file |
| 712 |
/etc/printcap printer description file |
| 713 |
/etc/lprng/lpd.perms permissions |
| 714 |
/var/run/lprng/lpd lock file for queue control |
| 715 |
/var/spool/lpd spool directories |
| 716 |
/var/spool/lpd/QUEUE/control queue control |
| 717 |
/var/spool/lpd/QUEUE/log trace or debug log file |
| 718 |
/var/spool/lpd/QUEUE/acct accounting file |
| 719 |
/var/spool/lpd/QUEUE/status status file |
| 720 |
.fi |
| 721 |
.SH "SEE ALSO" |
| 722 |
lpc(8), |
| 723 |
lpd(8), |
| 724 |
checkpc(8), |
| 725 |
lpr(1), |
| 726 |
lpq(1), |
| 727 |
lprm(1), |
| 728 |
printcap(5), |
| 729 |
lpd.perms(5), |
| 730 |
pr(1), lprng_certs(1), lprng_index_certs(1). |
| 731 |
.SH DIAGNOSTICS |
| 732 |
.nf |
| 733 |
Most of the diagnostics are self explanatory. |
| 734 |
If you are puzzled over the exact cause of failure, |
| 735 |
set the debugging level on (-D5) and run again. |
| 736 |
The debugging information will |
| 737 |
help you to pinpoint the exact cause of failure. |
| 738 |
.fi |
| 739 |
.SH "HISTORY" |
| 740 |
LPRng is a enhanced printer spooler system |
| 741 |
with functionality similar to the Berkeley LPR software. |
| 742 |
The LPRng mailing list is [email protected]; |
| 743 |
subscribe by sending mail to [email protected] with |
| 744 |
the word subscribe in the body. |
| 745 |
The software is available from ftp://ftp.lprng.com/pub/LPRng. |
| 746 |
.SH "AUTHOR" |
| 747 |
Patrick Powell <[email protected]>. |