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>lpr - Job Spooler Program</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="PREVIOUS" title="User Identification " href= 12 "allowusersetting.htm"> 13 <link rel="NEXT" title= 14 "Job Pretty Printing, Banners, Priority, and Accounting" href= 15 "x4267.htm"> 16 </head> 17 18 <body class="CHAPTER" 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 "allowusersetting.htm" accesskey="P">Prev</a></td> 31 32 <td width="80%" align="center" valign="bottom"> 33 </td> 34 35 <td width="10%" align="right" valign="bottom"><a href= 36 "x4267.htm" accesskey="N">Next</a></td> 37 </tr> 38 </table> 39 <hr align="LEFT" width="100%"> 40 </div> 41 42 <div class="CHAPTER"> 43 <h1><a name="LPR"></a>Chapter 6. <b class= 44 "APPLICATION">lpr</b> - Job Spooler Program</h1> 45 46 <div class="TOC"> 47 <dl> 48 <dt><b>Table of Contents</b></dt> 49 50 <dt>6.1. <a href="lpr.htm#DEFAULTFORMAT">Job Format 51 Options</a></dt> 52 53 <dt>6.2. <a href="x4267.htm">Job Pretty Printing, 54 Banners, Priority, and Accounting</a></dt> 55 56 <dt>6.3. <a href="classpriority.htm">Job Class and 57 Priority</a></dt> 58 59 <dt>6.4. <a href="jobcopies.htm">Job Copies and Job 60 Size</a></dt> 61 62 <dt>6.5. <a href="jobcompletion.htm">Job Completion 63 Notification Requested</a></dt> 64 65 <dt>6.6. <a href="x4373.htm">Remove Files After 66 Spooling</a></dt> 67 68 <dt>6.7. <a href="append-z.htm">The -Z Passthrough to 69 Filter Options</a></dt> 70 71 <dt>6.8. <a href="qq.htm">Record Queue Name in Control 72 File</a></dt> 73 74 <dt>6.9. <a href="checkfornonprintable.htm">Check For 75 Nonprintable File</a></dt> 76 77 <dt>6.10. <a href="lprbounce.htm">Job Filtering By 78 LPR</a></dt> 79 80 <dt>6.11. <a href="rg.htm">Restrict Queue Use to Group 81 Members</a></dt> 82 83 <dt>6.12. <a href="safechars.htm">Fixing Bad Control 84 Files and Metacharacters</a></dt> 85 86 <dt>6.13. <a href="minfree.htm">Minimum Spool Queue Free 87 Space</a></dt> 88 89 <dt>6.14. <a href="forcefqdnhostname.htm">FQDN Host 90 Information</a></dt> 91 </dl> 92 </div> 93 94 <p>The <b class="APPLICATION">lpr</b> client program is used 95 to submit a job to a print spooler. It does this by 96 collecting information about the job, putting it in a control 97 file, and then sending the control file and files to be 98 printed to the print server. The <b class= 99 "APPLICATION">lpr</b> command line options are used to 100 control or specify the values placed in the control file and 101 how the job is to be transferred to the remote host. In 102 addition, there are printcap or configuration level options 103 that provide a further degree of administrative control over 104 additional facilities. You can get the currently supported 105 command line options by using the following command:</p> 106 107 <div class="INFORMALEXAMPLE"> 108 <a name="AEN4226"></a> 109<pre class="SCREEN"> 110 <samp class="PROMPT">h4: {305} %</samp> <kbd class= 111"USERINPUT">lpr -=</kbd> 112 lpr: Illegal option '=' 113 usage summary: lpr [-Pprinter[@host]] [-A] [-B] [-Cclass] [-Fformat] 114 [-Jinfo] [-(K|#)copies] [-Q] [-Raccountname] [-Ttitle] 115 [-Uuser[@host]] [-V] [-Zoptions] [-b] [-m mailaddr] [-h] 116 [-i indent] [-l] [-w num ] [-r] [-Ddebugopt ] [ filenames ... ] 117 -A - use authentication specified by AUTH environment variable 118 -B - filter job before sending 119 -C class - job class 120 -D debugopt - debugging flags 121 -F format - job format 122 -b,-l - binary or literal format 123 c,d,f,g,l,m,p,t,v are also format options 124 -J info - banner and job information 125 -K copies, -# copies - number of copies 126 -P printer[@host] - printer on host 127 -Q - put 'queuename' in control file 128 -Raccntname - accounting information 129 -T title - title for 'pr' (-p) formatting 130 -U username - override user name (restricted) 131 -V - Verbose information during spooling 132 -Z options - options to pass to filter 133 -h - no header or banner page 134 -i indent - indentation 135 -m mailaddr - mail final status to mailaddr 136 -r - remove files after spooling 137 -w width - width to use 138 PRINTER, NPRINTER environment variables set default printer. 139</pre> 140 </div> 141 <br> 142 <br> 143 144 <p>If you are interested in the exact details of the job 145 transfer, control file, and data file formats, please see <a 146 href="rfc1179ref.htm">RFC 1179 - Line Printer Daemon 147 Protocol</a> for the exact details.</p> 148 149 <div class="SECT1"> 150 <h1 class="SECT1"><a name="DEFAULTFORMAT">6.1. Job Format 151 Options</a></h1> 152 153 <p>Options used:</p> 154 155 <ul> 156 <li> 157 <p><var class="LITERAL">default_format=</var><span 158 class="emphasis"><i class="EMPHASIS">default print job 159 format (f)</i></span></p> 160 </li> 161 162 <li> 163 <p><var class="LITERAL">fx=</var><span class= 164 "emphasis"><i class="EMPHASIS">supported formats for 165 printing</i></span></p> 166 </li> 167 </ul> 168 <br> 169 <br> 170 171 <p>The legacy or vintage BSD print spooling system assigned 172 each job a format. This format was used by the <b class= 173 "APPLICATION">lpd</b> server to select an appropriate 174 filter program that would process the job and format it 175 correctly for the printer. By convention, lower case 176 letters were used to specify job formats.</p> 177 178 <p>The <b class="APPLICATION">LPRng</b> <b class= 179 "APPLICATION">lpr</b> client supports the legacy or vintage 180 BSD formats, and also provides the <var class= 181 "LITERAL">-Fx</var> literal to allow addition formats to be 182 specified. If a format is specified the <var class= 183 "LITERAL">default_format</var> value (usually <var class= 184 "LITERAL">f</var>) is used. The <var class= 185 "LITERAL">fx=...</var> option value is a list of the (lower 186 case) characters corresponding to the formats allowed for a 187 spool queue. For example, <var class="LITERAL">fx=flv</var> 188 would allow only jobs with format <var class= 189 "LITERAL">f</var>, <var class="LITERAL">l</var>, or <var 190 class="LITERAL">v</var> to be spooled to a queue. By 191 default, all job formats are allowed.</p> 192 193 <p>A couple of job formats that require special treatment: 194 the <var class="LITERAL">b</var> (binary) and its alias the 195 <var class="LITERAL">l</var> (literal) format, and the <var 196 class="LITERAL">p</var> (pretty print) format. The <var 197 class="LITERAL">-b</var> or <var class="LITERAL">-l</var> 198 command line literal will select job format <var class= 199 "LITERAL">l</var> (literal) for the job. By default, jobs 200 marked with <var class="LITERAL">l</var> format are 201 supposed to have a minimum amount of handling and passed 202 directly to a printer. The <var class="LITERAL">p</var> 203 (pretty print) format is just the opposite - these jobs are 204 supposed to be pretty printed according to the various 205 facilities available to the <b class="APPLICATION">lpd</b> 206 print spooler.</p> 207 </div> 208 </div> 209 210 <div class="NAVFOOTER"> 211 <hr align="LEFT" width="100%"> 212 213 <table summary="Footer navigation table" width="100%" border= 214 "0" cellpadding="0" cellspacing="0"> 215 <tr> 216 <td width="33%" align="left" valign="top"><a href= 217 "allowusersetting.htm" accesskey="P">Prev</a></td> 218 219 <td width="34%" align="center" valign="top"><a href= 220 "index.htm" accesskey="H">Home</a></td> 221 222 <td width="33%" align="right" valign="top"><a href= 223 "x4267.htm" accesskey="N">Next</a></td> 224 </tr> 225 226 <tr> 227 <td width="33%" align="left" valign="top">User 228 Identification</td> 229 230 <td width="34%" align="center" valign="top"> </td> 231 232 <td width="33%" align="right" valign="top">Job Pretty 233 Printing, Banners, Priority, and Accounting</td> 234 </tr> 235 </table> 236 </div> 237 </body> 238</html> 239 240