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>LPC Requests</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="RFC 1179 - Line Printer Daemon Protocol " 12 href="rfc1179ref.htm"> 13 <link rel="PREVIOUS" title="lprm Requests" href="x10453.htm"> 14 <link rel="NEXT" title="Block Job Transfer" href= 15 "sendblockformat.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 "x10453.htm" accesskey="P">Prev</a></td> 31 32 <td width="80%" align="center" valign="bottom">Chapter 33 19. RFC 1179 - Line Printer Daemon Protocol</td> 34 35 <td width="10%" align="right" valign="bottom"><a href= 36 "sendblockformat.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="LPCREREAD">19.8. LPC 44 Requests</a></h1> 45 46 <p><b class="APPLICATION">LPRng</b> has extended the RFC1179 47 protocol to allow queue and printer control commands to be 48 sent to the <b class="APPLICATION">lpd</b> server. The format 49 of these commands are:</p> 50 51 <div class="INFORMALEXAMPLE"> 52 <a name="AEN10474"></a> 53<pre class="SCREEN"> 54 \006printer user key [options] 55</pre> 56 </div> 57 <br> 58 <br> 59 60 <p>The following commands are supported.</p> 61 62 <div class="TABLE"> 63 <a name="LPCCOMMANDS"></a> 64 65 <p><b>Table 19-3. LPC Commands</b></p> 66 67 <table border="1" frame="border" rules="all" class= 68 "CALSTABLE"> 69 <col> 70 <col> 71 72 <thead> 73 <tr> 74 <th>Command</th> 75 76 <th>Operation</th> 77 </tr> 78 </thead> 79 80 <tbody> 81 <tr> 82 <td>Command</td> 83 84 <td>Operation</td> 85 </tr> 86 87 <tr> 88 <td><var class="LITERAL">active 89 [printer[@host]]</var></td> 90 91 <td>check to see if server accepting connections</td> 92 </tr> 93 94 <tr> 95 <td><var class="LITERAL">abort (printer[@host] | 96 all)</var> </td> 97 98 <td>terminate server process printing job</td> 99 </tr> 100 101 <tr> 102 <td><var class="LITERAL">disable (printer[@host] | 103 all)</var> </td> 104 105 <td>disable queueing</td> 106 </tr> 107 108 <tr> 109 <td><var class="LITERAL">debug (printer[@host] | all) 110 debugparms</var> </td> 111 112 <td>set debug level for printer</td> 113 </tr> 114 115 <tr> 116 <td><var class="LITERAL">enable (printer[@host] | 117 all)</var> </td> 118 119 <td>enable queueing</td> 120 </tr> 121 122 <tr> 123 <td><var class="LITERAL">hold (printer[@host] | all) 124 (name[@host] | job | all)*</var> </td> 125 126 <td>hold job</td> 127 </tr> 128 129 <tr> 130 <td><var class="LITERAL">holdall (printer[@host] | 131 all)</var> </td> 132 133 <td>hold all jobs on</td> 134 </tr> 135 136 <tr> 137 <td><var class="LITERAL">kill (printer[@host] | 138 all)</var> </td> 139 140 <td>stop and restart server</td> 141 </tr> 142 143 <tr> 144 <td><var class="LITERAL">lpd [printer[@host]]</var> 145 </td> 146 147 <td>get <b class="APPLICATION">lpd</b> PID for 148 server</td> 149 </tr> 150 151 <tr> 152 <td><var class="LITERAL">lpq (printer[@host] | all) 153 (name[@host] | job | all)*</var> </td> 154 155 <td>invoke <b class="APPLICATION">lpq</b></td> 156 </tr> 157 158 <tr> 159 <td><var class="LITERAL">lprm (printer[@host] | all) 160 (name[@host]|host|job| all)*</var> </td> 161 162 <td>invoke <b class="APPLICATION">lprm</b></td> 163 </tr> 164 165 <tr> 166 <td><var class="LITERAL">move printer (user|jobid)* 167 target</var> </td> 168 169 <td>move jobs to new queue</td> 170 </tr> 171 172 <tr> 173 <td><var class="LITERAL">noholdall (printer[@host] | 174 all)</var> </td> 175 176 <td>hold all jobs off</td> 177 </tr> 178 179 <tr> 180 <td><var class="LITERAL">printcap (printer[@host] | 181 all)</var> </td> 182 183 <td>report printcap values</td> 184 </tr> 185 186 <tr> 187 <td><var class="LITERAL">quit</var> </td> 188 189 <td>exit LPC</td> 190 </tr> 191 192 <tr> 193 <td><var class="LITERAL">redirect (printer[@host] | 194 all) (printer@host | off )*</var> </td> 195 196 <td>redirect jobs</td> 197 </tr> 198 199 <tr> 200 <td><var class="LITERAL">release (printer[@host] | 201 all) (name[@host] | job | all)*</var> </td> 202 203 <td>release job</td> 204 </tr> 205 206 <tr> 207 <td><var class="LITERAL">reread 208 [printer[@host]]</var></td> 209 210 <td><b class="APPLICATION">lpd</b> reread database 211 information</td> 212 </tr> 213 214 <tr> 215 <td><var class="LITERAL">start (printer[@host] | 216 all)</var> </td> 217 218 <td>start printing</td> 219 </tr> 220 221 <tr> 222 <td><var class="LITERAL">status (printer[@host] | 223 all)</var> </td> 224 225 <td>status of printers</td> 226 </tr> 227 228 <tr> 229 <td><var class="LITERAL">stop (printer[@host] | 230 all)</var> </td> 231 232 <td>stop printing</td> 233 </tr> 234 235 <tr> 236 <td><var class="LITERAL">topq (printer[@host] | all) 237 (name[@host] | job | all)*</var> </td> 238 239 <td>reorder job</td> 240 </tr> 241 242 <tr> 243 <td><var class="LITERAL">defaultq</var> </td> 244 245 <td>default queue for <b class="APPLICATION">lpd</b> 246 server</td> 247 </tr> 248 249 <tr> 250 <td><var class="LITERAL">local (printer | all)</var> 251 </td> 252 253 <td>client printcap and configuration 254 information</td> 255 </tr> 256 257 <tr> 258 <td><var class="LITERAL">server (printer | all)</var> 259 </td> 260 261 <td>server printcap and configuration 262 information</td> 263 </tr> 264 </tbody> 265 </table> 266 </div> 267 268 <p>Many of these commands support extremely specialized 269 operations for print queue management, However, the following 270 are the most commonly used and are supported by the BSD <b 271 class="APPLICATION">lpd</b> print spooling system as 272 well:</p> 273 274 <ul> 275 <li> 276 <p><var class="LITERAL">start, stop, enable, 277 disable</var> Start and stop will start and stop printing 278 for a specified queue. Enable and disable enable and 279 disable sending and/or accepting jobs for the queue.</p> 280 </li> 281 282 <li> 283 <p><var class="LITERAL">abort, kill</var> Abort will 284 cause the process doing the actual job printing to be 285 terminated. Kill does an abort, and then restarts the 286 printing process. These commands are used to restart a 287 queue printing after some disaster.</p> 288 </li> 289 290 <li> 291 <p><var class="LITERAL">topq</var> Places selected jobs 292 at the top of the print queue.</p> 293 </li> 294 295 <li> 296 <p><var class="LITERAL">status</var> Shows a status 297 display of the print spools on the server.</p> 298 </li> 299 </ul> 300 <br> 301 <br> 302 303 <p>The following commands are extensions to the basic set 304 provided by the BSD <b class="APPLICATION">lpd</b> 305 system.</p> 306 307 <ul> 308 <li> 309 <p><var class="LITERAL">lpq, lprm</var> Invokes the lpq 310 or lprm program from lpc. Useful when in the interactive 311 mode.</p> 312 </li> 313 314 <li> 315 <p><var class="LITERAL">hold, holdall, release</var> The 316 hold command will cause the selected jobs to be held 317 until released. The holdall jobs sets all jobs submitted 318 to the queue to be held until released. The release 319 command releases jobs for printing. If a job has had an 320 error and is in the error state, the release command will 321 cause it to be reprinted.</p> 322 </li> 323 324 <li> 325 <p><var class="LITERAL">move, redirect</var> The move 326 command will move selected jobs to the specified spool 327 queue. The redirect command sends all jobs submitted to 328 the queue to be sent to the specified queue.</p> 329 </li> 330 331 <li> 332 <p><var class="LITERAL">active, lpd, reread</var> The 333 active command will connect to the server for the 334 printer. This is used to check to see if non-<b class= 335 "APPLICATION">LPRng</b> print servers are active. The lpd 336 command will connect to the server and get the process id 337 (PID) of the <b class="APPLICATION">lpd</b> server. The 338 reread command causes a SIGHUP signal to be sent to the 339 lpd process, causing it to reread the <tt class= 340 "FILENAME">lpd.conf</tt>, <tt class= 341 "FILENAME">printcap</tt>, and <tt class= 342 "FILENAME">lpd.perms</tt> files. This is done when 343 configuration information has been modified and the 344 administrator wants to have the server use the new 345 information.</p> 346 </li> 347 348 <li> 349 <p><var class="LITERAL">debug</var> This is a desperation 350 facility for developers that allows dynamic enabling of 351 debug information generation. Not normally used in 352 general operation.</p> 353 </li> 354 355 <li> 356 <p><var class="LITERAL">local, server</var> These 357 commands will print out the configuration information in 358 the local <tt class="FILENAME">lpd.conf</tt> file, as 359 well as the printcap information for the specified 360 printers; <var class="LITERAL">client</var> prints what 361 the <b class="APPLICATION">LPRng</b> clients (<var class= 362 "LITERAL">lpr, lpq, ...</var>) would use while <var 363 class="LITERAL">server</var> prints what the <b class= 364 "APPLICATION">LPRng</b> server (<b class= 365 "APPLICATION">lpd</b>) would use if running on this host. 366 This is an extremely useful diagnostic tool for 367 administrators. Not normally used in general 368 operation.</p> 369 </li> 370 </ul> 371 <br> 372 <br> 373 </div> 374 375 <div class="NAVFOOTER"> 376 <hr align="LEFT" width="100%"> 377 378 <table summary="Footer navigation table" width="100%" border= 379 "0" cellpadding="0" cellspacing="0"> 380 <tr> 381 <td width="33%" align="left" valign="top"><a href= 382 "x10453.htm" accesskey="P">Prev</a></td> 383 384 <td width="34%" align="center" valign="top"><a href= 385 "index.htm" accesskey="H">Home</a></td> 386 387 <td width="33%" align="right" valign="top"><a href= 388 "sendblockformat.htm" accesskey="N">Next</a></td> 389 </tr> 390 391 <tr> 392 <td width="33%" align="left" valign="top"><b class= 393 "APPLICATION">lprm</b> Requests</td> 394 395 <td width="34%" align="center" valign="top"><a href= 396 "rfc1179ref.htm" accesskey="U">Up</a></td> 397 398 <td width="33%" align="right" valign="top">Block Job 399 Transfer</td> 400 </tr> 401 </table> 402 </div> 403 </body> 404</html> 405 406