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>Configuring Format and Displayed Information</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="lpq - Status Monitoring Program " href=
12    "lpq.htm">
13    <link rel="PREVIOUS" title="Job Taking Too Long - Stalled "
14    href="stalledtime.htm">
15    <link rel="NEXT" title="lprm - Job Removal Program " href=
16    "lprm.htm">
17  </head>
18
19  <body class="SECT1" bgcolor="#FFFFFF" text="#000000" link=
20  "#0000FF" vlink="#840084" alink="#0000FF">
21    <div class="NAVHEADER">
22      <table summary="Header navigation table" width="100%" border=
23      "0" cellpadding="0" cellspacing="0">
24        <tr>
25          <th colspan="3" align="center">LPRng Reference Manual: 5
26          Sep 2003 (For LPRng-3.8.22)</th>
27        </tr>
28
29        <tr>
30          <td width="10%" align="left" valign="bottom"><a href=
31          "stalledtime.htm" accesskey="P">Prev</a></td>
32
33          <td width="80%" align="center" valign="bottom">Chapter 7.
34          <b class="APPLICATION">lpq</b> - Status Monitoring
35          Program</td>
36
37          <td width="10%" align="right" valign="bottom"><a href=
38          "lprm.htm" accesskey="N">Next</a></td>
39        </tr>
40      </table>
41      <hr align="LEFT" width="100%">
42    </div>
43
44    <div class="SECT1">
45      <h1 class="SECT1"><a name="AEN4619">7.7. Configuring Format
46      and Displayed Information</a></h1>
47
48      <p>The following sections describe options that are used by
49      the <b class="APPLICATION">lpd</b> server to control how it
50      will return status information to a <b class=
51      "APPLICATION">lpq</b> request.</p>
52
53      <div class="SECT2">
54        <h2 class="SECT2"><a name="CLASSINSTATUS">7.7.1. Display
55        Class Information</a></h2>
56
57        <p>Options used:</p>
58
59        <ul>
60          <li>
61            <p><var class="LITERAL">class_in_status</var> FLAG
62            <span class="emphasis"><i class="EMPHASIS">show class
63            name in status</i></span></p>
64          </li>
65        </ul>
66        <br>
67        <br>
68
69        <p>Setting the <var class="LITERAL">class_in_status</var>
70        option causes the class name rather than priority to be
71        displayed in the status information.</p>
72      </div>
73
74      <div class="SECT2">
75        <h2 class="SECT2"><a name="REVERSELPQFORMAT">7.7.2. Reverse
76        Short and Long <b class="APPLICATION">lpq</b>
77        Formats</a></h2>
78
79        <p>Options used:</p>
80
81        <ul>
82          <li>
83            <p><var class="LITERAL">reverse_lpq_format=</var> FLAG
84            <span class="emphasis"><i class="EMPHASIS">reverse <b
85            class="APPLICATION">lpq</b> status format for specified
86            remote systems</i></span></p>
87          </li>
88        </ul>
89        <br>
90        <br>
91
92        <p>Various Solaris and other System V implementations
93        support an RFC1179 interface to remote printers.
94        Unfortunately, there is a problem in that when they send a
95        status request, the status format is reversed. That is,
96        when LONG status format is wanted, they send SHORT, and
97        vice versa.</p>
98
99        <p>The <var class="LITERAL">reverse_lpq_format=</var>
100        specifies a list of printers or IP addresses for which the
101        <b class="APPLICATION">lpd</b> server will return LONG
102        status when SHORT is requested, and vice versa. For
103        example:</p>
104
105        <div class="INFORMALEXAMPLE">
106          <a name="AEN4648"></a>
107<pre class="SCREEN">
108    reverse_lpq_format=*.eng.com,130.192.0.0/16
109</pre>
110        </div>
111        <br>
112        <br>
113
114        <p>will cause hosts whose Fully Qualified Domain Name
115        (FQDN) ends in <tt class="FILENAME">eng.com</tt> or from
116        subnet <var class="LITERAL">130.192.0.0</var> to have
117        reversed status returned.</p>
118      </div>
119
120      <div class="SECT2">
121        <h2 class="SECT2"><a name="SHORTSTATUS">7.7.3. Status Line
122        Length and Line Count</a></h2>
123
124        <p>Options used:</p>
125
126        <ul>
127          <li>
128            <p><var class="LITERAL">return_short_status=</var><span
129            class="emphasis"><i class="EMPHASIS">return short <b
130            class="APPLICATION">lpq</b> status for specified remote
131            systems</i></span></p>
132          </li>
133
134          <li>
135            <p><var class="LITERAL">short_status_length=</var><span
136            class="emphasis"><i class="EMPHASIS">short <b class=
137            "APPLICATION">lpq</b> status length in
138            lines</i></span></p>
139          </li>
140        </ul>
141        <br>
142        <br>
143
144        <p>In order to be compatible with non-<b class=
145        "APPLICATION">LPRng</b> client programs, some
146        administrators would like <b class="APPLICATION">lpd</b> to
147        return a short or brief status to normal status
148        queries.</p>
149
150        <p>The <var class="LITERAL">return_short_status=</var>
151        specifies a list of printers or IP addresses for which the
152        <b class="APPLICATION">lpd</b> server will return an
153        abbreviated status when LONG status is requested. For
154        example:</p>
155
156        <div class="INFORMALEXAMPLE">
157          <a name="AEN4673"></a>
158<pre class="SCREEN">
159    return_short_status=*.eng.com,130.192.0.0/16
160    short_status_length#3
161</pre>
162        </div>
163        <br>
164        <br>
165
166        <p>will cause hosts whose Fully Qualified Domain Name
167        (FQDN) ends in <tt class="FILENAME">eng.com</tt> or from
168        subnet <var class="LITERAL">130.192.0.0</var> to get only 3
169        lines of detailed status returned.</p>
170      </div>
171
172      <div class="SECT2">
173        <h2 class="SECT2"><a name="FORCELPQSTATUS">7.7.4. <b class=
174        "APPLICATION">lpq</b> Status Format Determined by
175        Requesting Host Address</a></h2>
176
177        <p>Options used:</p>
178
179        <ul>
180          <li>
181            <p><var class="LITERAL">force_lpq_status=</var><span
182            class="emphasis"><i class="EMPHASIS">force <b class=
183            "APPLICATION">lpq</b> status format for specified
184            remote systems</i></span></p>
185          </li>
186        </ul>
187        <br>
188        <br>
189
190        <p>In order to be compatible with non-<b class=
191        "APPLICATION">LPRng</b> client programs which are totally
192        unpredictable, this allows the administrator to specify the
193        format for <b class="APPLICATION">lpq</b> status when
194        requests arrive.</p>
195
196        <p>The <var class="LITERAL">force_lpq_status=</var>
197        specifies a list of formats and printers or IP addresses
198        for which the <b class="APPLICATION">lpd</b> server will
199        return status in the specified format. The entry has the
200        format <var class="LITERAL">KEY=list;KEY=list...</var>
201        where <acronym class="ACRONYM">KEY</acronym> is <var class=
202        "LITERAL">s</var> for short and <var class=
203        "LITERAL">l</var> for long format, and list is a list of
204        hosts or IP addresses. For example:</p>
205
206        <div class="INFORMALEXAMPLE">
207          <a name="AEN4698"></a>
208<pre class="SCREEN">
209    force_lpq_status=s=pc*.eng.com,130.192.12.0/24,l=sun*.eng.com
210</pre>
211        </div>
212        <br>
213        <br>
214
215        <p>will cause hosts whose Fully Qualified Domain Name
216        (FQDN) matches <tt class="FILENAME">pc*eng.com</tt> or from
217        subnet <var class="LITERAL">130.192.12.0</var> to get short
218        status returned and hosts which match <tt class=
219        "FILENAME">sun*.eng.com</tt> get long status.</p>
220      </div>
221    </div>
222
223    <div class="NAVFOOTER">
224      <hr align="LEFT" width="100%">
225
226      <table summary="Footer navigation table" width="100%" border=
227      "0" cellpadding="0" cellspacing="0">
228        <tr>
229          <td width="33%" align="left" valign="top"><a href=
230          "stalledtime.htm" accesskey="P">Prev</a></td>
231
232          <td width="34%" align="center" valign="top"><a href=
233          "index.htm" accesskey="H">Home</a></td>
234
235          <td width="33%" align="right" valign="top"><a href=
236          "lprm.htm" accesskey="N">Next</a></td>
237        </tr>
238
239        <tr>
240          <td width="33%" align="left" valign="top">Job Taking Too
241          Long - Stalled</td>
242
243          <td width="34%" align="center" valign="top"><a href=
244          "lpq.htm" accesskey="U">Up</a></td>
245
246          <td width="33%" align="right" valign="top"><b class=
247          "APPLICATION">lprm</b> - Job Removal Program</td>
248        </tr>
249      </table>
250    </div>
251  </body>
252</html>
253
254