/usr/share/doc/lprng-doc/LPRng-Reference-Multipart/logfiles.htm is in lprng-doc 3.8.A~rc2-3.
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 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 | <!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 Linux/x86 (vers 6 November 2007), see www.w3.org">
<title>Log and Status Files</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
<link rel="HOME" title=" LPRng Reference Manual" href=
"index.htm">
<link rel="UP" title="Spool Queues and Files" href=
"spoolqueue.htm">
<link rel="PREVIOUS" title="Spool Control File " href=
"queuecontrolfile.htm">
<link rel="NEXT" title="Job Files" href="jobfiles.htm">
</head>
<body class="SECT1" 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=
"queuecontrolfile.htm" accesskey="P">Prev</a></td>
<td width="80%" align="center" valign="bottom">Chapter 13.
Spool Queues and Files</td>
<td width="10%" align="right" valign="bottom"><a href=
"jobfiles.htm" accesskey="N">Next</a></td>
</tr>
</table>
<hr align="left" width="100%">
</div>
<div class="SECT1">
<h1 class="SECT1"><a name="LOGFILES" id="LOGFILES">13.4. Log
and Status Files</a></h1>
<ul>
<li>
<p><tt class="LITERAL">create_files</tt><span class=
"emphasis"><i class="EMPHASIS">create log, accounting and
status files</i></span></p>
</li>
<li>
<p><tt class="LITERAL">lf=</tt><span class=
"emphasis"><i class="EMPHASIS">log file name (default:
log)</i></span></p>
</li>
<li>
<p><tt class="LITERAL">max_log_file_size#</tt><span class=
"emphasis"><i class="EMPHASIS">maximum log file size
(Kbytes)</i></span></p>
</li>
<li>
<p><tt class="LITERAL">min_log_file_size#</tt><span class=
"emphasis"><i class="EMPHASIS">minimum log file size
(Kbytes)</i></span></p>
</li>
<li>
<p><tt class=
"LITERAL">max_accounting_file_size#</tt><span class=
"emphasis"><i class="EMPHASIS">maximum accounting file size
(Kbytes)</i></span></p>
</li>
<li>
<p><tt class=
"LITERAL">min_accounting_file_size#</tt><span class=
"emphasis"><i class="EMPHASIS">minimum accounting file size
(Kbytes)</i></span></p>
</li>
<li>
<p><tt class="LITERAL">max_status_line#</tt><span class=
"emphasis"><i class="EMPHASIS">maximum status line length
(characters)</i></span></p>
</li>
<li>
<p><tt class="LITERAL">max_status_size#</tt><span class=
"emphasis"><i class="EMPHASIS">maximum status file size
(Kbytes)</i></span></p>
</li>
<li>
<p><tt class="LITERAL">min_status_size#</tt><span class=
"emphasis"><i class="EMPHASIS">minimum status file size
(Kbytes)</i></span></p>
</li>
<li>
<p><tt class="LITERAL">ps=</tt><span class=
"emphasis"><i class="EMPHASIS">filter status file name
(default: status)</i></span></p>
</li>
<li>
<p><tt class="LITERAL">queue_status_file=</tt><span class=
"emphasis"><i class="EMPHASIS">queue status file (default:
status.%P)</i></span></p>
</li>
<li>
<p><tt class="LITERAL">short_status_date=</tt><span class=
"emphasis"><i class="EMPHASIS">display short (hh:mm)
timestamp (default: true)</i></span></p>
</li>
</ul>
<p>During operation, the <b class="APPLICATION">lpd</b> server
records the current printing operations in the spool queue
status file specified by the <tt class=
"LITERAL">spool_status_file</tt> option (default <tt class=
"LITERAL">status.%P</tt> - the %P is expanded to the print
queue name); for our example, this would be <tt class=
"FILENAME">/var/lpd/pr/status.pr</tt>. In order to prevent this
file from growing too large, the server will periodically
truncate the file. You can force creation of these files by
setting the <tt class="LITERAL">create_files</tt> option. The
<tt class="LITERAL">max_status_size</tt> configuration or
printcap option sets the maximum size (in Kbytes) of the status
file; if the file exceeds this, only the last <tt class=
"LITERAL">min_status_size</tt> bytes or 25% of the maximum size
(default if not specified) will be preserved.</p>
<p>The server logs its operations in the log file specified by
the <tt class="LITERAL">lf</tt> (log file) option (default is
<tt class="LITERAL">lf=log</tt>). The <tt class=
"LITERAL">max_log_file_size</tt> value (default 0) specifies
the maximum length of the log file in Kbytes. If this value is
non-zero, then the log file is truncated to <tt class=
"LITERAL">min_log_file_size</tt> bytes or 25% of the maximum
file size. Again, the last portion of the log file is
preserved. If the <tt class="LITERAL">max_log_file_size</tt>
value is 0, then the log file grows without limit.</p>
<p>The server records accounting information in the log file
specified by the accounting file <tt class="LITERAL">af</tt>
(accounting file) option (default is <tt class=
"LITERAL">af=acct</tt>). The <tt class=
"LITERAL">max_accounting_file_size</tt> value (default 0)
specifies the maximum length of the log file in Kbytes. If this
value is non-zero, then the log file is truncated to <tt class=
"LITERAL">min_accounting_file_size</tt> bytes or 25% of the
maximum file size. Again, the last portion of the log file is
preserved. If the <tt class=
"LITERAL">max_accounting_file_size</tt> value is 0, then the
log file grows without limit. See <a href="opendevice.htm">Open
The Output Device</a> and <a href=
"accountingref.htm#ACCOUNTINGSERVER">Accounting Printcap
Options</a> for more details.</p>
<p>Some filters require an additional filter status file that
they use for recording additional filter status or other
operational information. The <tt class="LITERAL">ps</tt> names
this file, and it is passed to a print filter using the
<tt class="LITERAL">$s</tt> option (see <a href=
"filteroptions.htm">Filter Command Line Options and Environment
Variables</a> ).</p>
<p>The <acronym class="ACRONYM">STDERR</acronym> output for
filters is put into the printer status file. This allows the
filter to produce informative messages that can be displayed as
part of the user status. In addition, a separate status file
specified by the <tt class="LITERAL">ps</tt> (Printer Status)
can be used as well. This file is <span class=
"emphasis"><i class="EMPHASIS">not</i></span> truncated by the
<b class="APPLICATION">LPRng</b> system.</p>
<p>When reporting status information, the length of line
returned can be a problem. The <tt class=
"LITERAL">max_status_line#79</tt> option restricts the status
line to a maximum of 79 characters.</p>
<p>The <tt class="LITERAL">short_status_date</tt> (default is
true) option causes short (hour:minute) timestamps to be
displayed on status queries.</p>
</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=
"queuecontrolfile.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=
"jobfiles.htm" accesskey="N">Next</a></td>
</tr>
<tr>
<td width="33%" align="left" valign="top">Spool Control
File</td>
<td width="34%" align="center" valign="top"><a href=
"spoolqueue.htm" accesskey="U">Up</a></td>
<td width="33%" align="right" valign="top">Job Files</td>
</tr>
</table>
</div>
<p align="center"></p>
</body>
</html>
|