File: x4566.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 (247 lines) | stat: -rw-r--r-- 8,383 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
242
243
244
245
246
247
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <meta name="generator" content="HTML Tidy, see www.w3.org">
    <title>Configuring Format and Displayed Information</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="lpq - Status Monitoring Program " href=
    "lpq.htm">
    <link rel="PREVIOUS" title="Job Taking Too Long - Stalled "
    href="stalledtime.htm">
    <link rel="NEXT" title="lprm - Job Removal Program " href=
    "lprm.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=
          "stalledtime.htm" accesskey="P">Prev</a></td>

          <td width="80%" align="center" valign="bottom">Chapter 7.
          <b class="APPLICATION">lpq</b> - Status Monitoring
          Program</td>

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

    <div class="SECT1">
      <h1 class="SECT1"><a name="AEN4566">7.7. Configuring Format
      and Displayed Information</a></h1>

      <p>The following sections describe options that are used by
      the <b class="APPLICATION">lpd</b> server to control how it
      will return status information to a <b class=
      "APPLICATION">lpq</b> request.</p>

      <div class="SECT2">
        <h2 class="SECT2"><a name="CLASSINSTATUS">7.7.1. Display
        Class Information</a></h2>

        <p>Options used:</p>

        <ul>
          <li>
            <p><tt class="LITERAL">class_in_status</tt> FLAG <i
            class="EMPHASIS">show class name in status</i></p>
          </li>
        </ul>
        <br>
        <br>

        <p>Setting the <tt class="LITERAL">class_in_status</tt>
        option causes the class name rather than priority to be
        displayed in the status information.</p>
      </div>

      <div class="SECT2">
        <h2 class="SECT2"><a name="REVERSELPQFORMAT">7.7.2. Reverse
        Short and Long <b class="APPLICATION">lpq</b>
        Formats</a></h2>

        <p>Options used:</p>

        <ul>
          <li>
            <p><tt class="LITERAL">reverse_lpq_format=</tt> FLAG <i
            class="EMPHASIS">reverse <b class="APPLICATION">lpq</b>
            status format for specified remote systems</i></p>
          </li>
        </ul>
        <br>
        <br>

        <p>Various Solaris and other System V implementations
        support an RFC1179 interface to remote printers.
        Unfortunately, there is a problem in that when they send a
        status request, the status format is reversed. That is,
        when LONG status format is wanted, they send SHORT, and
        vice versa.</p>

        <p>The <tt class="LITERAL">reverse_lpq_format=</tt>
        specifies a list of printers or IP addresses for which the
        <b class="APPLICATION">lpd</b> server will return LONG
        status when SHORT is requested, and vice versa. For
        example:</p>

        <div class="INFORMALEXAMPLE">
          <a name="AEN4595"></a>
<pre class="SCREEN">
    reverse_lpq_format=*.eng.com,130.192.0.0/16
</pre>
        </div>
        <br>
        <br>

        <p>will cause hosts whose Fully Qualified Domain Name
        (FQDN) ends in <tt class="FILENAME">eng.com</tt> or from
        subnet <tt class="LITERAL">130.192.0.0</tt> to have
        reversed status returned.</p>
      </div>

      <div class="SECT2">
        <h2 class="SECT2"><a name="SHORTSTATUS">7.7.3. Status Line
        Length and Line Count</a></h2>

        <p>Options used:</p>

        <ul>
          <li>
            <p><tt class="LITERAL">return_short_status=</tt><i
            class="EMPHASIS">return short <b class=
            "APPLICATION">lpq</b> status for specified remote
            systems</i></p>
          </li>

          <li>
            <p><tt class="LITERAL">short_status_length=</tt><i
            class="EMPHASIS">short <b class="APPLICATION">lpq</b>
            status length in lines</i></p>
          </li>
        </ul>
        <br>
        <br>

        <p>In order to be compatible with non-<b class=
        "APPLICATION">LPRng</b> client programs, some
        administrators would like <b class="APPLICATION">lpd</b> to
        return a short or brief status to normal status
        queries.</p>

        <p>The <tt class="LITERAL">return_short_status=</tt>
        specifies a list of printers or IP addresses for which the
        <b class="APPLICATION">lpd</b> server will return an
        abbreviated status when LONG status is requested. For
        example:</p>

        <div class="INFORMALEXAMPLE">
          <a name="AEN4620"></a>
<pre class="SCREEN">
    return_short_status=*.eng.com,130.192.0.0/16
    short_status_length#3
</pre>
        </div>
        <br>
        <br>

        <p>will cause hosts whose Fully Qualified Domain Name
        (FQDN) ends in <tt class="FILENAME">eng.com</tt> or from
        subnet <tt class="LITERAL">130.192.0.0</tt> to get only 3
        lines of detailed status returned.</p>
      </div>

      <div class="SECT2">
        <h2 class="SECT2"><a name="FORCELPQSTATUS">7.7.4. <b class=
        "APPLICATION">lpq</b> Status Format Determined by
        Requesting Host Address</a></h2>

        <p>Options used:</p>

        <ul>
          <li>
            <p><tt class="LITERAL">force_lpq_status=</tt><i class=
            "EMPHASIS">force <b class="APPLICATION">lpq</b> status
            format for specified remote systems</i></p>
          </li>
        </ul>
        <br>
        <br>

        <p>In order to be compatible with non-<b class=
        "APPLICATION">LPRng</b> client programs which are totally
        unpredictable, this allows the administrator to specify the
        format for <b class="APPLICATION">lpq</b> status when
        requests arrive.</p>

        <p>The <tt class="LITERAL">force_lpq_status=</tt> specifies
        a list of formats and printers or IP addresses for which
        the <b class="APPLICATION">lpd</b> server will return
        status in the specified format. The entry has the format
        <tt class="LITERAL">KEY=list;KEY=list...</tt> where <span
        class="ACRONYM">KEY</span> is <tt class="LITERAL">s</tt>
        for short and <tt class="LITERAL">l</tt> for long format,
        and list is a list of hosts or IP addresses. For
        example:</p>

        <div class="INFORMALEXAMPLE">
          <a name="AEN4645"></a>
<pre class="SCREEN">
    force_lpq_status=s=pc*.eng.com,130.192.12.0/24,l=sun*.eng.com
</pre>
        </div>
        <br>
        <br>

        <p>will cause hosts whose Fully Qualified Domain Name
        (FQDN) matches <tt class="FILENAME">pc*eng.com</tt> or from
        subnet <tt class="LITERAL">130.192.12.0</tt> to get short
        status returned and hosts which match <tt class=
        "FILENAME">sun*.eng.com</tt> get long status.</p>
      </div>
    </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=
          "stalledtime.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=
          "lprm.htm" accesskey="N">Next</a></td>
        </tr>

        <tr>
          <td width="33%" align="left" valign="top">Job Taking Too
          Long - Stalled</td>

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

          <td width="33%" align="right" valign="top"><b class=
          "APPLICATION">lprm</b> - Job Removal Program</td>
        </tr>
      </table>
    </div>
  </body>
</html>