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