Debian Codegraph @

upstream/debian-unstable/man5/lpd.conf.5

raw
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]>.