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