File: queuecontrolfile.htm

package info (click to toggle)
lprng 3.8.10-1.2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 13,076 kB
  • ctags: 4,348
  • sloc: ansic: 35,394; sh: 10,756; perl: 2,210; makefile: 1,046
file content (241 lines) | stat: -rw-r--r-- 8,294 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <meta name="generator" content="HTML Tidy, see www.w3.org">
    <title>Spool Control File</title>
    <meta name="GENERATOR" content=
    "Modular DocBook HTML Stylesheet Version 1.71 ">
    <link rel="HOME" title=" LPRng-HOWTO" href="index.htm">
    <link rel="UP" title="Spool Queues and Files" href=
    "spoolqueue.htm">
    <link rel="PREVIOUS" title="Queue Lock File " href=
    "queuelockfile.htm">
    <link rel="NEXT" title="Log and Status Files " href=
    "logfiles.htm">
  </head>

  <body class="SECT1" bgcolor="#FFFFFF" text="#000000" link=
  "#0000FF" vlink="#840084" alink="#0000FF">
    <div class="NAVHEADER">
      <table summary="Header navigation table" width="100%" border=
      "0" cellpadding="0" cellspacing="0">
        <tr>
          <th colspan="3" align="center">LPRng-HOWTO: 1 Apr 2002
          (For LPRng-3.8.10)</th>
        </tr>

        <tr>
          <td width="10%" align="left" valign="bottom"><a href=
          "queuelockfile.htm" accesskey="P">Prev</a></td>

          <td width="80%" align="center" valign="bottom">Chapter
          13. Spool Queues and Files</td>

          <td width="10%" align="right" valign="bottom"><a href=
          "logfiles.htm" accesskey="N">Next</a></td>
        </tr>
      </table>
      <hr align="LEFT" width="100%">
    </div>

    <div class="SECT1">
      <h1 class="SECT1"><a name="QUEUECONTROLFILE">13.3. Spool
      Control File</a></h1>

      <ul>
        <li>
          <p><tt class="LITERAL">spool_control_file</tt><i class=
          "EMPHASIS">spool queue control file - default
          control.%P</i></p>
        </li>
      </ul>
      <br>
      <br>

      <p>The spool control file is used to control the operations
      of the spooler, and is in the spool or control directory. The
      file name specified by the <tt class=
      "LITERAL">queue_control_file</tt> option (default <tt class=
      "LITERAL">control.%P</tt> - the %P is expanded to the print
      queue name); in our example, the control file would be: <tt
      class="FILENAME">/var/lpd/pr/control.pr</tt>.</p>

      <p>The <b class="APPLICATION">lpc</b> program sends spool
      control requests to the <b class="APPLICATION">lpd</b>
      daemon, which updates the control file and then signals the
      appropriate spool server processes that an update has been
      performed. The control file contents have the form:</p>

      <div class="INFORMALEXAMPLE">
        <a name="AEN6303"></a>
<pre class="SCREEN">
    key value
</pre>
      </div>
      <br>
      <br>

      <p>The following keys and their values are currently
      supported.</p>

      <div class="INFORMALTABLE">
        <a name="AEN6306"></a>

        <table border="1" class="CALSTABLE">
          <thead>
            <tr>
              <th align="LEFT" valign="TOP">Key</th>

              <th align="LEFT" valign="TOP">Value</th>

              <th align="LEFT" valign="TOP">Purpose</th>
            </tr>
          </thead>

          <tbody>
            <tr>
              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">printing_disabled</tt></td>

              <td align="LEFT" valign="TOP">0 or 1</td>

              <td align="LEFT" valign="TOP">disable printing of
              jobs in queue</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">spooling_disabled</tt></td>

              <td align="LEFT" valign="TOP">0 or 1</td>

              <td align="LEFT" valign="TOP">disable placing jobs in
              queue</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">holdall</tt></td>

              <td align="LEFT" valign="TOP">0 or 1</td>

              <td align="LEFT" valign="TOP">hold jobs until
              released</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">redirect</tt></td>

              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">printer</tt></td>

              <td align="LEFT" valign="TOP">transfer jobs to
              indicated printer</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">class</tt></td>

              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">glob expression</tt></td>

              <td align="LEFT" valign="TOP">print only jobs whose
              class matches glob expression</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">server_order</tt></td>

              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">printer name list</tt></td>

              <td align="LEFT" valign="TOP">preferred order of
              printer use</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">debug</tt></td>

              <td align="LEFT" valign="TOP"><tt class=
              "LITERAL">debugging options</tt></td>

              <td align="LEFT" valign="TOP">debugging and
              tracing</td>
            </tr>
          </tbody>
        </table>
      </div>

      <p>The <tt class="LITERAL">printing_disabled</tt> and <tt
      class="LITERAL">spooling_disabled</tt> are managed using the
      <tt class="COMMAND">lpc start</tt>, <tt class="COMMAND">lpc
      stop</tt>, <tt class="COMMAND">lpc enable</tt> and <tt class=
      "COMMAND">lpc disable</tt> commands. Similarly, <tt class=
      "LITERAL">holdall</tt> is enabled and disabled by <tt class=
      "LITERAL">holdall</tt> and <tt class="LITERAL">noholdall</tt>
      commands respectively. When holdall is enabled, jobs placed
      in the print queue will be held until they are explicitly
      released for printing by an <tt class="COMMAND">lpc
      release</tt> command.</p>

      <p>The <tt class="LITERAL">redirect</tt> entry is used to
      redirect or transfer jobs which are spooled to this queue to
      another queue, and is managed by the redirect command. The
      <tt class="COMMAND">lpc redirect off</tt> removes the
      redirect entry from the control file.</p>

      <p>The <tt class="LITERAL">class</tt> entry is similar in
      operation to the <tt class="LITERAL">holdall</tt>, but allows
      jobs whose class identification matches the glob expression
      to be printed. This can be useful when you have special forms
      or paper required for a print job, and want to run only these
      jobs when the paper is in the printer.</p>

      <p>The <tt class="LITERAL">server_order</tt> entry is created
      and updated for a multiple printer queue. It records the
      order in which printers should next be used for normal print
      operations. This allows <i class="EMPHASIS">round robin</i>
      use of printers, rather than having all jobs printed to the
      first printer in the list of printers.</p>

      <p>The <tt class="LITERAL">debug</tt> entry is set by the <tt
      class="COMMAND">lpc debug</tt> command, and is used to enable
      or disable debugging and tracing information for a spool
      queue. This facility is for diagnostic purposes only.</p>
    </div>

    <div class="NAVFOOTER">
      <hr align="LEFT" width="100%">

      <table summary="Footer navigation table" width="100%" border=
      "0" cellpadding="0" cellspacing="0">
        <tr>
          <td width="33%" align="left" valign="top"><a href=
          "queuelockfile.htm" accesskey="P">Prev</a></td>

          <td width="34%" align="center" valign="top"><a href=
          "index.htm" accesskey="H">Home</a></td>

          <td width="33%" align="right" valign="top"><a href=
          "logfiles.htm" accesskey="N">Next</a></td>
        </tr>

        <tr>
          <td width="33%" align="left" valign="top">Queue Lock
          File</td>

          <td width="34%" align="center" valign="top"><a href=
          "spoolqueue.htm" accesskey="U">Up</a></td>

          <td width="33%" align="right" valign="top">Log and Status
          Files</td>
        </tr>
      </table>
    </div>
  </body>
</html>