1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2 3<html> 4 <head> 5 <meta name="generator" content="HTML Tidy, see www.w3.org"> 6 <title>Log and Status Files</title> 7 <meta name="GENERATOR" content= 8 "Modular DocBook HTML Stylesheet Version 1.7"> 9 <link rel="HOME" title=" LPRng Reference Manual" href= 10 "index.htm"> 11 <link rel="UP" title="Spool Queues and Files" href= 12 "spoolqueue.htm"> 13 <link rel="PREVIOUS" title="Spool Control File " href= 14 "queuecontrolfile.htm"> 15 <link rel="NEXT" title="Job Files" href="jobfiles.htm"> 16 </head> 17 18 <body class="SECT1" bgcolor="#FFFFFF" text="#000000" link= 19 "#0000FF" vlink="#840084" alink="#0000FF"> 20 <div class="NAVHEADER"> 21 <table summary="Header navigation table" width="100%" border= 22 "0" cellpadding="0" cellspacing="0"> 23 <tr> 24 <th colspan="3" align="center">LPRng Reference Manual: 5 25 Sep 2003 (For LPRng-3.8.22)</th> 26 </tr> 27 28 <tr> 29 <td width="10%" align="left" valign="bottom"><a href= 30 "queuecontrolfile.htm" accesskey="P">Prev</a></td> 31 32 <td width="80%" align="center" valign="bottom">Chapter 33 13. Spool Queues and Files</td> 34 35 <td width="10%" align="right" valign="bottom"><a href= 36 "jobfiles.htm" accesskey="N">Next</a></td> 37 </tr> 38 </table> 39 <hr align="LEFT" width="100%"> 40 </div> 41 42 <div class="SECT1"> 43 <h1 class="SECT1"><a name="LOGFILES">13.4. Log and Status 44 Files</a></h1> 45 46 <ul> 47 <li> 48 <p><var class="LITERAL">create_files</var><span class= 49 "emphasis"><i class="EMPHASIS">create log, accounting and 50 status files</i></span></p> 51 </li> 52 53 <li> 54 <p><var class="LITERAL">lf=</var><span class= 55 "emphasis"><i class="EMPHASIS">log file name (default: 56 log)</i></span></p> 57 </li> 58 59 <li> 60 <p><var class="LITERAL">max_log_file_size#</var><span 61 class="emphasis"><i class="EMPHASIS">maximum log file 62 size (Kbytes)</i></span></p> 63 </li> 64 65 <li> 66 <p><var class="LITERAL">min_log_file_size#</var><span 67 class="emphasis"><i class="EMPHASIS">minimum log file 68 size (Kbytes)</i></span></p> 69 </li> 70 71 <li> 72 <p><var class="LITERAL">max_status_line#</var><span 73 class="emphasis"><i class="EMPHASIS">maximum status line 74 length (characters)</i></span></p> 75 </li> 76 77 <li> 78 <p><var class="LITERAL">max_status_size#</var><span 79 class="emphasis"><i class="EMPHASIS">maximum status file 80 size (Kbytes)</i></span></p> 81 </li> 82 83 <li> 84 <p><var class="LITERAL">min_status_size#</var><span 85 class="emphasis"><i class="EMPHASIS">minimum status file 86 size (Kbytes)</i></span></p> 87 </li> 88 89 <li> 90 <p><var class="LITERAL">ps=</var><span class= 91 "emphasis"><i class="EMPHASIS">filter status file name 92 (default: status)</i></span></p> 93 </li> 94 95 <li> 96 <p><var class="LITERAL">queue_status_file=</var><span 97 class="emphasis"><i class="EMPHASIS">queue status file 98 (default: status.%P)</i></span></p> 99 </li> 100 101 <li> 102 <p><var class="LITERAL">short_status_date=</var><span 103 class="emphasis"><i class="EMPHASIS">display short 104 (hh:mm) timestamp (default: true)</i></span></p> 105 </li> 106 </ul> 107 <br> 108 <br> 109 110 <p>During operation, the <b class="APPLICATION">lpd</b> 111 server records the current printing operations in the spool 112 queue status file specified by the <var class= 113 "LITERAL">spool_status_file</var> option (default <var class= 114 "LITERAL">status.%P</var> - the %P is expanded to the print 115 queue name); for our example, this would be <tt class= 116 "FILENAME">/var/lpd/pr/status.pr</tt>. In order to prevent 117 this file from growing too large, the server will 118 periodically truncate the file. You can force creation of 119 these files by setting the <var class= 120 "LITERAL">create_files</var> option. The <var class= 121 "LITERAL">max_status_size</var> configuration or printcap 122 option sets the maximum size (in Kbytes) of the status file; 123 if the file exceeds this, only the last <var class= 124 "LITERAL">min_status_size</var> bytes or 25% of the maximum 125 size (default if not specified) will be preserved.</p> 126 127 <p>Similarly, the server logs its operations in the log file 128 specified by the <var class="LITERAL">lf</var> (log file) 129 option (default is <var class="LITERAL">lf=log</var>). The 130 <var class="LITERAL">max_log_file_size</var> value (default 131 0) specifies the maximum length of the log file in Kbytes. If 132 this value is non-zero, then the log file is truncated to 133 <var class="LITERAL">min_log_file_size</var> bytes or 25% of 134 the maximum file size. Again, the last portion of the log 135 file is preserved. If the <var class= 136 "LITERAL">max_log_file_size</var> value is 0, then the log 137 file grows without limit.</p> 138 139 <p>Some filters require an additional filter status file that 140 they use for recording additional filter status or other 141 operational information. The <var class="LITERAL">ps</var> 142 names this file, and it is passed to a print filter using the 143 <var class="LITERAL">$s</var> option (see <a href= 144 "filteroptions.htm">Filter Command Line Options and 145 Environment Variables</a> ).</p> 146 147 <p>The <acronym class="ACRONYM">STDERR</acronym> output for 148 filters is put into the printer status file. This allows the 149 filter to produce informative messages that can be displayed 150 as part of the user status. In addition, a separate status 151 file specified by the <var class="LITERAL">ps</var> (Printer 152 Status) can be used as well. This file is <span class= 153 "emphasis"><i class="EMPHASIS">not</i></span> truncated by 154 the <b class="APPLICATION">LPRng</b> system.</p> 155 156 <p>When reporting status information, the length of line 157 returned can be a problem. The <var class= 158 "LITERAL">max_status_line#79</var> option restricts the 159 status line to a maximum of 79 characters.</p> 160 161 <p>The <var class="LITERAL">short_status_date</var> (default 162 is true) option causes short (hour:minute) timestamps to be 163 displayed on status queries.</p> 164 </div> 165 166 <div class="NAVFOOTER"> 167 <hr align="LEFT" width="100%"> 168 169 <table summary="Footer navigation table" width="100%" border= 170 "0" cellpadding="0" cellspacing="0"> 171 <tr> 172 <td width="33%" align="left" valign="top"><a href= 173 "queuecontrolfile.htm" accesskey="P">Prev</a></td> 174 175 <td width="34%" align="center" valign="top"><a href= 176 "index.htm" accesskey="H">Home</a></td> 177 178 <td width="33%" align="right" valign="top"><a href= 179 "jobfiles.htm" accesskey="N">Next</a></td> 180 </tr> 181 182 <tr> 183 <td width="33%" align="left" valign="top">Spool Control 184 File</td> 185 186 <td width="34%" align="center" valign="top"><a href= 187 "spoolqueue.htm" accesskey="U">Up</a></td> 188 189 <td width="33%" align="right" valign="top">Job Files</td> 190 </tr> 191 </table> 192 </div> 193 </body> 194</html> 195 196