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>Control File Contents</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="Data File Transfer" href= 14 "x10191.htm"> 15 <link rel="NEXT" title="lpq Requests" href="x10430.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 "x10191.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 "x10430.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="AEN10227">19.5. Control File 44 Contents</a></h1> 45 46 <p>The control file consists of a set of lines which either 47 provide printing information or specify data files to be 48 printed. The information lines start with upper case letters 49 or digits, while the data files lines start with lower case 50 letters. Here is a sample control file:</p> 51 52 <div class="INFORMALEXAMPLE"> 53 <a name="AEN10230"></a> 54<pre class="SCREEN"> 55 Hh4.private 56 J(stdin) 57 CA 58 Lpapowell 59 Apapowell@h4+955 60 Ppapowell 61 fdfA955h4.private 62 N(stdin) 63 UdfA955h4.private 64</pre> 65 </div> 66 <br> 67 <br> 68 69 <p>The following are the letters and their meanings in the 70 control file.</p> 71 72 <div class="TABLE"> 73 <a name="CFLINES"></a> 74 75 <p><b>Table 19-2. Control File Lines and Purpose</b></p> 76 77 <table border="1" frame="border" rules="all" class= 78 "CALSTABLE"> 79 <col> 80 <col> 81 <col> 82 83 <thead> 84 <tr> 85 <th>Letter</th> 86 87 <th>Defined</th> 88 89 <th>Purpose</th> 90 </tr> 91 </thead> 92 93 <tbody> 94 <tr> 95 <td>A</td> 96 97 <td><b class="APPLICATION">LPRng</b></td> 98 99 <td>Identifier for job</td> 100 </tr> 101 102 <tr> 103 <td>C</td> 104 105 <td>RFC1179</td> 106 107 <td>Class for banner page</td> 108 </tr> 109 110 <tr> 111 <td>H</td> 112 113 <td>RFC1179</td> 114 115 <td>Host name</td> 116 </tr> 117 118 <tr> 119 <td>I</td> 120 121 <td>RFC1179</td> 122 123 <td>Indent Printing</td> 124 </tr> 125 126 <tr> 127 <td>J</td> 128 129 <td>RFC1179</td> 130 131 <td>Job name for banner page</td> 132 </tr> 133 134 <tr> 135 <td>L</td> 136 137 <td>RFC1179</td> 138 139 <td>Print banner page</td> 140 </tr> 141 142 <tr> 143 <td>M</td> 144 145 <td>RFC1179</td> 146 147 <td>Mail When Printed</td> 148 </tr> 149 150 <tr> 151 <td>N</td> 152 153 <td>RFC1179</td> 154 155 <td>Name of source file</td> 156 </tr> 157 158 <tr> 159 <td>P</td> 160 161 <td>RFC1179</td> 162 163 <td>User identification</td> 164 </tr> 165 166 <tr> 167 <td>Q</td> 168 169 <td><b class="APPLICATION">LPRng</b></td> 170 171 <td>Queue name</td> 172 </tr> 173 174 <tr> 175 <td>R</td> 176 177 <td><b class="APPLICATION">LPRng</b></td> 178 179 <td>Accounting info</td> 180 </tr> 181 182 <tr> 183 <td>S</td> 184 185 <td>RFC1179</td> 186 187 <td>Symbolic link data</td> 188 </tr> 189 190 <tr> 191 <td>T</td> 192 193 <td>RFC1179</td> 194 195 <td>Title for pr</td> 196 </tr> 197 198 <tr> 199 <td>U</td> 200 201 <td>RFC1179</td> 202 203 <td>Unlink data file</td> 204 </tr> 205 206 <tr> 207 <td>W</td> 208 209 <td>RFC1179</td> 210 211 <td>Width of output</td> 212 </tr> 213 214 <tr> 215 <td>Z</td> 216 217 <td><b class="APPLICATION">LPRng</b></td> 218 219 <td>Filter options</td> 220 </tr> 221 222 <tr> 223 <td>1</td> 224 225 <td>RFC1179</td> 226 227 <td>troff R font</td> 228 </tr> 229 230 <tr> 231 <td>2</td> 232 233 <td>RFC1179</td> 234 235 <td>troff I font</td> 236 </tr> 237 238 <tr> 239 <td>3</td> 240 241 <td>RFC1179</td> 242 243 <td>troff B font</td> 244 </tr> 245 246 <tr> 247 <td>4</td> 248 249 <td>RFC1179</td> 250 251 <td>troff S font</td> 252 </tr> 253 254 <tr> 255 <td>c</td> 256 257 <td>RFC1179</td> 258 259 <td>Plot CIF file</td> 260 </tr> 261 262 <tr> 263 <td>d</td> 264 265 <td>RFC1179</td> 266 267 <td>Print DVI file</td> 268 </tr> 269 270 <tr> 271 <td>f</td> 272 273 <td>RFC1179</td> 274 275 <td>Print formatted file</td> 276 </tr> 277 278 <tr> 279 <td>g</td> 280 281 <td>RFC1179</td> 282 283 <td>Plot file</td> 284 </tr> 285 286 <tr> 287 <td>k</td> 288 289 <td>RFC1179</td> 290 291 <td>Reserved for use by Kerberized <b class= 292 "APPLICATION">LPRng</b> clients and servers.</td> 293 </tr> 294 295 <tr> 296 <td>l</td> 297 298 <td>RFC1179</td> 299 300 <td>Print file leaving control characters</td> 301 </tr> 302 303 <tr> 304 <td>n</td> 305 306 <td>RFC1179</td> 307 308 <td>Print ditroff output file</td> 309 </tr> 310 311 <tr> 312 <td>o</td> 313 314 <td>RFC1179</td> 315 316 <td>Print Postscript output file</td> 317 </tr> 318 319 <tr> 320 <td>p</td> 321 322 <td>RFC1179</td> 323 324 <td>Print file with 'pr' format</td> 325 </tr> 326 327 <tr> 328 <td>t</td> 329 330 <td>RFC1179</td> 331 332 <td>Print troff output file</td> 333 </tr> 334 335 <tr> 336 <td>v</td> 337 338 <td>RFC1179</td> 339 340 <td>Print raster file</td> 341 </tr> 342 343 <tr> 344 <td>z</td> 345 346 <td>RFC1179</td> 347 348 <td>Reserved for future use with the Palladium print 349 system.</td> 350 </tr> 351 </tbody> 352 </table> 353 </div> 354 355 <p>The <var class="LITERAL">A</var> (Identifier) line was 356 introduced to record a unique system wide job identifier for 357 <b class="APPLICATION">LPRng</b> submitted jobs. This is 358 basically formed from the user name, job number, and host at 359 the time of submission. For example: <var class= 360 "LITERAL">papowell@h4+955</var> is job number 995 submitted 361 by papowell from host h4.</p> 362 363 <p>The <var class="LITERAL">C</var> (Class) line is set by 364 the <tt class="COMMAND">lpr -C class</tt> option, and the 365 value can be used to control printing. For example, the <tt 366 class="COMMAND">lpc class zone</tt> command would restrict 367 job printing to only jobs with class <var class= 368 "LITERAL">zone</var>.</p> 369 370 <p>The <var class="LITERAL">H</var> (hostname), <var class= 371 "LITERAL">P</var> (username), and <var class= 372 "LITERAL">J</var> (jobname) fields are used to identify the 373 host and user which sent the job, and to provide information 374 to be displayed by <b class="APPLICATION">lpq</b> when 375 reporting job status.</p> 376 377 <p>The <var class="LITERAL">L</var> (print banner page) field 378 is one that has caused many problems for users. RFC1179 379 indicates that its presence causes the banner page to be 380 printed, and its absence suppresses banner pages. The <tt 381 class="COMMAND">lpr -h</tt> option suppresses putting this 382 line into the control file. Usually the <var class= 383 "LITERAL">L</var> field is a duplicate of the <var class= 384 "LITERAL">P</var> field.</p> 385 386 <p>The <var class="LITERAL">M</var> (mail information) field 387 supplies a mail address for <b class="APPLICATION">LPRng</b> 388 to send mail to when a job is completed. See <a href= 389 "jobcompletion.htm">Job Completion Notification Requested</a> 390 for more details.</p> 391 392 <p>The <var class="LITERAL">N</var> (file name) field is 393 usually provided to identify the file name corresponding to 394 the data file. This can be used to print names on page 395 separators, etc. <b class="APPLICATION">LPRng</b> largely 396 ignores this line.</p> 397 398 <p>The <var class="LITERAL">I</var> (indent) and <var class= 399 "LITERAL">W</var> (width) fields are supposed to specify a 400 page indent and width for printing. These fields are passed 401 to filters if they are present.</p> 402 403 <p>The <var class="LITERAL">Q</var> (queue name) field is an 404 <b class="APPLICATION">LPRng</b> extension, and contains the 405 name of the print queue the job was originally sent to. See 406 <a href="qq.htm">qq printcap option</a> for details.</p> 407 408 <p>The <var class="LITERAL">R</var> (accounting info) field 409 was added by <b class="APPLICATION">LPRng</b> to allow a 410 specified account to be billed for job printing. The <tt 411 class="COMMAND">lpr -Rname</tt> option can be used to specify 412 the accounting name.</p> 413 414 <p>The <var class="LITERAL">S</var> (symbolic link) and <var 415 class="LITERAL">U</var> (unlink after printing) lines were 416 used by the original BSD <b class="APPLICATION">lpd</b> print 417 system to control how it passed files to the print server. <b 418 class="APPLICATION">LPRng</b> ignores these lines. In fact, 419 it will remove <var class="LITERAL">S</var> lines and force 420 the <var class="LITERAL">U</var> lines to refer only to job 421 data files. This closes a nasty security loophole on non-<b 422 class="APPLICATION">LPRng</b> print spoolers.</p> 423 424 <p>The <var class="LITERAL">T</var> (pr job title) is used 425 with the <tt class="COMMAND">lpr -p</tt> operation to supply 426 a banner to the <var class="LITERAL">pr</var> program.</p> 427 428 <p>The <var class="LITERAL">Z</var> (filter options) value is 429 specified with <tt class="COMMAND">lpr -Zoption</tt> and is 430 passed to the data file filters during the printing 431 operation. See <a href="filters.htm">Filters</a> for details 432 on how the this is used during the printing process.</p> 433 434 <p>All of the lower case letters are reserved for format 435 specifications for data files. In the control file, these are 436 followed by the name of the data file to which they 437 correspond. While in principle different data files in the 438 control file can have different formats, this has not been 439 implemented in any known spooling system. See <a href= 440 "filters.htm">Filters</a> for details on how the data file 441 formats are used during the printing process.</p> 442 </div> 443 444 <div class="NAVFOOTER"> 445 <hr align="LEFT" width="100%"> 446 447 <table summary="Footer navigation table" width="100%" border= 448 "0" cellpadding="0" cellspacing="0"> 449 <tr> 450 <td width="33%" align="left" valign="top"><a href= 451 "x10191.htm" accesskey="P">Prev</a></td> 452 453 <td width="34%" align="center" valign="top"><a href= 454 "index.htm" accesskey="H">Home</a></td> 455 456 <td width="33%" align="right" valign="top"><a href= 457 "x10430.htm" accesskey="N">Next</a></td> 458 </tr> 459 460 <tr> 461 <td width="33%" align="left" valign="top">Data File 462 Transfer</td> 463 464 <td width="34%" align="center" valign="top"><a href= 465 "rfc1179ref.htm" accesskey="U">Up</a></td> 466 467 <td width="33%" align="right" valign="top"><b class= 468 "APPLICATION">lpq</b> Requests</td> 469 </tr> 470 </table> 471 </div> 472 </body> 473</html> 474 475