/usr/share/doc/lprng-doc/LPRng-Reference-Multipart/configfile.htm is in lprng-doc 3.8.A~rc2-3.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for HTML5 for Linux version 5.2.0">
<title>Configuration File, Defaults and Overrides</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
<link rel="HOME" title=" LPRng Reference Manual" href=
"index.htm">
<link rel="PREVIOUS" title="Job Identifier " href=
"useidentifier.htm">
<link rel="NEXT" title="Legacy Compatibility" href="x6829.htm">
</head>
<body class="CHAPTER" bgcolor="#FFFFFF" text="#000000" link=
"#0000FF" vlink="#840084" alink="#0000FF">
<div class="NAVHEADER">
<table summary="Header navigation table" width="100%" border=
"0" cellpadding="0" cellspacing="0">
<tr>
<th colspan="3" align="center">LPRng Reference Manual: 24
Sep 2004 (For LPRng-3.8.28)</th>
</tr>
<tr>
<td width="10%" align="left" valign="bottom"><a href=
"useidentifier.htm" accesskey="P">Prev</a></td>
<td width="80%" align="center" valign="bottom"></td>
<td width="10%" align="right" valign="bottom"><a href=
"x6829.htm" accesskey="N">Next</a></td>
</tr>
</table>
<hr align="left" width="100%">
</div>
<div class="CHAPTER">
<h1><a name="CONFIGFILE" id="CONFIGFILE"></a>Chapter 14.
Configuration File, Defaults and Overrides</h1>
<div class="TOC">
<dl>
<dt><b>Table of Contents</b></dt>
<dt>14.1. <a href="configfile.htm#AEN6815">Configuration
File Format</a></dt>
<dt>14.2. <a href="x6829.htm">Legacy Compatibility</a></dt>
</dl>
</div>
<p>Options used:</p>
<ul>
<li>
<p><tt class="LITERAL">allow_getenv</tt> FLAG <span class=
"emphasis"><i class="EMPHASIS">use GETENV environment
variable</i></span></p>
</li>
</ul>
<p>The <b class="APPLICATION">LPRng</b> options are obtained as
follows:</p>
<ul>
<li>
<p>The compile time defaults. These are in the <tt class=
"FILENAME">LPRng/src/common/vars.c</tt> file.</p>
</li>
<li>
<p>If the <b class="APPLICATION">LPRng</b> software has
been compiled with the regression testing <acronym class=
"ACRONYM">GETENV</acronym> option enabled, the
configuration information in the file specified by the
<tt class="LITERAL">LPD_CONF</tt> environment variable will
be used. This can only be used if you are not setuid ROOT
or as ROOT as it opens severe security loopholes.</p>
</li>
<li>
<p>The file specified by the <tt class=
"LITERAL">config_file</tt> compile time option, usually
<tt class="FILENAME">/etc/lpd.conf</tt> or <tt class=
"FILENAME">/usr/local/etc/lpd.conf</tt>, and referred to a
the <tt class="FILENAME">lpd.conf</tt> file. If the
<tt class="LITERAL">config_file</tt> option value has the
form <tt class="FILENAME">|/pathname</tt>, then <tt class=
"FILENAME">/pathname</tt> must be an executable program and
will be run with the standard set of filter options. It
must write configuration option values to its
<acronym class="ACRONYM">STDOUT</acronym> and exit with a 0
status.</p>
</li>
<li>
<p>In order to protect system security, the <tt class=
"FILENAME">lpd.conf</tt> (and the <tt class=
"FILENAME">printcap</tt>) file should be read only.</p>
</li>
<li>
<p>If the <tt class="LITERAL">require_configfiles</tt>
option is set in the compile time options, then the
preceeding step must be successful, i.e. - there must be a
configuration file or the program must execute and exit
with a 0 status.</p>
</li>
<li>
<p>If a printer or spooling operation is done, then the
values in the <tt class="FILENAME">printcap</tt> entry for
the spooler are used to override the default and <tt class=
"FILENAME">ifhp.conf</tt> file values.</p>
</li>
</ul>
<div class="SECT1">
<h1 class="SECT1"><a name="AEN6815" id="AEN6815">14.1.
Configuration File Format</a></h1>
<p>The configuration file format is similar to a the fields
of a printcap entry with the difference that the leading
colon is optional and there can only be one option per
line:</p>
<div class="INFORMALEXAMPLE">
<a name="AEN6818" id="AEN6818"></a>
<pre class="SCREEN"># comment
# set option value to 1 or ON
ab
:ab
# set option value to 0 or OFF
ab@
:ab
# set option value to string
str=name</pre>
</div>
<p>During system installation the <b class=
"APPLICATION">LPRng</b> software processes the default values
in the <tt class="FILENAME">LPRng/src/common/vars.c</tt> file
and generates a sample <tt class="FILENAME">lpd.conf</tt>
file that has the format:</p>
<div class="INFORMALEXAMPLE">
<a name="AEN6824" id="AEN6824"></a>
<pre class="SCREEN">
# Purpose: always print banner, ignore lpr -h option
# default ab@ (FLAG off)
# Purpose: query accounting server when connected
# default achk@ (FLAG off)
# Purpose: accounting at end (see also af, la, ar, as)
# default ae=jobend $H $n $P $k $b $t (STRING)
# Purpose: name of accounting file (see also la, ar)
# default af=acct (STRING)
# change:
# --- we change the af value to none, i.e. - no accounting
# --- file by default
af=</pre>
</div>
<p>You can change option values by editing the file as shown
above then then to force the <b class="APPLICATION">lpd</b>
server to use the new options, use the <tt class=
"COMMAND">lpc reread</tt> command.</p>
</div>
</div>
<div class="NAVFOOTER">
<hr align="left" width="100%">
<table summary="Footer navigation table" width="100%" border=
"0" cellpadding="0" cellspacing="0">
<tr>
<td width="33%" align="left" valign="top"><a href=
"useidentifier.htm" accesskey="P">Prev</a></td>
<td width="34%" align="center" valign="top"><a href=
"index.htm" accesskey="H">Home</a></td>
<td width="33%" align="right" valign="top"><a href=
"x6829.htm" accesskey="N">Next</a></td>
</tr>
<tr>
<td width="33%" align="left" valign="top">Job
Identifier</td>
<td width="34%" align="center" valign="top"> </td>
<td width="33%" align="right" valign="top">Legacy
Compatibility</td>
</tr>
</table>
</div>
<p align="center"></p>
</body>
</html>
|