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>Spool Control File</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="Queue Lock File " href= 14 "queuelockfile.htm"> 15 <link rel="NEXT" title="Log and Status Files " href= 16 "logfiles.htm"> 17 </head> 18 19 <body class="SECT1" bgcolor="#FFFFFF" text="#000000" link= 20 "#0000FF" vlink="#840084" alink="#0000FF"> 21 <div class="NAVHEADER"> 22 <table summary="Header navigation table" width="100%" border= 23 "0" cellpadding="0" cellspacing="0"> 24 <tr> 25 <th colspan="3" align="center">LPRng Reference Manual: 5 26 Sep 2003 (For LPRng-3.8.22)</th> 27 </tr> 28 29 <tr> 30 <td width="10%" align="left" valign="bottom"><a href= 31 "queuelockfile.htm" accesskey="P">Prev</a></td> 32 33 <td width="80%" align="center" valign="bottom">Chapter 34 13. Spool Queues and Files</td> 35 36 <td width="10%" align="right" valign="bottom"><a href= 37 "logfiles.htm" accesskey="N">Next</a></td> 38 </tr> 39 </table> 40 <hr align="LEFT" width="100%"> 41 </div> 42 43 <div class="SECT1"> 44 <h1 class="SECT1"><a name="QUEUECONTROLFILE">13.3. Spool 45 Control File</a></h1> 46 47 <ul> 48 <li> 49 <p><var class="LITERAL">spool_control_file</var><span 50 class="emphasis"><i class="EMPHASIS">spool queue control 51 file - default control.%P</i></span></p> 52 </li> 53 </ul> 54 <br> 55 <br> 56 57 <p>The spool control file is used to control the operations 58 of the spooler, and is in the spool or control directory. The 59 file name specified by the <var class= 60 "LITERAL">queue_control_file</var> option (default <var 61 class="LITERAL">control.%P</var> - the %P is expanded to the 62 print queue name); in our example, the control file would be: 63 <tt class="FILENAME">/var/lpd/pr/control.pr</tt>.</p> 64 65 <p>The <b class="APPLICATION">lpc</b> program sends spool 66 control requests to the <b class="APPLICATION">lpd</b> 67 daemon, which updates the control file and then signals the 68 appropriate spool server processes that an update has been 69 performed. The control file contents have the form:</p> 70 71 <div class="INFORMALEXAMPLE"> 72 <a name="AEN6356"></a> 73<pre class="SCREEN"> 74 key value 75</pre> 76 </div> 77 <br> 78 <br> 79 80 <p>The following keys and their values are currently 81 supported.</p> 82 83 <div class="INFORMALTABLE"> 84 <a name="AEN6359"></a> 85 86 <table border="1" frame="border" rules="all" class= 87 "CALSTABLE"> 88 <col> 89 <col> 90 <col> 91 92 <thead> 93 <tr> 94 <th>Key</th> 95 96 <th>Value</th> 97 98 <th>Purpose</th> 99 </tr> 100 </thead> 101 102 <tbody> 103 <tr> 104 <td><var class="LITERAL">printing_disabled</var></td> 105 106 <td>0 or 1</td> 107 108 <td>disable printing of jobs in queue</td> 109 </tr> 110 111 <tr> 112 <td><var class="LITERAL">spooling_disabled</var></td> 113 114 <td>0 or 1</td> 115 116 <td>disable placing jobs in queue</td> 117 </tr> 118 119 <tr> 120 <td><var class="LITERAL">holdall</var></td> 121 122 <td>0 or 1</td> 123 124 <td>hold jobs until released</td> 125 </tr> 126 127 <tr> 128 <td><var class="LITERAL">redirect</var></td> 129 130 <td><var class="LITERAL">printer</var></td> 131 132 <td>transfer jobs to indicated printer</td> 133 </tr> 134 135 <tr> 136 <td><var class="LITERAL">class</var></td> 137 138 <td><var class="LITERAL">glob expression</var></td> 139 140 <td>print only jobs whose class matches glob 141 expression</td> 142 </tr> 143 144 <tr> 145 <td><var class="LITERAL">server_order</var></td> 146 147 <td><var class="LITERAL">printer name list</var></td> 148 149 <td>preferred order of printer use</td> 150 </tr> 151 152 <tr> 153 <td><var class="LITERAL">debug</var></td> 154 155 <td><var class="LITERAL">debugging options</var></td> 156 157 <td>debugging and tracing</td> 158 </tr> 159 </tbody> 160 </table> 161 </div> 162 163 <p>The <var class="LITERAL">printing_disabled</var> and <var 164 class="LITERAL">spooling_disabled</var> are managed using the 165 <tt class="COMMAND">lpc start</tt>, <tt class="COMMAND">lpc 166 stop</tt>, <tt class="COMMAND">lpc enable</tt> and <tt class= 167 "COMMAND">lpc disable</tt> commands. Similarly, <var class= 168 "LITERAL">holdall</var> is enabled and disabled by <var 169 class="LITERAL">holdall</var> and <var class= 170 "LITERAL">noholdall</var> commands respectively. When holdall 171 is enabled, jobs placed in the print queue will be held until 172 they are explicitly released for printing by an <tt class= 173 "COMMAND">lpc release</tt> command.</p> 174 175 <p>The <var class="LITERAL">redirect</var> entry is used to 176 redirect or transfer jobs which are spooled to this queue to 177 another queue, and is managed by the redirect command. The 178 <tt class="COMMAND">lpc redirect off</tt> removes the 179 redirect entry from the control file.</p> 180 181 <p>The <var class="LITERAL">class</var> entry is similar in 182 operation to the <var class="LITERAL">holdall</var>, but 183 allows jobs whose class identification matches the glob 184 expression to be printed. This can be useful when you have 185 special forms or paper required for a print job, and want to 186 run only these jobs when the paper is in the printer.</p> 187 188 <p>The <var class="LITERAL">server_order</var> entry is 189 created and updated for a multiple printer queue. It records 190 the order in which printers should next be used for normal 191 print operations. This allows <span class="emphasis"><i 192 class="EMPHASIS">round robin</i></span> use of printers, 193 rather than having all jobs printed to the first printer in 194 the list of printers.</p> 195 196 <p>The <var class="LITERAL">debug</var> entry is set by the 197 <tt class="COMMAND">lpc debug</tt> command, and is used to 198 enable or disable debugging and tracing information for a 199 spool queue. This facility is for diagnostic purposes 200 only.</p> 201 </div> 202 203 <div class="NAVFOOTER"> 204 <hr align="LEFT" width="100%"> 205 206 <table summary="Footer navigation table" width="100%" border= 207 "0" cellpadding="0" cellspacing="0"> 208 <tr> 209 <td width="33%" align="left" valign="top"><a href= 210 "queuelockfile.htm" accesskey="P">Prev</a></td> 211 212 <td width="34%" align="center" valign="top"><a href= 213 "index.htm" accesskey="H">Home</a></td> 214 215 <td width="33%" align="right" valign="top"><a href= 216 "logfiles.htm" accesskey="N">Next</a></td> 217 </tr> 218 219 <tr> 220 <td width="33%" align="left" valign="top">Queue Lock 221 File</td> 222 223 <td width="34%" align="center" valign="top"><a href= 224 "spoolqueue.htm" accesskey="U">Up</a></td> 225 226 <td width="33%" align="right" valign="top">Log and Status 227 Files</td> 228 </tr> 229 </table> 230 </div> 231 </body> 232</html> 233 234