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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title>Log and Status Files</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.71 ">
<link rel="HOME" title=" LPRng-HOWTO" 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-HOWTO: 1 Apr 2002
(For LPRng-3.8.10)</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">13.4. Log and Status
Files</a></h1>
<ul>
<li>
<p><tt class="LITERAL">create_files</tt><i class=
"EMPHASIS">create log, accounting and status
files</i></p>
</li>
<li>
<p><tt class="LITERAL">lf=</tt><i class="EMPHASIS">log
file name (default: log)</i></p>
</li>
<li>
<p><tt class="LITERAL">max_log_file_size#</tt><i class=
"EMPHASIS">maximum log file size (Kbytes)</i></p>
</li>
<li>
<p><tt class="LITERAL">min_log_file_size#</tt><i class=
"EMPHASIS">minimum log file size (Kbytes)</i></p>
</li>
<li>
<p><tt class="LITERAL">max_status_line#</tt><i class=
"EMPHASIS">maximum status line length
(characters)</i></p>
</li>
<li>
<p><tt class="LITERAL">max_status_size#</tt><i class=
"EMPHASIS">maximum status file size (Kbytes)</i></p>
</li>
<li>
<p><tt class="LITERAL">min_status_size#</tt><i class=
"EMPHASIS">minimum status file size (Kbytes)</i></p>
</li>
<li>
<p><tt class="LITERAL">ps=</tt><i class="EMPHASIS">filter
status file name (default: status)</i></p>
</li>
<li>
<p><tt class="LITERAL">queue_status_file=</tt><i class=
"EMPHASIS">queue status file (default: status.%P)</i></p>
</li>
<li>
<p><tt class="LITERAL">short_status_date=</tt><i class=
"EMPHASIS">display short (hh:mm) timestamp (default:
true)</i></p>
</li>
</ul>
<br>
<br>
<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>Similarly, 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>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 <span class="ACRONYM">STDERR</span> 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 <i class="EMPHASIS">not</i>
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>
</body>
</html>
|
