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