]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/sum.html
Merge changes from 1.1.x into 1.2 devel.
[thirdparty/cups.git] / doc / sum.html
CommitLineData
902da432 1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
c8475f2d 2<HTML>
3<HEAD>
b5cb0608 4<TITLE>CUPS Software Users Manual</TITLE>
97ae2a96 5<META NAME="author" CONTENT="Easy Software Products">
6<META NAME="copyright" CONTENT="Copyright 1997-2001, All Rights Reserved">
b5cb0608 7<META NAME="docnumber" CONTENT="CUPS-SUM-1.1.7">
97ae2a96 8<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso-8859-1">
baee2cec 9<STYLE TYPE="text/css"><!--
b5cb0608 10BODY { font-family: serif }
11H1 { font-family: sans-serif }
12H2 { font-family: sans-serif }
13H3 { font-family: sans-serif }
14H4 { font-family: sans-serif }
15H5 { font-family: sans-serif }
16H6 { font-family: sans-serif }
17SUB { font-size: smaller }
18SUP { font-size: smaller }
19PRE { font-family: monospace }
97ae2a96 20--></STYLE>
c8475f2d 21</HEAD>
ecf3075f 22<BODY BGCOLOR="#ffffff">
b5cb0608 23<CENTER><A HREF="#CONTENTS"><IMG SRC="images/cups-large.gif" BORDER="0" WIDTH="431" HEIGHT="511"><BR>
24<H1>CUPS Software Users Manual</H1></A><BR>
25CUPS-SUM-1.1.7<BR>
6a921799 26Easy Software Products<BR>
d0e6f0a0 27Copyright 1997-2001, All Rights Reserved<BR>
6a921799 28</CENTER>
29<HR>
97ae2a96 30<H1 ALIGN="CENTER"><A NAME="CONTENTS">Table of Contents</A></H1>
baee2cec 31<BR>
32<BR><B><A HREF="#1">Preface</A></B>
97ae2a96 33<UL>
34<LI><A HREF="#1_1">System Overview</A></LI>
35<LI><A HREF="#1_2">Document Overview</A></LI>
36<LI><A HREF="#1_3">Notation Conventions</A></LI>
37<LI><A HREF="#1_4">Abbreviations</A></LI>
38<LI><A HREF="#1_5">Other References</A></LI>
04d756fc 39</UL>
97ae2a96 40<B><A HREF="#OVERVIEW">1 - Printing System Overview</A></B>
04d756fc 41<UL>
97ae2a96 42<LI><A HREF="#2_1">The Printing Problem</A></LI>
43<LI><A HREF="#2_2">The Technology</A></LI>
44<LI><A HREF="#2_3">Jobs</A></LI>
45<LI><A HREF="#2_4">Classes</A></LI>
46<LI><A HREF="#2_5">Filters</A></LI>
47<LI><A HREF="#2_6">Backends</A></LI>
48<LI><A HREF="#2_7">Printer Drivers</A></LI>
49<LI><A HREF="#2_8">Networking</A></LI>
04d756fc 50</UL>
97ae2a96 51<B><A HREF="#USING_SYSTEM">2 - Using the Printing System</A></B>
04d756fc 52<UL>
97ae2a96 53<LI><A HREF="#3_1">Submitting Files for Printing</A></LI>
54<LI><A HREF="#3_2">Choosing a Printer</A></LI>
55<LI><A HREF="#3_3">Setting Printer Options</A></LI>
56<LI><A HREF="#3_4">Printing Multiple Copies</A></LI>
57<LI><A HREF="#3_5">Checking the Printer Status from the Command-Line</A></LI>
58<LI><A HREF="#3_6">Checking the Printer Status from the Web</A></LI>
59<LI><A HREF="#3_7">Canceling a Print Job</A></LI>
04d756fc 60</UL>
97ae2a96 61<B><A HREF="#STANDARD_OPTIONS">3 - Standard Printer Options</A></B>
04d756fc 62<UL>
97ae2a96 63<LI><A HREF="#4_1">General Options</A></LI>
04d756fc 64<UL>
97ae2a96 65<LI><A HREF="#4_1_1">Setting the Orientation</A></LI>
66<LI><A HREF="#4_1_2">Selecting the Media Size, Type, and Source</A></LI>
67<LI><A HREF="#4_1_3">Printing On Both Sides of the Paper</A></LI>
04d756fc 68</UL>
97ae2a96 69<LI><A HREF="#4_2">Banner Options</A></LI>
04d756fc 70<UL>
97ae2a96 71<LI><A HREF="#4_2_1">Selecting the Banner Page(s)</A></LI>
04d756fc 72</UL>
97ae2a96 73<LI><A HREF="#4_3">Document Options</A></LI>
04d756fc 74<UL>
97ae2a96 75<LI><A HREF="#4_3_1">Selecting a Range of Pages</A></LI>
76<LI><A HREF="#4_3_2">Selecting Even or Odd Pages</A></LI>
77<LI><A HREF="#4_3_3">N-Up Printing</A></LI>
78<LI><A HREF="#4_3_4">Setting the Brightness</A></LI>
79<LI><A HREF="#4_3_5">Setting the Gamma Correction</A></LI>
04d756fc 80</UL>
97ae2a96 81<LI><A HREF="#4_4">Text Options</A></LI>
04d756fc 82<UL>
97ae2a96 83<LI><A HREF="#4_4_1">Setting the Number of Characters Per Inch</A></LI>
84<LI><A HREF="#4_4_2">Setting the Number of Lines Per Inch</A></LI>
85<LI><A HREF="#4_4_3">Setting the Number of Columns</A></LI>
86<LI><A HREF="#4_4_4">Setting the Page Margins</A></LI>
87<LI><A HREF="#4_4_5">Pretty Printing</A></LI>
04d756fc 88</UL>
97ae2a96 89<LI><A HREF="#4_5">Image Options</A></LI>
04d756fc 90<UL>
97ae2a96 91<LI><A HREF="#4_5_1">Positioning the Image</A></LI>
92<LI><A HREF="#4_5_2">Scaling the Image</A></LI>
93<LI><A HREF="#4_5_3">Adjusting the Hue (Tint) of an Image</A></LI>
94<LI><A HREF="#4_5_4">Adjusting the Saturation (Color) of an Image</A></LI>
04d756fc 95</UL>
97ae2a96 96<LI><A HREF="#4_6">HP-GL/2 Options</A></LI>
04d756fc 97<UL>
97ae2a96 98<LI><A HREF="#4_6_1">Printing in Black</A></LI>
99<LI><A HREF="#4_6_2">Fitting the Plot on the Page</A></LI>
100<LI><A HREF="#4_6_3">Setting the Default Pen Width</A></LI>
04d756fc 101</UL>
97ae2a96 102<LI><A HREF="#4_7">Raw or Unfiltered Output</A></LI>
04d756fc 103</UL>
97ae2a96 104<B><A HREF="#SAVING_OPTIONS">4 - Saving Printer Options and Defaults</A></B>
04d756fc 105<UL>
97ae2a96 106<LI><A HREF="#5_1">Printer Options</A></LI>
107<LI><A HREF="#5_2">Setting Options for a Specific Printer</A></LI>
108<LI><A HREF="#5_3">Viewing the Current Defaults</A></LI>
109<LI><A HREF="#5_4">Setting the Default Printer</A></LI>
110<LI><A HREF="#5_5">Printer Instances</A></LI>
111<LI><A HREF="#5_6">Removing Instances</A></LI>
04d756fc 112</UL>
97ae2a96 113<B><A HREF="#LICENSE">A - Software License Agreement</A></B>
04d756fc 114<UL>
97ae2a96 115<LI><A HREF="#6_1">Common UNIX Printing System License Agreement</A></LI>
04d756fc 116<UL>
97ae2a96 117<LI><A HREF="#6_1_1">Introduction</A></LI>
118<LI><A HREF="#6_1_2">Trademarks</A></LI>
119<LI><A HREF="#6_1_3">Binary Distribution Rights</A></LI>
120<LI><A HREF="#6_1_4">Support</A></LI>
121</UL>
122<LI><A HREF="#6_2">GNU GENERAL PUBLIC LICENSE</A></LI>
123<LI><A HREF="#6_3">GNU LIBRARY GENERAL PUBLIC LICENSE</A></LI>
41f765f4 124</UL>
125<HR>
97ae2a96 126<H1 ALIGN="RIGHT"><A NAME="1">Preface</A></H1>
753453e4 127<P>This software users manual describes how to use the Common UNIX
128 Printing &lt;&lt;&lt;&lt;&lt;&lt;&lt; sum.shtml System<SUP>TM</SUP> (&quot;CUPS<SUP>TM</SUP>&quot;)
129 Version 1.1.7. ======= System<SUP>TM</SUP> (&quot;CUPS<SUP>TM</SUP>&quot;)
130 Version 1.1.13. &gt;&gt;&gt;&gt;&gt;&gt;&gt; 1.29</P>
97ae2a96 131<H2><A NAME="1_1">System Overview</A></H2>
753453e4 132<P>CUPS provides a portable printing layer for UNIX&reg;-based operating
133 systems. It has been developed by<A HREF="http://www.easysw.com"> Easy
134 Software Products</A> to promote a standard printing solution for all
135 UNIX vendors and users. CUPS provides the System V and Berkeley
136 command-line interfaces.</P>
137<P>CUPS uses the Internet Printing Protocol (&quot;IPP&quot;) as the basis for
138 managing print jobs and queues. The Line Printer Daemon (&quot;LPD&quot;) Server
139 Message Block (&quot;SMB&quot;), and AppSocket (a.k.a. JetDirect) protocols are
140 also supported with reduced functionality. CUPS adds network printer
141 browsing and PostScript Printer Description (&quot;PPD&quot;) based printing
142 options to support real-world printing under UNIX.</P>
143<P>CUPS also includes a customized version of GNU Ghostscript (currently
144 based off GNU Ghostscript 5.50) and an image file RIP that are used to
145 support non-PostScript printers. Sample drivers for HP and EPSON
146 printers are included that use these filters.</P>
ecf3075f 147
97ae2a96 148<!-- NEED 2in -->
97ae2a96 149<H2><A NAME="1_2">Document Overview</A></H2>
150<P>This software users manual is organized into the following sections:</P>
151<UL>
152<LI><A HREF="#OVERVIEW">1 - Printing System Overview</A></LI>
153<LI><A HREF="#USING_SYSTEM">2 - Using the Printing System</A></LI>
154<LI><A HREF="#STANDARD_OPTIONS">3 - Standard Printer Options</A></LI>
155<LI><A HREF="#SAVING_OPTIONS">4 - Saving Printer Options and Defaults</A>
156</LI>
157<LI><A HREF="#LICENSE">A - Software License Agreement</A></LI>
158</UL>
159<H2><A NAME="1_3">Notation Conventions</A></H2>
753453e4 160<P>Various font and syntax conventions are used in this guide. Examples
161 and their meanings and uses are explained below:
ecf3075f 162<CENTER>
163<TABLE WIDTH="80%">
97ae2a96 164<TR><TH>Example</TH><TD>&nbsp;&nbsp;&nbsp;</TD><TH>Description</TH></TR>
165<TR><TD>&nbsp;</TD></TR>
166<TR VALIGN="TOP"><TD><CODE>lpstat</CODE>
753453e4 167<BR> <CODE>lpstat(1)</CODE></TD><TD>&nbsp;&nbsp;&nbsp;</TD><TD>The names of commands;
168 the first mention of a command or function in a chapter is followed by
169 a manual page section number.</TD></TR>
97ae2a96 170<TR><TD>&nbsp;</TD></TR>
171<TR VALIGN="TOP"><TD><VAR>/var</VAR>
baee2cec 172<BR><VAR> /usr/share/cups/data/testprint.ps</VAR></TD><TD>&nbsp;&nbsp;&nbsp;</TD><TD>
97ae2a96 173File and directory names.</TD></TR>
174<TR><TD>&nbsp;</TD></TR>
175<TR VALIGN="TOP"><TD NOWRAP><TT>Request ID is Printer-123</TT></TD><TD>
176&nbsp;&nbsp;&nbsp;</TD><TD>Screen output.</TD></TR>
177<TR><TD>&nbsp;</TD></TR>
178<TR VALIGN="TOP"><TD NOWRAP><KBD>lp -d printer filename ENTER</KBD></TD><TD>
753453e4 179&nbsp;&nbsp;&nbsp;</TD><TD>Literal user input; special keys like <KBD>ENTER</KBD> are
97ae2a96 180 in ALL CAPS.</TD></TR>
181<TR><TD>&nbsp;</TD></TR>
753453e4 182<TR VALIGN="TOP"><TD>12.3</TD><TD>&nbsp;&nbsp;&nbsp;</TD><TD>Numbers in the text are
183 written using the period (.) to indicate the decimal point.</TD></TR>
ecf3075f 184</TABLE>
185</CENTER>
186
97ae2a96 187<!-- NEED 3in -->
ef56e874 188</P>
97ae2a96 189<H2><A NAME="1_4">Abbreviations</A></H2>
753453e4 190 The following abbreviations are used throughout this manual:
ecf3075f 191<UL>
192<DL>
753453e4 193<DT>kb</DT>
97ae2a96 194<DD>Kilobytes, or 1024 bytes
753453e4 195<BR>&nbsp;</DD>
196<DT>Mb</DT>
97ae2a96 197<DD>Megabytes, or 1048576 bytes
753453e4 198<BR>&nbsp;</DD>
199<DT>Gb</DT>
97ae2a96 200<DD>Gigabytes, or 1073741824 bytes
753453e4 201<BR>&nbsp;</DD>
ecf3075f 202</DL>
203</UL>
97ae2a96 204<H2><A NAME="1_5">Other References</A></H2>
ecf3075f 205<UL>
206<DL>
753453e4 207<DT>CUPS Software Administrators Manual</DT>
97ae2a96 208<DD>An administration guide for the CUPS software.
753453e4 209<BR>&nbsp;</DD>
210<DT>CUPS Software Programmers Manual</DT>
211<DD>A programmer guide for interfacing with and/or extending the CUPS
97ae2a96 212 software.
753453e4 213<BR>&nbsp;</DD>
ecf3075f 214</DL>
c8475f2d 215</UL>
97ae2a96 216<H1 ALIGN="RIGHT"><A NAME="OVERVIEW">1 - Printing System Overview</A></H1>
753453e4 217<P>This chapter provides an overview of how the Common UNIX Printing
218 System works.</P>
97ae2a96 219<H2><A NAME="2_1">The Printing Problem</A></H2>
753453e4 220<P>For years<I> the printing problem</I> has plagued UNIX. Unlike
221 Microsoft&reg; Windows&reg; or Mac OS, UNIX has no standard interface or system
222 in place for supporting printers. Among the solutions currently
223 available, the Berkeley and System V printing systems are the most
224 prevalent.</P>
225<P>These printing systems support line printers (text only) or
226 PostScript printers (text and graphics), and with some coaxing they can
227 be made to support a full range of printers and file formats. However,
228 because each varient of the UNIX operating system uses a different
229 printing system than the next developing printer drivers for a wide
230 range of printers and operating systems is extremely difficult. That
231 combined with the limited volume of customers for each UNIX varient has
232 forced most printer vendors to give up supporting UNIX entirely.</P>
233<P>CUPS is designed to eliminate<I> the printing problem</I>. One common
234 printing system can be used by all UNIX varients to support the
235 printing needs of users. Printer vendors can use its modular filter
236 interface to develop a single driver program that supports a wide range
237 of file formats with little or no effort. Since CUPS provides both the
238 System V and Berkeley printing commands, users (and applications) can
239 reap the benefits of this new technology with no changes.</P>
97ae2a96 240<H2><A NAME="2_2">The Technology</A></H2>
753453e4 241<P>CUPS is based upon an emerging Internet standard called the Internet
242 Printing Protocol. IPP has been embraced by dozens of printer and
243 printer server manufacturers and is supported by Microsoft Windows
244 2000.</P>
245<P>IPP defines a standard protocol for printing as well as managing
246 print jobs and printer options like media size, resolution, and so
247 forth. Like all IP-based protocols, IPP can be used locally or over the
248 Internet to printers hundreds or thousands of miles away. Unlike other
249 protocols, however, IPP also supports access control, authentication,
250 and encryption, making it a much more capable and secure printing
251 solution than older ones.</P>
252<P>IPP is layered on top of the Hyper-Text Transport Protocol (&quot;HTTP&quot;)
253 which is the basis of web servers on the Internet. This allows users to
254 view documentation, check status information on a printer or server,
255 and manage their printers, classes, and jobs using their web browser.</P>
256<P>CUPS provides a complete IPP/1.1 based printing system that provides
257 Basic, Digest, and local certificate authentication and user, domain,
258 or IP-based access control. TLS encryption will be available in future
259 versions of CUPS.</P>
97ae2a96 260<H2><A NAME="2_3">Jobs</A></H2>
753453e4 261<P>Each file or set of files that is submitted for printing is called a<I>
262 job</I>. Jobs are identified by a unique number starting at 1 and are
263 assigned to a particular destination, usually a printer. Jobs can also
264 have options associated with them such as media size, number of copies,
265 and priority.</P>
97ae2a96 266<H2><A NAME="2_4">Classes</A></H2>
753453e4 267<P>CUPS supports collections of printers known as<I> classes</I>. Jobs
268 sent to a class are forwarded to the first available printer in the
269 class.</P>
97ae2a96 270<H2><A NAME="2_5">Filters</A></H2>
753453e4 271<P>Filters allow a user or application to print many types of files
272 without extra effort. Print jobs sent to a CUPS server are filtered
273 before sending them to a printer. Some filters convert job files to
274 different formats that the printer can understand. Others perform page
275 selection and ordering tasks.</P>
276<P>CUPS provides filters for printing many types of image files, HP-GL/2
277 files, PDF files, and text files. CUPS also supplies PostScript and
278 image file Raster Image Processor (&quot;RIP&quot;) filters that convert
279 PostScript or image files into bitmaps that can be sent to a raster
280 printer.</P>
97ae2a96 281<H2><A NAME="2_6">Backends</A></H2>
753453e4 282<P>Backends perform the most important task of all - they send the
283 filtered print data to the printer.</P>
284<P>CUPS provides backends for printing over parallel, serial, and USB
285 ports, and over the network via the IPP, JetDirect (AppSocket), and
286 Line Printer Daemon (&quot;LPD&quot;) protocols. Additional backends are
287 available in network service packages such as the SMB backend included
288 with the popular SAMBA software.</P>
289<P>Backends are also used to determine the available devices. On startup
290 each backend is asked for a list of devices it supports, and any
291 information that is available. This allows the parallel backend to tell
292 CUPS that an EPSON Stylus Color 600 printer is attached to parallel
293 port 1, for example.</P>
97ae2a96 294<H2><A NAME="2_7">Printer Drivers</A></H2>
753453e4 295<P>Printer drivers in CUPS consist of one of more filters specific to a
296 printer. CUPS includes sample printer drivers for Hewlett-Packard
297 LaserJet and DeskJet printers and EPSON 9-pin, 24-pin, Stylus Color,
298 and Stylus Photo printers. While these drivers do not generate optimal
299 output for the different printer models, they do provide basic printing
300 and demonstrate how you can write your own printer drivers and
301 incorporate them into CUPS.</P>
97ae2a96 302<H2><A NAME="2_8">Networking</A></H2>
753453e4 303<P>Printers and classes on the local system are automatically shared
304 with other systems on the network. This allows you to setup one system
305 to print to a printer and use this system as a printer server or spool
306 host for all of the others. Users may then select a local printer by
307 name or a remote printer using &quot;name@server&quot;.</P>
308<P>CUPS also provides<I> implicit classes</I>, which are collections of
309 printers and/or classes with the same name. This allows you to setup
310 multiple servers pointing to the same physical network printer, for
311 example, so that you aren't relying on a single system for printing.
312 Because this also works with printer classes, you can setup multiple
313 servers and printers and never worry about a single point of failure
314 unless all of the printers and servers go down!</P>
97ae2a96 315<H1 ALIGN="RIGHT"><A NAME="USING_SYSTEM">2 - Using the Printing System</A>
316</H1>
753453e4 317<P>This chapter shows you how to submit, query, and cancel print jobs to
318 different printers.</P>
97ae2a96 319<H2><A NAME="3_1">Submitting Files for Printing</A></H2>
320<P>CUPS provides both the System V (<CODE>lp(1)</CODE>) and Berkeley (<CODE>
753453e4 321lpr(1)</CODE>) printing commands. Type the following command to print a
322 file to the default (or only) printer on the system:</P>
41f765f4 323<UL>
324<PRE>
97ae2a96 325<B>lp filename ENTER</B>
326</PRE>
41f765f4 327</UL>
753453e4 328<P>or:</P>
41f765f4 329<UL>
330<PRE>
97ae2a96 331<B>lpr filename ENTER</B>
332</PRE>
333</UL>
753453e4 334<P>CUPS understands many different types of files directly, including
335 PostScript and image files. This allows you to print from inside your
336 applications or at the command-line, whichever is most convenient!</P>
97ae2a96 337<H2><A NAME="3_2">Choosing a Printer</A></H2>
753453e4 338<P>Many systems will have more than one printer available to the user.
339 These printers can be attached to the local system via a parallel,
340 serial, or USB port, or available over the network.</P>
341<P>Use the <CODE>lpstat(1)</CODE> command to see a list of available
342 printers:</P>
41f765f4 343<UL>
344<PRE>
97ae2a96 345<B>lpstat -p -d ENTER</B>
346</PRE>
41f765f4 347</UL>
753453e4 348<P>The <CODE>-p</CODE> option specifies that you want to see a list of
349 printers, and the <CODE>-d</CODE> option reports the current system
350 default printer or class.</P>
351<P>Use the <CODE>-d</CODE> option with the <CODE>lp</CODE> command to
352 print to a specific printer:</P>
41f765f4 353<UL>
354<PRE>
97ae2a96 355<B>lp -d printer filename ENTER</B>
356</PRE>
41f765f4 357</UL>
753453e4 358<P>or the <CODE>-P</CODE> option with the <CODE>lpr</CODE> command:</P>
41f765f4 359<UL>
360<PRE>
97ae2a96 361<B>lpr -P printer filename ENTER</B>
362</PRE>
363</UL>
364<H2><A NAME="3_3">Setting Printer Options</A></H2>
753453e4 365<P>For many types of files, the default printer options may be
366 sufficient for your needs. However, there may be times when you need to
367 change the options for a particular file you are printing.</P>
368<P>The <CODE>lp</CODE> and <CODE>lpr</CODE> commands allow you to pass
369 printer options using the <CODE>-o</CODE> option:</P>
41f765f4 370<UL>
371<PRE>
97ae2a96 372<B>lp -o landscape -o scaling=75 -o media=A4 filename.jpg
373<B>lpr -o landscape -o scaling=75 -o media=A4 filename.jpg
374</B></B></PRE>
375</UL>
753453e4 376<P>The available printer options vary depending on the printer. The
377 standard options are described in<A HREF="#STANDARD_OPTIONS"> Chapter
378 3, &quot;Standard Printing Options&quot;</A>.</P>
97ae2a96 379<H2><A NAME="3_4">Printing Multiple Copies</A></H2>
753453e4 380<P>Both the <CODE>lp</CODE> and <CODE>lpr</CODE> commands have options
381 for printing more than one copy of a file:</P>
41f765f4 382<UL>
383<PRE>
97ae2a96 384<B>lp -n <I>num-copies</I> filename ENTER</B>
385<B>lpr -#<I>num-copies</I> filename ENTER</B>
386</PRE>
41f765f4 387</UL>
753453e4 388<P>Copies are normally<I> not</I> collated for you. Use the <CODE>-o
389 Collate=True</CODE> option to get collated copies :</P>
41f765f4 390<UL>
391<PRE>
97ae2a96 392<B>lp -n <I>num-copies</I> -o Collate=True filename ENTER</B>
393<B>lpr -#<I>num-copies</I> -o Collate=True filename ENTER</B>
394</PRE>
41f765f4 395</UL>
ecf3075f 396
97ae2a96 397<!-- NEED 3in -->
97ae2a96 398<H2><A NAME="3_5">Checking the Printer Status from the Command-Line</A></H2>
753453e4 399<P>The <CODE>lpstat</CODE> command can be used to check for jobs that
400 you have submitted for printing:</P>
41f765f4 401<UL>
402<PRE>
97ae2a96 403<B>lpstat ENTER</B>
404Printer-1 johndoe 4427776
405Printer-2 johndoe 15786
406Printer-3 johndoe 372842
407</PRE>
41f765f4 408</UL>
97ae2a96 409<P>The jobs are listed in the order they will be printed. Use the <CODE>
753453e4 410-p</CODE> option to see which files and printers are active:</P>
41f765f4 411<UL>
412<PRE>
97ae2a96 413<B>lpstat -p ENTER</B>
414printer DeskJet now printing DeskJet-1.
415</PRE>
41f765f4 416</UL>
ecf3075f 417
97ae2a96 418<!-- NEED 2in -->
753453e4 419<P>Use the <CODE>-o</CODE> and <CODE>-p</CODE> options together to show
420 the jobs and the printers:</P>
41f765f4 421<UL>
422<PRE>
97ae2a96 423<B>lpstat -o -p ENTER</B>
424Printer-1 johndoe 4427776
425Printer-2 johndoe 15786
426Printer-3 johndoe 372842
427printer DeskJet now printing DeskJet-1.
428</PRE>
429</UL>
430<H2><A NAME="3_6">Checking the Printer Status from the Web</A></H2>
753453e4 431<P>Since CUPS uses the Internet Printing Protocol, it is also a
432 fully-functional web server. To use your web browser to monitor the
433 printers on your system, open the URL:</P>
ecf3075f 434<UL>
435<PRE>
97ae2a96 436<A HREF="http://localhost:631">http://localhost:631</A>
437</PRE>
ecf3075f 438</UL>
753453e4 439<P>From there you can view the status of classes, jobs, and printers
440 with the click of a button!</P>
97ae2a96 441<H2><A NAME="3_7">Canceling a Print Job</A></H2>
753453e4 442<P>The <CODE>cancel(1)</CODE> and <CODE>lprm(1)</CODE> commands cancel a
443 print job:</P>
41f765f4 444<UL>
445<PRE>
97ae2a96 446<B>cancel <I>job-id</I> ENTER</B>
447<B>lprm <I>job-id</I> ENTER</B>
448</PRE>
449</UL>
753453e4 450<P>The <CODE>job-id</CODE> is the number that was reported to you by the
451 <CODE>lp</CODE> or <CODE>lpstat</CODE> commands.</P>
452<H1 ALIGN="RIGHT"><A NAME="STANDARD_OPTIONS">3 - Standard Printer
453 Options</A></H1>
454<P>This chapter describes the standard printer options that are
455 available when printing with the <CODE>lp</CODE> and <CODE>lpr</CODE>
456 commands.</P>
97ae2a96 457<H2><A NAME="4_1">General Options</A></H2>
753453e4 458<P>The following options apply when printing all types of files.</P>
97ae2a96 459<H3><A NAME="4_1_1">Setting the Orientation</A></H3>
753453e4 460<P>The <CODE>-o landscape</CODE> option will rotate the page 90 degrees
461 to print in landscape orientation:</P>
41f765f4 462<UL>
463<PRE>
97ae2a96 464<B>lp -o landscape filename ENTER</B>
465<B>lpr -o landscape filename ENTER</B>
466</PRE>
41f765f4 467</UL>
ecf3075f 468
97ae2a96 469<!-- NEED 2in -->
97ae2a96 470<H3><A NAME="4_1_2">Selecting the Media Size, Type, and Source</A></H3>
753453e4 471<P>The <CODE>-o media=xyz</CODE> option sets the media size, type,
472 and/or source:</P>
ecf3075f 473<UL>
474<PRE>
97ae2a96 475<B>lp -o media=Letter filename ENTER</B>
476<B>lp -o media=Letter,MultiPurpose filename ENTER</B>
477<B>lpr -o media=Letter,Transparency filename ENTER</B>
478<B>lpr -o media=Letter,MultiPurpose,Transparency filename ENTER</B>
479</PRE>
ecf3075f 480</UL>
481
97ae2a96 482<!-- NEED 3in -->
753453e4 483<P>The available media sizes, types, and sources depend on the printer,
484 but most support the following options (case is not significant):</P>
485<UL>
486<LI><CODE>Letter</CODE> - US Letter (8.5x11 inches, or 216x279mm)</LI>
487<LI><CODE>Legal</CODE> - US Legal (8.5x14 inches, or 216x356mm)</LI>
488<LI><CODE>A4</CODE> - ISO A4 (8.27x11.69 inches, or 210x297mm)</LI>
489<LI><CODE>COM10</CODE> - US #10 Envelope (9.5x4.125 inches, or
490 241x105mm)</LI>
491<LI><CODE>DL</CODE> - ISO DL Envelope (8.66x4.33 inches, or 220x110mm)</LI>
492<LI><CODE>Transparency</CODE> - Transparency media type or source</LI>
493<LI><CODE>Upper</CODE> - Upper paper tray</LI>
494<LI><CODE>Lower</CODE> - Lower paper tray</LI>
495<LI><CODE>MultiPurpose</CODE> - Multi-purpose paper tray</LI>
496<LI><CODE>LargeCapacity</CODE> - Large capacity paper tray</LI>
497</UL>
498<P>The actual options supported are defined in the printer's PPD file in
499 the <CODE>PageSize</CODE>, <CODE>InputSlot</CODE>, and <CODE>MediaType</CODE>
500 options.</P>
97ae2a96 501<H3><A NAME="4_1_3">Printing On Both Sides of the Paper</A></H3>
753453e4 502<P>The <CODE>-o sides=two-sided-short-edge</CODE> and <CODE>-o
503 sides=two-sided-long-edge</CODE> options will enable duplexing on the
504 printer, if the printer supports it. The <CODE>-o
505 sides=two-sided-short-edge</CODE> option is suitable for landscape
506 pages, while the <CODE>-o sides=two-sided-long-edge</CODE> option is
507 suitable for portrait pages:</P>
41f765f4 508<UL>
509<PRE>
97ae2a96 510<B>lp -o sides=two-sided-short-edge filename ENTER</B>
511<B>lp -o sides=two-sided-long-edge filename ENTER</B>
512<B>lpr -o sides=two-sided-long-edge filename ENTER</B>
513</PRE>
41f765f4 514</UL>
753453e4 515<P>The default is to print single-sided:</P>
41f765f4 516<UL>
517<PRE>
97ae2a96 518<B>lp -o sides=one-sided filename ENTER</B>
519<B>lpr -o sides=one-sided filename ENTER</B>
520</PRE>
41f765f4 521</UL>
97ae2a96 522<H2><A NAME="4_2">Banner Options</A></H2>
753453e4 523<P>The following options apply when printing all types of files.</P>
97ae2a96 524<H3><A NAME="4_2_1">Selecting the Banner Page(s)</A></H3>
753453e4 525<P>The <CODE>-o jobsheets=start,end</CODE> option sets the banner
526 page(s) to use for a job:</P>
a0beb32e 527<UL>
528<PRE>
97ae2a96 529<B>lp -o job-sheets=none filename ENTER</B>
530<B>lp -o job-sheets=standard filename ENTER</B>
531<B>lpr -o job-sheets=classified,classified filename ENTER</B>
532</PRE>
533</UL>
753453e4 534<P>If only one banner file is specified, it will be printed before the
535 files in the job. If a second banner file is specified, it is printed
536 after the files in the job.</P>
537<P>The available banner pages depend on the local system configuration;
538 CUPS includes the following banner files:</P>
539<UL>
540<LI><CODE>none</CODE> - Do not produce a banner page.</LI>
541<LI><CODE>classified</CODE> - A banner page with a &quot;classified&quot; label at
542 the top and bottom.</LI>
543<LI><CODE>confidential</CODE> - A banner page with a &quot;confidential&quot;
544 label at the top and bottom.</LI>
545<LI><CODE>secret</CODE> - A banner page with a &quot;secret&quot; label at the top
546 and bottom.</LI>
547<LI><CODE>standard</CODE> - A banner page with no label at the top and
548 bottom.</LI>
549<LI><CODE>topsecret</CODE> - A banner page with a &quot;top secret&quot; label at
550 the top and bottom.</LI>
551<LI><CODE>unclassified</CODE> - A banner page with an &quot;unclassified&quot;
552 label at the top and bottom.</LI>
97ae2a96 553</UL>
554<H2><A NAME="4_3">Document Options</A></H2>
753453e4 555<P>The following options apply when printing all types of files.</P>
97ae2a96 556<H3><A NAME="4_3_1">Selecting a Range of Pages</A></H3>
753453e4 557<P>The <CODE>-o page-ranges=pages</CODE> option selects a range of pages
558 for printing:</P>
41f765f4 559<UL>
560<PRE>
97ae2a96 561<B>lp -o page-ranges=1 filename ENTER</B>
562<B>lp -o page-ranges=1-4 filename ENTER</B>
563<B>lp -o page-ranges=1-4,7,9-12 filename ENTER</B>
564<B>lpr -o page-ranges=1-4,7,9-12 filename ENTER</B>
565</PRE>
566</UL>
753453e4 567<P>As shown above, the <CODE>pages</CODE> value can be a single page, a
568 range of pages, or a collection of page numbers and ranges separated by
569 commas. The pages will always be printed in ascending order, regardless
570 of the order of the pages in the <CODE>page-ranges</CODE> option.</P>
571<P>The default is to print all pages.</P>
97ae2a96 572<H3><A NAME="4_3_2">Selecting Even or Odd Pages</A></H3>
753453e4 573<P>Use the <CODE>-o page-set=set</CODE> option to select the even or odd
574 pages:</P>
41f765f4 575<UL>
576<PRE>
97ae2a96 577<B>lp -o page-set=odd filename ENTER</B>
578<B>lp -o page-set=even filename ENTER</B>
579<B>lpr -o page-set=even filename ENTER</B>
580</PRE>
581</UL>
753453e4 582<P>The default is to print all pages.</P>
97ae2a96 583<H3><A NAME="4_3_3">N-Up Printing</A></H3>
753453e4 584<P>The <CODE>-o number-up=value</CODE> option selects N-Up printing.
585 N-Up printing places multiple document pages on a single printed page.
586 CUPS supports 1-Up, 2-Up, and 4-Up formats:</P>
5e67d874 587<UL>
588<PRE>
97ae2a96 589<B>lp -o number-up=1 filename ENTER</B>
590<B>lp -o number-up=2 filename ENTER</B>
591<B>lp -o number-up=4 filename ENTER</B>
592<B>lpr -o number-up=4 filename ENTER</B>
593</PRE>
594</UL>
753453e4 595<P>The default format is 1-Up.</P>
97ae2a96 596<H3><A NAME="4_3_4">Setting the Brightness</A></H3>
753453e4 597<P>You can control the overall brightness of the printed output using
598 the <CODE>-o brightness=percent</CODE> option:</P>
41f765f4 599<UL>
600<PRE>
97ae2a96 601<B>lp -o brightness=120 filename ENTER</B>
602<B>lpr -o brightness=120 filename ENTER</B>
603</PRE>
41f765f4 604</UL>
753453e4 605<P>Values greater than 100 will lighten the print, while values less
606 than 100 will darken it.</P>
97ae2a96 607<H3><A NAME="4_3_5">Setting the Gamma Correction</A></H3>
753453e4 608<P>You can control the overall gamma correction of the printed output
609 using the <CODE>-o gamma=value</CODE> option:</P>
41f765f4 610<UL>
611<PRE>
97ae2a96 612<B>lp -o gamma=1700 filename ENTER</B>
613<B>lpr -o gamma=1700 filename ENTER</B>
614</PRE>
615</UL>
753453e4 616<P>Values greater than 1000 will lighten the print, while values less
617 than 1000 will darken it. The default gamma is 1000.</P>
97ae2a96 618<H2><A NAME="4_4">Text Options</A></H2>
753453e4 619<P>The following options apply when printing text files.</P>
97ae2a96 620<H3><A NAME="4_4_1">Setting the Number of Characters Per Inch</A></H3>
753453e4 621<P>The <CODE>-o cpi=value</CODE> option sets the number of characters
622 per inch:</P>
41f765f4 623<UL>
624<PRE>
97ae2a96 625<B>lp -o cpi=10 filename ENTER</B>
626<B>lp -o cpi=12 filename ENTER</B>
627<B>lpr -o cpi=17 filename ENTER</B>
628</PRE>
41f765f4 629</UL>
753453e4 630<P>The default characters per inch is 10.</P>
97ae2a96 631<H3><A NAME="4_4_2">Setting the Number of Lines Per Inch</A></H3>
753453e4 632<P>The <CODE>-o lpi=value</CODE> option sets the number of lines per
633 inch:</P>
41f765f4 634<UL>
635<PRE>
97ae2a96 636<B>lp -o lpi=6 filename ENTER</B>
637<B>lpr -o lpi=8 filename ENTER</B>
638</PRE>
41f765f4 639</UL>
753453e4 640<P>The default lines per inch is 6.</P>
97ae2a96 641<H3><A NAME="4_4_3">Setting the Number of Columns</A></H3>
753453e4 642<P>The <CODE>-o columns=value</CODE> option sets the number of text
643 columns:</P>
41f765f4 644<UL>
645<PRE>
97ae2a96 646<B>lp -o columns=2 filename ENTER</B>
647<B>lpr -o columns=3 filename ENTER</B>
648</PRE>
649</UL>
753453e4 650<P>The default number of columns is 1.</P>
97ae2a96 651<H3><A NAME="4_4_4">Setting the Page Margins</A></H3>
753453e4 652<P>Normally the page margins are set to the hard limits of the printer.
653 Use the <CODE>-o page-left=value</CODE>, <CODE>-o page-right=value</CODE>
97ae2a96 654, <CODE>-o page-top=value</CODE>, and <CODE>-o page-bottom=value</CODE>
753453e4 655 options to adjust the page margins:</P>
41f765f4 656<UL>
657<PRE>
97ae2a96 658<B>lp -o page-left=<I>value</I> filename ENTER</B>
659<B>lp -o page-right=<I>value</I> filename ENTER</B>
660<B>lp -o page-top=<I>value</I> filename ENTER</B>
661<B>lp -o page-bottom=<I>value</I> filename ENTER</B>
662<B>lpr -o page-bottom=<I>value</I> filename ENTER</B>
663</PRE>
664</UL>
753453e4 665<P>The <CODE>value</CODE> argument is the margin in points; each point
666 is 1/72 inch or 0.35mm.</P>
97ae2a96 667<H3><A NAME="4_4_5">Pretty Printing</A></H3>
753453e4 668<P>The <CODE>-o prettyprint</CODE> option puts a header at the top of
669 each page with the page number, job title (usually the filename), and
670 the date. Also, C and C++ keywords are highlighted, and comment lines
671 are italicized:</P>
41f765f4 672<UL>
673<PRE>
97ae2a96 674<B>lp -o prettyprint filename ENTER</B>
675<B>lpr -o prettyprint filename ENTER</B>
676</PRE>
677</UL>
678<H2><A NAME="4_5">Image Options</A></H2>
753453e4 679<P>The following options apply when printing image files.</P>
97ae2a96 680<H3><A NAME="4_5_1">Positioning the Image</A></H3>
753453e4 681<P>The <CODE>-o position=name</CODE> option specifies the position of
682 the image on the page:</P>
683<UL>
684<LI><CODE>center</CODE> - Center the image on the page (default)</LI>
685<LI><CODE>top</CODE> - Print the image centered at the top of the page</LI>
686<LI><CODE>left</CODE> - Print the image centered on the left of page</LI>
687<LI><CODE>right</CODE> - Print the image centered on the right of the
688 page</LI>
689<LI><CODE>top-left</CODE> - Print the image at the top left corner of
690 the page</LI>
691<LI><CODE>top-right</CODE> - Print the image at the top right corner of
692 the page</LI>
693<LI><CODE>bottom</CODE> - Print the image centered at the bottom of the
694 page</LI>
695<LI><CODE>bottom-left</CODE> - Print the image at the bottom left corner
696 of the page</LI>
697<LI><CODE>bottom-right</CODE> - Print the image at the bottom right
698 corner of the page</LI>
97ae2a96 699</UL>
700<H3><A NAME="4_5_2">Scaling the Image</A></H3>
753453e4 701<P>The <CODE>-o scaling=percent</CODE>, <CODE>-o ppi=value</CODE>, and <CODE>
702-o natural-scaling=percent</CODE> options change the size of a printed
703 image:</P>
41f765f4 704<UL>
705<PRE>
97ae2a96 706<B>lp -o scaling=<I>percent</I> filename ENTER</B>
707<B>lp -o ppi=<I>value</I> filename ENTER</B>
753453e4 708<B>lpr -o natural-scaling=<I>percent</I> filename ENTER</B>
97ae2a96 709</PRE>
710</UL>
753453e4 711<P>The <CODE>scaling=percent</CODE> value is a number from 1 to 800
712 specifying the size in relation to the page (<I>not</I> the image.) A
713 scaling of 100 percent will fill the page as completely as the image
714 aspect ratio allows. A scaling of 200 percent will print on up to 4
715 pages.</P>
716<P>The <CODE>ppi=value</CODE> value is a number from 1 to 1200
717 specifying the resolution of the image in pixels per inch. An image
718 that is 3000x2400 pixels will print 10x8 inches at 300 pixels per inch,
719 for example. If the specified resolution makes the image larger than
720 the page, multiple pages will be printed to satisfy the request.</P>
721<P>The <CODE>natural-scaling=percent</CODE> value is a number from 1 to
722 800 specifying the size in relation to the natural image size. A
723 scaling of 100 percent will print the image at its natural size, while
724 a scaling of 50 percent will print the image at half its natural size.
725 If the specified scaling makes the image larger than the page, multiple
726 pages will be printed to satisfy the request.</P>
97ae2a96 727<H3><A NAME="4_5_3">Adjusting the Hue (Tint) of an Image</A></H3>
753453e4 728<P>The <CODE>-o hue=value</CODE> option will adjust the hue of the
729 printed image, much like the tint control on your television:</P>
41f765f4 730<UL>
731<PRE>
97ae2a96 732<B>lp -o hue=<I>value</I> filename ENTER</B>
733<B>lpr -o hue=<I>value</I> filename ENTER</B>
734</PRE>
41f765f4 735</UL>
ecf3075f 736
97ae2a96 737<!-- NEED 3in -->
753453e4 738<P>The <CODE>value</CODE> argument is a number from -360 to 360 and
739 represents the color hue rotation. The following table summarizes the
740 change you'll see with different colors:
41f765f4 741<CENTER>
902da432 742<TABLE BORDER="1" WIDTH="50%">
97ae2a96 743<TR><TH>Original</TH><TH>hue=-45</TH><TH>hue=45</TH></TR>
744<TR><TD>Red</TD><TD>Purple</TD><TD>Yellow-orange</TD></TR>
745<TR><TD>Green</TD><TD>Yellow-green</TD><TD>Blue-green</TD></TR>
746<TR><TD>Yellow</TD><TD>Orange</TD><TD>Green-yellow</TD></TR>
747<TR><TD>Blue</TD><TD>Sky-blue</TD><TD>Purple</TD></TR>
748<TR><TD>Magenta</TD><TD>Indigo</TD><TD>Crimson</TD></TR>
749<TR><TD>Cyan</TD><TD>Blue-green</TD><TD>Light-navy-blue</TD></TR>
41f765f4 750</TABLE>
751</CENTER>
752</P>
753453e4 753<P>The default hue adjustment is 0.</P>
97ae2a96 754<H3><A NAME="4_5_4">Adjusting the Saturation (Color) of an Image</A></H3>
753453e4 755<P>The <CODE>-o saturation=percent</CODE> option adjusts the saturation
756 of the colors in an image, much like the color knob on your television:</P>
ecf3075f 757<UL>
758<PRE>
97ae2a96 759<B>lp -o saturation=<I>percent</I> filename ENTER</B>
760<B>lpr -o saturation=<I>percent</I> filename ENTER</B>
761</PRE>
762</UL>
753453e4 763<P>The <CODE>percent</CODE> argument specifies the color saturation from
764 0 to 200. A color saturation of 0 produces a black-and-white print,
765 while a value of 200 will make the colors extremely intense.</P>
766<P>The default saturation is 100.
97ae2a96 767<!-- NEED 4in -->
ef56e874 768</P>
97ae2a96 769<H2><A NAME="4_6">HP-GL/2 Options</A></H2>
753453e4 770<P>The following options apply to HP-GL/2 files.</P>
97ae2a96 771<H3><A NAME="4_6_1">Printing in Black</A></H3>
753453e4 772<P>The <CODE>-o blackplot</CODE> option specifies that all pens should
773 plot in black:</P>
a0beb32e 774<UL>
ecf3075f 775<PRE>
97ae2a96 776<B>lp -o blackplot filename ENTER</B>
777<B>lpr -o blackplot filename ENTER</B>
778</PRE>
779</UL>
753453e4 780<P>The default is to use the colors defined in the plot file or the
781 standard pen colors defined in the HP-GL/2 reference manual from
782 Hewlett Packard.</P>
97ae2a96 783<H3><A NAME="4_6_2">Fitting the Plot on the Page</A></H3>
753453e4 784<P>The <CODE>-o fitplot</CODE> option specifies that the plot should be
785 scaled to fit on the page:</P>
a0beb32e 786<UL>
ecf3075f 787<PRE>
97ae2a96 788<B>lp -o fitplot filename ENTER</B>
789<B>lpr -o fitplot filename ENTER</B>
790</PRE>
a0beb32e 791</UL>
753453e4 792<P>The default is to use the absolute distances specified in the plot
793 file.
ecf3075f 794<CENTER>
795<TABLE BGCOLOR="#cccccc" BORDER="1" CELLPADDING="5" WIDTH="80%">
97ae2a96 796<TR><TD><B> NOTE:</B>
753453e4 797<P>This feature depends upon an accurate plot size (<CODE>PS</CODE>)
798 command in the HP-GL/2 file. If no plot size is given in the file than
799 the HP-GL/2 filter assumes the plot is ANSI E size.</P>
ecf3075f 800</TD></TR>
801</TABLE>
802</CENTER>
803</P>
97ae2a96 804<H3><A NAME="4_6_3">Setting the Default Pen Width</A></H3>
753453e4 805<P>The <CODE>-o penwidth=value</CODE> option specifies the default pen
806 width for HP-GL/2 files:</P>
41f765f4 807<UL>
808<PRE>
97ae2a96 809<B>lp -o penwidth=<I>value</I> filename ENTER</B>
810<B>lpr -o penwidth=<I>value</I> filename ENTER</B>
811</PRE>
812</UL>
753453e4 813<P>The pen width <CODE>value</CODE> specifies the pen width in
814 micrometers. The default value of 1000 produces lines that are 1
815 millimeter in width. Specifying a pen width of 0 produces lines that
816 are exactly 1 pixel wide.
ecf3075f 817<CENTER>
818<TABLE BGCOLOR="#cccccc" BORDER="1" CELLPADDING="5" WIDTH="80%">
97ae2a96 819<TR><TD><B> NOTE:</B>
753453e4 820<P>This option is ignored when the pen widths are set in the plot file.</P>
ecf3075f 821</TD></TR>
822</TABLE>
823</CENTER>
824</P>
97ae2a96 825<H2><A NAME="4_7">Raw or Unfiltered Output</A></H2>
753453e4 826<P>The <CODE>-o raw</CODE> option allows you to send files directly to a
827 printer without filtering. This is sometimes required when printing
828 from applications that provide their own &quot;printer drivers&quot; for your
829 printer:</P>
a0beb32e 830<UL>
831<PRE>
97ae2a96 832<B>lp -o raw filename ENTER</B>
833<B>lpr -o raw filename ENTER</B>
834</PRE>
a0beb32e 835</UL>
97ae2a96 836<P>The <CODE>-l</CODE> option can also be used with the <CODE>lpr</CODE>
753453e4 837 command to send files directly to a printer:</P>
a0beb32e 838<UL>
839<PRE>
97ae2a96 840<B>lpr -l filename ENTER</B>
841</PRE>
842</UL>
753453e4 843<H1 ALIGN="RIGHT"><A NAME="SAVING_OPTIONS">4 - Saving Printer Options
844 and Defaults</A></H1>
845<P>This chapter describes how to save printer options for your printer
846 and set your own default printer.</P>
97ae2a96 847<H2><A NAME="5_1">Printer Options</A></H2>
753453e4 848<P>Each printer supports a large number of options, which you learned
849 about in<A HREF="#STANDARD_OPTIONS"> Chapter 3, &quot;Standard Printer
850 Options&quot;</A>. Rather than specifying these options each time you print
851 a file, CUPS allows you to save them as &quot;default&quot; options for the
852 printer.</P>
853<P>The <CODE>lpoptions(1)</CODE> command saves the options for your
854 printers. Like the <CODE>lp</CODE> and <CODE>lpr</CODE> commands, it
855 accepts printer options using the <CODE>-o</CODE> argument:</P>
ecf3075f 856<UL>
857<PRE>
97ae2a96 858<B>lpoptions -o media=A4 -o sides=two-sided-long-edge ENTER</B>
859<B>lpoptions -o media=Legal -o scaling=100 ENTER</B>
860</PRE>
861</UL>
753453e4 862<P>Once saved, any <CODE>lp</CODE> or <CODE>lpr</CODE> command will use
863 them when you print.</P>
97ae2a96 864<H2><A NAME="5_2">Setting Options for a Specific Printer</A></H2>
753453e4 865<P>The previous example shows how to set the options for the default
866 printer. The <CODE>-p printer</CODE> option specifies the options are
867 for another printer:</P>
ecf3075f 868<UL>
869<PRE>
97ae2a96 870<B>lpoptions -p laserjet -o media=A4 -o sides=two-sided-long-edge ENTER</B>
871<B>lpoptions -p deskjet -o media=Legal -o scaling=100 ENTER</B>
872</PRE>
ecf3075f 873</UL>
97ae2a96 874<H2><A NAME="5_3">Viewing the Current Defaults</A></H2>
753453e4 875<P>The <CODE>lpoptions</CODE> command can also be used to show the
876 current options by not specifying any new options on the command-line:</P>
ecf3075f 877<UL>
878<PRE>
97ae2a96 879<B>lpoptions ENTER</B>
880media=A4 sides=two-sided-long-edge
881<B>lpoptions -p deskjet ENTER</B>
882media=Legal scaling=100
883</PRE>
884</UL>
885<H2><A NAME="5_4">Setting the Default Printer</A></H2>
753453e4 886<P>The administrator normally will set a system-wide default printer
887 that is normally used as the default printer by everyone. Use the <CODE>
888-d printer</CODE> option to set your own default printer:</P>
ecf3075f 889<UL>
890<PRE>
97ae2a96 891<B>lpoptions -d deskjet ENTER</B>
892</PRE>
893</UL>
894<P>The printer can be local (<CODE>deskjet</CODE>) or remote (<CODE>
753453e4 895deskjet@server</CODE>).</P>
97ae2a96 896<H2><A NAME="5_5">Printer Instances</A></H2>
753453e4 897<P>Besides setting options for each print queue, CUPS supports<I>
898 printer instances</I> which allow you to define several different sets
899 of options for each printer. You specify a printer instance using the
900 slash (<CODE>/</CODE>) character:</P>
ecf3075f 901<UL>
902<PRE>
97ae2a96 903<B>lpoptions -p laserjet/duplex -o sides=two-sided-long-edge ENTER</B>
904<B>lpoptions -p laserjet/legal -o media=Legal ENTER</B>
905</PRE>
ecf3075f 906</UL>
753453e4 907<P>The <CODE>lp</CODE> and lpr commands also understand this notation:</P>
ecf3075f 908<UL>
909<PRE>
97ae2a96 910<B>lp -d laserjet/duplex filename ENTER</B>
911<B>lpr -P laserjet/legal filename ENTER</B>
912</PRE>
ecf3075f 913</UL>
97ae2a96 914<H2><A NAME="5_6">Removing Instances</A></H2>
753453e4 915<P>Use the <CODE>-x printer/instance</CODE> option to remove a printer
916 instance that you no longer need:</P>
ecf3075f 917<UL>
918<PRE>
97ae2a96 919<B>lpoptions -x laserjet ENTER</B>
920<B>lpoptions -x laserjet/duplex ENTER</B>
921<B>lpoptions -x laserjet/legal ENTER</B>
922</PRE>
923</UL>
753453e4 924<P>The <CODE>-x</CODE> option only removes the default options for that
925 printer and instance; the original print queue will remain until
926 deleted with the <CODE>lpadmin(8)</CODE> command by the administrator.</P>
97ae2a96 927<H1 ALIGN="RIGHT"><A NAME="LICENSE">A - Software License Agreement</A></H1>
753453e4 928<H2 ALIGN="CENTER"><A NAME="6_1">Common UNIX Printing System License
929 Agreement</A></H2>
baee2cec 930<P ALIGN="CENTER">Copyright 1997-2001 by Easy Software Products
931<BR> 44141 AIRPORT VIEW DR STE 204
932<BR> HOLLYWOOD, MARYLAND 20636-3111 USA
933<BR>
934<BR> Voice: +1.301.373.9600
753453e4 935<BR> Email:<A HREF="mailto:cups-info@cups.org"> cups-info@cups.org</A>
936<BR> WWW:<A HREF="http://www.cups.org"> http://www.cups.org</A></P>
97ae2a96 937<H3><A NAME="6_1_1">Introduction</A></H3>
753453e4 938<P>The Common UNIX Printing System<SUP>TM</SUP>, (&quot;CUPS<SUP>TM</SUP>&quot;),
939 is provided under the GNU General Public License (&quot;GPL&quot;) and GNU
940 Library General Public License (&quot;LGPL&quot;), Version 2. A copy of these
941 licenses follow this introduction.</P>
942<P>The GNU LGPL applies to the CUPS API library, located in the &quot;cups&quot;
943 subdirectory of the CUPS source distribution and in the
944 &quot;/usr/include/cups&quot; directory and &quot;libcups.a&quot;, &quot;libcups_s.a&quot;,
945 &quot;libcups.sl&quot;, or &quot;libcups.so&quot; files in the binary distributions.</P>
946<P>The GNU GPL applies to the remainder of the CUPS distribution,
947 including the &quot;pstoraster&quot; filter which is based upon GNU Ghostscript
948 5.50 and the &quot;pdftops&quot; filter which is based upon Xpdf 0.93a.</P>
949<P>For those not familiar with the GNU GPL, the license basically allows
950 you to:</P>
951<UL>
952<LI>Use the CUPS software at no charge.</LI>
953<LI>Distribute verbatim copies of the software in source or binary form.</LI>
954<LI>Sell verbatim copies of the software for a media fee, or sell
955 support for the software.</LI>
956<LI>Distribute or sell printer drivers and filters that use CUPS so long
957 as source code is made available under the GPL.</LI>
958</UL>
959<P>What this license<B> does not</B> allow you to do is make changes or
960 add features to CUPS and then sell a binary distribution without source
961 code. You must provide source for any new drivers, changes, or
962 additions to the software, and all code must be provided under the GPL
963 or LGPL as appropriate.</P>
964<P>The GNU LGPL relaxes the &quot;link-to&quot; restriction, allowing you to
965 develop applications that use the CUPS API library under other licenses
966 and/or conditions as appropriate for your application.</P>
97ae2a96 967<H3><A NAME="6_1_2">Trademarks</A></H3>
753453e4 968<P>Easy Software Products has trademarked the Common UNIX Printing
969 System, CUPS, and CUPS logo. These names and logos may be used freely
970 in any direct port or binary distribution of CUPS. To use them in
971 derivative products, please contract Easy Software Products for written
972 permission. Our intention is to protect the value of these trademarks
973 and ensure that any derivative product meets the same high-quality
974 standards as the original.</P>
97ae2a96 975<H3><A NAME="6_1_3">Binary Distribution Rights</A></H3>
753453e4 976<P>Easy Software Products also sells rights to the CUPS source code
977 under a binary distribution license for vendors that are unable to
978 release source code for their drivers, additions, and modifications to
979 CUPS under the GNU GPL and LGPL. For information please contact us at
980 the address shown above.</P>
981<P>The Common UNIX Printing System provides a &quot;pstoraster&quot; filter that
982 utilizes the GNU GhostScript 5.50 core to convert PostScript files into
983 a stream of raster images. For binary distribution licensing of this
984 software, please contact:<BLOCKQUOTE> Miles Jones
baee2cec 985<BR> Director of Marketing
986<BR> Artifex Software Inc.
987<BR> 454 Las Gallinas Ave., Suite 108
988<BR> San Rafael, CA 94903 USA
989<BR> Voice: +1.415.492.9861
990<BR> Fax: +1.415.492.9862
753453e4 991<BR> EMail:<A HREF="mailto:info@arsoft.com"> info@arsoft.com</A></BLOCKQUOTE>
551d3a88 992</P>
753453e4 993<P>The &quot;pdftops&quot; filter is based on the Xpdf 0.93a software. For binary
994 distribution licensing of this software, please contact:<BLOCKQUOTE>
97ae2a96 995 Derek B. Noonburg
753453e4 996<BR> Email:<A HREF="mailto:derekn@foolabs.com"> derekn@foolabs.com</A>
997<BR> WWW:<A HREF="http://www.foolabs.com/xpdf/">
998 http://www.foolabs.com/xpdf/</A></BLOCKQUOTE></P>
97ae2a96 999<H3><A NAME="6_1_4">Support</A></H3>
753453e4 1000<P>Easy Software Products sells software support for CUPS as well as a
1001 commercial printing product based on CUPS called ESP Print Pro. You can
1002 find out more at our web site:</P>
ecf3075f 1003<UL>
1004<PRE>
97ae2a96 1005<A HREF="http://www.easysw.com">http://www.easysw.com</A>
1006</PRE>
ecf3075f 1007</UL>
1008
97ae2a96 1009<!-- NEW PAGE -->
97ae2a96 1010<H2><A NAME="6_2">GNU GENERAL PUBLIC LICENSE</A></H2>
753453e4 1011<P>Version 2, June 1991</P>
ecf3075f 1012<PRE>
97ae2a96 1013Copyright 1989, 1991 Free Software Foundation, Inc.
101459 Temple Place, Suite 330, Boston, MA 02111-1307 USA
1015
1016Everyone is permitted to copy and distribute verbatim
1017copies of this license document, but changing it is not allowed.
1018</PRE>
ecf3075f 1019<PRE>
97ae2a96 1020
1021</PRE>
1022<H4>Preamble</H4>
753453e4 1023<P>The licenses for most software are designed to take away your freedom
1024 to share and change it. By contrast, the GNU General Public License is
1025 intended to guarantee your freedom to share and change free
1026 software--to make sure the software is free for all its users. This
1027 General Public License applies to most of the Free Software
1028 Foundation's software and to any other program whose authors commit to
1029 using it. (Some other Free Software Foundation software is covered by
1030 the GNU Library General Public License instead.) You can apply it to
1031 your programs, too.</P>
1032<P>When we speak of free software, we are referring to freedom, not
1033 price. Our General Public Licenses are designed to make sure that you
1034 have the freedom to distribute copies of free software (and charge for
1035 this service if you wish), that you receive source code or can get it
1036 if you want it, that you can change the software or use pieces of it in
1037 new free programs; and that you know you can do these things.</P>
1038<P>To protect your rights, we need to make restrictions that forbid
1039 anyone to deny you these rights or to ask you to surrender the rights.
1040 These restrictions translate to certain responsibilities for you if you
1041 distribute copies of the software, or if you modify it.</P>
1042<P>For example, if you distribute copies of such a program, whether
1043 gratis or for a fee, you must give the recipients all the rights that
1044 you have. You must make sure that they, too, receive or can get the
1045 source code. And you must show them these terms so they know their
1046 rights.</P>
1047<P>We protect your rights with two steps: (1) copyright the software,
1048 and (2) offer you this license which gives you legal permission to
1049 copy, distribute and/or modify the software.</P>
1050<P>Also, for each author's protection and ours, we want to make certain
1051 that everyone understands that there is no warranty for this free
1052 software. If the software is modified by someone else and passed on, we
1053 want its recipients to know that what they have is not the original, so
1054 that any problems introduced by others will not reflect on the original
1055 authors' reputations.</P>
1056<P>Finally, any free program is threatened constantly by software
1057 patents. We wish to avoid the danger that redistributors of a free
1058 program will individually obtain patent licenses, in effect making the
1059 program proprietary. To prevent this, we have made it clear that any
1060 patent must be licensed for everyone's free use or not licensed at all.</P>
1061<P>The precise terms and conditions for copying, distribution and
1062 modification follow.</P>
97ae2a96 1063<H4>GNU GENERAL PUBLIC LICENSE
baee2cec 1064<BR> TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION</H4>
ecf3075f 1065<OL START="0">
753453e4 1066<LI>This License applies to any program or other work which contains a
1067 notice placed by the copyright holder saying it may be distributed
1068 under the terms of this General Public License. The &quot;Program&quot;, below,
1069 refers to any such program or work, and a &quot;work based on the Program&quot;
1070 means either the Program or any derivative work under copyright law:
1071 that is to say, a work containing the Program or a portion of it,
1072 either verbatim or with modifications and/or translated into another
1073 language. (Hereinafter, translation is included without limitation in
1074 the term &quot;modification&quot;.) Each licensee is addressed as &quot;you&quot;.</LI>
1075<P>Activities other than copying, distribution and modification are not
1076 covered by this License; they are outside its scope. The act of running
1077 the Program is not restricted, and the output from the Program is
1078 covered only if its contents constitute a work based on the Program
1079 (independent of having been made by running the Program). Whether that
1080 is true depends on what the Program does.</P>
1081<LI>You may copy and distribute verbatim copies of the Program's source
1082 code as you receive it, in any medium, provided that you conspicuously
1083 and appropriately publish on each copy an appropriate copyright notice
1084 and disclaimer of warranty; keep intact all the notices that refer to
1085 this License and to the absence of any warranty; and give any other
1086 recipients of the Program a copy of this License along with the
1087 Program.</LI>
1088<P>You may charge a fee for the physical act of transferring a copy, and
1089 you may at your option offer warranty protection in exchange for a fee.</P>
1090<LI>You may modify your copy or copies of the Program or any portion of
1091 it, thus forming a work based on the Program, and copy and distribute
1092 such modifications or work under the terms of Section 1 above, provided
1093 that you also meet all of these conditions:
ecf3075f 1094<OL TYPE="a">
753453e4 1095<LI>You must cause the modified files to carry prominent notices stating
1096 that you changed the files and the date of any change.</LI>
1097<LI>You must cause any work that you distribute or publish, that in
1098 whole or in part contains or is derived from the Program or any part
1099 thereof, to be licensed as a whole at no charge to all third parties
1100 under the terms of this License.</LI>
1101<LI>if the modified program normally reads commands interactively when
1102 run, you must cause it, when started running for such interactive use
1103 in the most ordinary way, to print or display an announcement including
1104 an appropriate copyright notice and a notice that there is no warranty
1105 (or else, saying that you provide a warranty) and that users may
1106 redistribute the program under these conditions, and telling the user
1107 how to view a copy of this License. (Exception: if the Program itself
1108 is interactive but does not normally print such an announcement, your
1109 work based on the Program is not required to print an announcement.)</LI>
ecf3075f 1110</OL>
1111</LI>
753453e4 1112<P>These requirements apply to the modified work as a whole. If
1113 identifiable sections of that work are not derived from the Program,
1114 and can be reasonably considered independent and separate works in
1115 themselves, then this License, and its terms, do not apply to those
1116 sections when you distribute them as separate works. But when you
1117 distribute the same sections as part of a whole which is a work based
1118 on the Program, the distribution of the whole must be on the terms of
1119 this License, whose permissions for other licensees extend to the
1120 entire whole, and thus to each and every part regardless of who wrote
1121 it.</P>
1122<P>Thus, it is not the intent of this section to claim rights or contest
1123 your rights to work written entirely by you; rather, the intent is to
1124 exercise the right to control the distribution of derivative or
1125 collective works based on the Program.</P>
1126<P>In addition, mere aggregation of another work not based on the
1127 Program with the Program (or with a work based on the Program) on a
1128 volume of a storage or distribution medium does not bring the other
1129 work under the scope of this License.</P>
1130<LI>You may copy and distribute the Program (or a work based on it,
1131 under Section 2) in object code or executable form under the terms of
1132 Sections 1 and 2 above provided that you also do one of the following:
ecf3075f 1133<OL TYPE="a">
753453e4 1134<LI>Accompany it with the complete corresponding machine-readable source
1135 code, which must be distributed under the terms of Sections 1 and 2
1136 above on a medium customarily used for software interchange; or,</LI>
1137<LI>Accompany it with a written offer, valid for at least three years,
1138 to give any third party, for a charge no more than your cost of
1139 physically performing source distribution, a complete machine-readable
1140 copy of the corresponding source code, to be distributed under the
1141 terms of Sections 1 and 2 above on a medium customarily used for
1142 software interchange; or,</LI>
1143<LI>Accompany it with the information you received as to the offer to
1144 distribute corresponding source code. (This alternative is allowed only
1145 for noncommercial distribution and only if you received the program in
1146 object code or executable form with such an offer, in accord with
1147 Subsection b above.)</LI>
ecf3075f 1148</OL>
1149</LI>
753453e4 1150<P>The source code for a work means the preferred form of the work for
1151 making modifications to it. For an executable work, complete source
1152 code means all the source code for all modules it contains, plus any
1153 associated interface definition files, plus the scripts used to control
1154 compilation and installation of the executable. However, as a special
1155 exception, the source code distributed need not include anything that
1156 is normally distributed (in either source or binary form) with the
1157 major components (compiler, kernel, and so on) of the operating system
1158 on which the executable runs, unless that component itself accompanies
1159 the executable.</P>
1160<P>If distribution of executable or object code is made by offering
1161 access to copy from a designated place, then offering equivalent access
1162 to copy the source code from the same place counts as distribution of
1163 the source code, even though third parties are not compelled to copy
1164 the source along with the object code.</P>
1165<LI>You may not copy, modify, sublicense, or distribute the Program
1166 except as expressly provided under this License. Any attempt otherwise
1167 to copy, modify, sublicense or distribute the Program is void, and will
1168 automatically terminate your rights under this License. However,
1169 parties who have received copies, or rights, from you under this
1170 License will not have their licenses terminated so long as such parties
1171 remain in full compliance.</LI>
1172<LI>You are not required to accept this License, since you have not
1173 signed it. However, nothing else grants you permission to modify or
1174 distribute the Program or its derivative works. These actions are
1175 prohibited by law if you do not accept this License. Therefore, by
1176 modifying or distributing the Program (or any work based on the
1177 Program), you indicate your acceptance of this License to do so, and
1178 all its terms and conditions for copying, distributing or modifying the
1179 Program or works based on it.</LI>
1180<LI>Each time you redistribute the Program (or any work based on the
1181 Program), the recipient automatically receives a license from the
1182 original licensor to copy, distribute or modify the Program subject to
1183 these terms and conditions. You may not impose any further restrictions
1184 on the recipients' exercise of the rights granted herein. You are not
1185 responsible for enforcing compliance by third parties to this License.</LI>
1186<LI>If, as a consequence of a court judgment or allegation of patent
1187 infringement or for any other reason (not limited to patent issues),
1188 conditions are imposed on you (whether by court order, agreement or
1189 otherwise) that contradict the conditions of this License, they do not
1190 excuse you from the conditions of this License. If you cannot
1191 distribute so as to satisfy simultaneously your obligations under this
1192 License and any other pertinent obligations, then as a consequence you
1193 may not distribute the Program at all. For example, if a patent license
1194 would not permit royalty-free redistribution of the Program by all
1195 those who receive copies directly or indirectly through you, then the
1196 only way you could satisfy both it and this License would be to refrain
1197 entirely from distribution of the Program.</LI>
1198<P>If any portion of this section is held invalid or unenforceable under
1199 any particular circumstance, the balance of the section is intended to
1200 apply and the section as a whole is intended to apply in other
1201 circumstances.</P>
1202<P>It is not the purpose of this section to induce you to infringe any
1203 patents or other property right claims or to contest validity of any
1204 such claims; this section has the sole purpose of protecting the
1205 integrity of the free software distribution system, which is
1206 implemented by public license practices. Many people have made generous
1207 contributions to the wide range of software distributed through that
1208 system in reliance on consistent application of that system; it is up
1209 to the author/donor to decide if he or she is willing to distribute
1210 software through any other system and a licensee cannot impose that
1211 choice.</P>
1212<P>This section is intended to make thoroughly clear what is believed to
1213 be a consequence of the rest of this License.</P>
1214<LI>If the distribution and/or use of the Program is restricted in
1215 certain countries either by patents or by copyrighted interfaces, the
1216 original copyright holder who places the Program under this License may
1217 add an explicit geographical distribution limitation excluding those
1218 countries, so that distribution is permitted only in or among countries
1219 not thus excluded. In such case, this License incorporates the
1220 limitation as if written in the body of this License.</LI>
1221<LI>The Free Software Foundation may publish revised and/or new versions
1222 of the General Public License from time to time. Such new versions will
1223 be similar in spirit to the present version, but may differ in detail
1224 to address new problems or concerns.</LI>
1225<P>Each version is given a distinguishing version number. If the Program
1226 specifies a version number of this License which applies to it and &quot;any
1227 later version&quot;, you have the option of following the terms and
1228 conditions either of that version or of any later version published by
1229 the Free Software Foundation. If the Program does not specify a version
1230 number of this License, you may choose any version ever published by
1231 the Free Software Foundation.</P>
1232<LI>If you wish to incorporate parts of the Program into other free
1233 programs whose distribution conditions are different, write to the
1234 author to ask for permission. For software which is copyrighted by the
1235 Free Software Foundation, write to the Free Software Foundation; we
1236 sometimes make exceptions for this. Our decision will be guided by the
1237 two goals of preserving the free status of all derivatives of our free
1238 software and of promoting the sharing and reuse of software generally.</LI>
ecf3075f 1239</OL>
97ae2a96 1240<H4>NO WARRANTY</H4>
ecf3075f 1241<OL START="11">
753453e4 1242<LI>BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
1243 FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
1244 OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
1245 PROVIDE THE PROGRAM &quot;AS IS&quot; WITHOUT WARRANTY OF ANY KIND, EITHER
1246 EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
1247 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
1248 ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH
1249 YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
1250 NECESSARY SERVICING, REPAIR OR CORRECTION.</LI>
1251<LI>IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
1252 WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
1253 AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU
1254 FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
1255 CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
1256 PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
1257 RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
1258 FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF
1259 SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
1260 DAMAGES.</LI>
ecf3075f 1261</OL>
97ae2a96 1262<H4>END OF TERMS AND CONDITIONS</H4>
ecf3075f 1263
97ae2a96 1264<!-- NEW PAGE -->
97ae2a96 1265<H2><A NAME="6_3">GNU LIBRARY GENERAL PUBLIC LICENSE</A></H2>
753453e4 1266<P>Version 2, June 1991</P>
ecf3075f 1267<PRE>
97ae2a96 1268Copyright (C) 1991 Free Software Foundation, Inc.
126959 Temple Place - Suite 330, Boston, MA 02111-1307, USA
1270Everyone is permitted to copy and distribute verbatim copies
1271of this license document, but changing it is not allowed.
1272
1273[This is the first released version of the library GPL. It is
1274 numbered 2 because it goes with version 2 of the ordinary GPL.]
1275</PRE>
1276<H4>Preamble</H4>
753453e4 1277<P>The licenses for most software are designed to take away your freedom
1278 to share and change it. By contrast, the GNU General Public Licenses
1279 are intended to guarantee your freedom to share and change free
1280 software--to make sure the software is free for all its users.</P>
1281<P>This license, the Library General Public License, applies to some
1282 specially designated Free Software Foundation software, and to any
1283 other libraries whose authors decide to use it. You can use it for your
1284 libraries, too.</P>
1285<P>When we speak of free software, we are referring to freedom, not
1286 price. Our General Public Licenses are designed to make sure that you
1287 have the freedom to distribute copies of free software (and charge for
1288 this service if you wish), that you receive source code or can get it
1289 if you want it, that you can change the software or use pieces of it in
1290 new free programs; and that you know you can do these things.</P>
1291<P>To protect your rights, we need to make restrictions that forbid
1292 anyone to deny you these rights or to ask you to surrender the rights.
1293 These restrictions translate to certain responsibilities for you if you
1294 distribute copies of the library, or if you modify it.</P>
1295<P>For example, if you distribute copies of the library, whether gratis
1296 or for a fee, you must give the recipients all the rights that we gave
1297 you. You must make sure that they, too, receive or can get the source
1298 code. If you link a program with the library, you must provide complete
1299 object files to the recipients so that they can relink them with the
1300 library, after making changes to the library and recompiling it. And
1301 you must show them these terms so they know their rights.</P>
1302<P>Our method of protecting your rights has two steps: (1) copyright the
1303 library, and (2) offer you this license which gives you legal
1304 permission to copy, distribute and/or modify the library.</P>
1305<P>Also, for each distributor's protection, we want to make certain that
1306 everyone understands that there is no warranty for this free library.
1307 If the library is modified by someone else and passed on, we want its
1308 recipients to know that what they have is not the original version, so
1309 that any problems introduced by others will not reflect on the original
1310 authors' reputations.</P>
1311<P>Finally, any free program is threatened constantly by software
1312 patents. We wish to avoid the danger that companies distributing free
1313 software will individually obtain patent licenses, thus in effect
1314 transforming the program into proprietary software. To prevent this, we
1315 have made it clear that any patent must be licensed for everyone's free
1316 use or not licensed at all.</P>
1317<P>Most GNU software, including some libraries, is covered by the
1318 ordinary GNU General Public License, which was designed for utility
1319 programs. This license, the GNU Library General Public License, applies
1320 to certain designated libraries. This license is quite different from
1321 the ordinary one; be sure to read it in full, and don't assume that
1322 anything in it is the same as in the ordinary license.</P>
1323<P>The reason we have a separate public license for some libraries is
1324 that they blur the distinction we usually make between modifying or
1325 adding to a program and simply using it. Linking a program with a
1326 library, without changing the library, is in some sense simply using
1327 the library, and is analogous to running a utility program or
1328 application program. However, in a textual and legal sense, the linked
1329 executable is a combined work, a derivative of the original library,
1330 and the ordinary General Public License treats it as such.</P>
1331<P>Because of this blurred distinction, using the ordinary General
1332 Public License for libraries did not effectively promote software
1333 sharing, because most developers did not use the libraries. We
1334 concluded that weaker conditions might promote sharing better.</P>
1335<P>However, unrestricted linking of non-free programs would deprive the
1336 users of those programs of all benefit from the free status of the
1337 libraries themselves. This Library General Public License is intended
1338 to permit developers of non-free programs to use free libraries, while
1339 preserving your freedom as a user of such programs to change the free
1340 libraries that are incorporated in them. (We have not seen how to
1341 achieve this as regards changes in header files, but we have achieved
1342 it as regards changes in the actual functions of the Library.) The hope
1343 is that this will lead to faster development of free libraries.</P>
1344<P>The precise terms and conditions for copying, distribution and
1345 modification follow. Pay close attention to the difference between a
1346 &quot;work based on the library&quot; and a &quot;work that uses the library&quot;. The
1347 former contains code derived from the library, while the latter only
1348 works together with the library.</P>
1349<P>Note that it is possible for a library to be covered by the ordinary
1350 General Public License rather than by this special one.</P>
97ae2a96 1351<H4>TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION</H4>
753453e4 1352<P><STRONG>0.</STRONG> This License Agreement applies to any software
1353 library which contains a notice placed by the copyright holder or other
1354 authorized party saying it may be distributed under the terms of this
1355 Library General Public License (also called &quot;this License&quot;). Each
1356 licensee is addressed as &quot;you&quot;.</P>
1357<P>A &quot;library&quot; means a collection of software functions and/or data
1358 prepared so as to be conveniently linked with application programs
1359 (which use some of those functions and data) to form executables.</P>
1360<P>The &quot;Library&quot;, below, refers to any such software library or work
1361 which has been distributed under these terms. A &quot;work based on the
1362 Library&quot; means either the Library or any derivative work under
1363 copyright law: that is to say, a work containing the Library or a
1364 portion of it, either verbatim or with modifications and/or translated
1365 straightforwardly into another language. (Hereinafter, translation is
1366 included without limitation in the term &quot;modification&quot;.)</P>
1367<P>&quot;Source code&quot; for a work means the preferred form of the work for
1368 making modifications to it. For a library, complete source code means
1369 all the source code for all modules it contains, plus any associated
1370 interface definition files, plus the scripts used to control
1371 compilation and installation of the library.</P>
1372<P>Activities other than copying, distribution and modification are not
1373 covered by this License; they are outside its scope. The act of running
1374 a program using the Library is not restricted, and output from such a
1375 program is covered only if its contents constitute a work based on the
1376 Library (independent of the use of the Library in a tool for writing
1377 it). Whether that is true depends on what the Library does and what the
1378 program that uses the Library does.</P>
1379<P><STRONG>1.</STRONG> You may copy and distribute verbatim copies of
1380 the Library's complete source code as you receive it, in any medium,
1381 provided that you conspicuously and appropriately publish on each copy
1382 an appropriate copyright notice and disclaimer of warranty; keep intact
1383 all the notices that refer to this License and to the absence of any
1384 warranty; and distribute a copy of this License along with the Library.</P>
1385<P>You may charge a fee for the physical act of transferring a copy, and
1386 you may at your option offer warranty protection in exchange for a fee.</P>
1387<P><STRONG>2.</STRONG> You may modify your copy or copies of the Library
1388 or any portion of it, thus forming a work based on the Library, and
1389 copy and distribute such modifications or work under the terms of
1390 Section 1 above, provided that you also meet all of these conditions:</P>
ecf3075f 1391<OL TYPE="a">
753453e4 1392<LI>The modified work must itself be a software library.</LI>
04d756fc 1393<P></P>
753453e4 1394<LI>You must cause the files modified to carry prominent notices stating
1395 that you changed the files and the date of any change.</LI>
04d756fc 1396<P></P>
753453e4 1397<LI>You must cause the whole of the work to be licensed at no charge to
1398 all third parties under the terms of this License.</LI>
04d756fc 1399<P></P>
753453e4 1400<LI>If a facility in the modified Library refers to a function or a
1401 table of data to be supplied by an application program that uses the
1402 facility, other than as an argument passed when the facility is
1403 invoked, then you must make a good faith effort to ensure that, in the
1404 event an application does not supply such function or table, the
1405 facility still operates, and performs whatever part of its purpose
1406 remains meaningful.</LI>
1407<P>(For example, a function in a library to compute square roots has a
1408 purpose that is entirely well-defined independent of the application.
1409 Therefore, Subsection 2d requires that any application-supplied
1410 function or table used by this function must be optional: if the
1411 application does not supply it, the square root function must still
1412 compute square roots.)</P>
ecf3075f 1413</OL>
753453e4 1414<P>These requirements apply to the modified work as a whole. If
1415 identifiable sections of that work are not derived from the Library,
1416 and can be reasonably considered independent and separate works in
1417 themselves, then this License, and its terms, do not apply to those
1418 sections when you distribute them as separate works. But when you
1419 distribute the same sections as part of a whole which is a work based
1420 on the Library, the distribution of the whole must be on the terms of
1421 this License, whose permissions for other licensees extend to the
1422 entire whole, and thus to each and every part regardless of who wrote
1423 it.</P>
1424<P>Thus, it is not the intent of this section to claim rights or contest
1425 your rights to work written entirely by you; rather, the intent is to
1426 exercise the right to control the distribution of derivative or
1427 collective works based on the Library.</P>
1428<P>In addition, mere aggregation of another work not based on the
1429 Library with the Library (or with a work based on the Library) on a
1430 volume of a storage or distribution medium does not bring the other
1431 work under the scope of this License.</P>
1432<P><STRONG>3.</STRONG> You may opt to apply the terms of the ordinary
1433 GNU General Public License instead of this License to a given copy of
1434 the Library. To do this, you must alter all the notices that refer to
1435 this License, so that they refer to the ordinary GNU General Public
1436 License, version 2, instead of to this License. (If a newer version
1437 than version 2 of the ordinary GNU General Public License has appeared,
1438 then you can specify that version instead if you wish.) Do not make any
1439 other change in these notices.</P>
1440<P>Once this change is made in a given copy, it is irreversible for that
1441 copy, so the ordinary GNU General Public License applies to all
1442 subsequent copies and derivative works made from that copy.</P>
1443<P>This option is useful when you wish to copy part of the code of the
1444 Library into a program that is not a library.</P>
1445<P><STRONG>4.</STRONG> You may copy and distribute the Library (or a
1446 portion or derivative of it, under Section 2) in object code or
1447 executable form under the terms of Sections 1 and 2 above provided that
1448 you accompany it with the complete corresponding machine-readable
1449 source code, which must be distributed under the terms of Sections 1
1450 and 2 above on a medium customarily used for software interchange.</P>
1451<P>If distribution of object code is made by offering access to copy
1452 from a designated place, then offering equivalent access to copy the
1453 source code from the same place satisfies the requirement to distribute
1454 the source code, even though third parties are not compelled to copy
1455 the source along with the object code.</P>
1456<P><STRONG>5.</STRONG> A program that contains no derivative of any
1457 portion of the Library, but is designed to work with the Library by
1458 being compiled or linked with it, is called a &quot;work that uses the
1459 Library&quot;. Such a work, in isolation, is not a derivative work of the
1460 Library, and therefore falls outside the scope of this License.</P>
1461<P>However, linking a &quot;work that uses the Library&quot; with the Library
1462 creates an executable that is a derivative of the Library (because it
1463 contains portions of the Library), rather than a &quot;work that uses the
1464 library&quot;. The executable is therefore covered by this License. Section
1465 6 states terms for distribution of such executables.</P>
1466<P>When a &quot;work that uses the Library&quot; uses material from a header file
1467 that is part of the Library, the object code for the work may be a
1468 derivative work of the Library even though the source code is not.
1469 Whether this is true is especially significant if the work can be
1470 linked without the Library, or if the work is itself a library. The
1471 threshold for this to be true is not precisely defined by law.</P>
1472<P>If such an object file uses only numerical parameters, data structure
1473 layouts and accessors, and small macros and small inline functions (ten
1474 lines or less in length), then the use of the object file is
1475 unrestricted, regardless of whether it is legally a derivative work.
1476 (Executables containing this object code plus portions of the Library
1477 will still fall under Section 6.)</P>
1478<P>Otherwise, if the work is a derivative of the Library, you may
1479 distribute the object code for the work under the terms of Section 6.
1480 Any executables containing that work also fall under Section 6, whether
1481 or not they are linked directly with the Library itself.</P>
1482<P><STRONG>6.</STRONG> As an exception to the Sections above, you may
1483 also compile or link a &quot;work that uses the Library&quot; with the Library to
1484 produce a work containing portions of the Library, and distribute that
1485 work under terms of your choice, provided that the terms permit
1486 modification of the work for the customer's own use and reverse
1487 engineering for debugging such modifications.</P>
1488<P>You must give prominent notice with each copy of the work that the
1489 Library is used in it and that the Library and its use are covered by
1490 this License. You must supply a copy of this License. If the work
1491 during execution displays copyright notices, you must include the
1492 copyright notice for the Library among them, as well as a reference
1493 directing the user to the copy of this License. Also, you must do one
1494 of these things:</P>
ecf3075f 1495<OL TYPE="a">
753453e4 1496<LI>Accompany the work with the complete corresponding machine-readable
1497 source code for the Library including whatever changes were used in the
1498 work (which must be distributed under Sections 1 and 2 above); and, if
1499 the work is an executable linked with the Library, with the complete
1500 machine-readable &quot;work that uses the Library&quot;, as object code and/or
1501 source code, so that the user can modify the Library and then relink to
1502 produce a modified executable containing the modified Library. (It is
1503 understood that the user who changes the contents of definitions files
1504 in the Library will not necessarily be able to recompile the
1505 application to use the modified definitions.)</LI>
04d756fc 1506<P></P>
753453e4 1507<LI>Accompany the work with a written offer, valid for at least three
1508 years, to give the same user the materials specified in Subsection 6a,
1509 above, for a charge no more than the cost of performing this
1510 distribution.</LI>
04d756fc 1511<P></P>
753453e4 1512<LI>If distribution of the work is made by offering access to copy from
1513 a designated place, offer equivalent access to copy the above specified
1514 materials from the same place.</LI>
04d756fc 1515<P></P>
753453e4 1516<LI>Verify that the user has already received a copy of these materials
1517 or that you have already sent this user a copy.</LI>
ecf3075f 1518</OL>
753453e4 1519<P>For an executable, the required form of the &quot;work that uses the
1520 Library&quot; must include any data and utility programs needed for
1521 reproducing the executable from it. However, as a special exception,
1522 the source code distributed need not include anything that is normally
1523 distributed (in either source or binary form) with the major components
1524 (compiler, kernel, and so on) of the operating system on which the
1525 executable runs, unless that component itself accompanies the
1526 executable.</P>
1527<P>It may happen that this requirement contradicts the license
1528 restrictions of other proprietary libraries that do not normally
1529 accompany the operating system. Such a contradiction means you cannot
1530 use both them and the Library together in an executable that you
1531 distribute.</P>
1532<P><STRONG>7.</STRONG> You may place library facilities that are a work
1533 based on the Library side-by-side in a single library together with
1534 other library facilities not covered by this License, and distribute
1535 such a combined library, provided that the separate distribution of the
1536 work based on the Library and of the other library facilities is
1537 otherwise permitted, and provided that you do these two things:</P>
ecf3075f 1538<OL TYPE="a">
753453e4 1539<LI>Accompany the combined library with a copy of the same work based on
1540 the Library, uncombined with any other library facilities. This must be
1541 distributed under the terms of the Sections above.</LI>
04d756fc 1542<P></P>
753453e4 1543<LI>Give prominent notice with the combined library of the fact that
1544 part of it is a work based on the Library, and explaining where to find
1545 the accompanying uncombined form of the same work.</LI>
ecf3075f 1546</OL>
753453e4 1547<P><STRONG>8.</STRONG> You may not copy, modify, sublicense, link with,
1548 or distribute the Library except as expressly provided under this
1549 License. Any attempt otherwise to copy, modify, sublicense, link with,
1550 or distribute the Library is void, and will automatically terminate
1551 your rights under this License. However, parties who have received
1552 copies, or rights, from you under this License will not have their
1553 licenses terminated so long as such parties remain in full compliance.</P>
1554<P><STRONG>9.</STRONG> You are not required to accept this License,
1555 since you have not signed it. However, nothing else grants you
1556 permission to modify or distribute the Library or its derivative works.
1557 These actions are prohibited by law if you do not accept this License.
1558 Therefore, by modifying or distributing the Library (or any work based
1559 on the Library), you indicate your acceptance of this License to do so,
1560 and all its terms and conditions for copying, distributing or modifying
1561 the Library or works based on it.</P>
1562<P><STRONG>10.</STRONG> Each time you redistribute the Library (or any
1563 work based on the Library), the recipient automatically receives a
1564 license from the original licensor to copy, distribute, link with or
1565 modify the Library subject to these terms and conditions. You may not
1566 impose any further restrictions on the recipients' exercise of the
1567 rights granted herein. You are not responsible for enforcing compliance
1568 by third parties to this License.</P>
1569<P><STRONG>11.</STRONG> If, as a consequence of a court judgment or
1570 allegation of patent infringement or for any other reason (not limited
1571 to patent issues), conditions are imposed on you (whether by court
1572 order, agreement or otherwise) that contradict the conditions of this
1573 License, they do not excuse you from the conditions of this License. If
1574 you cannot distribute so as to satisfy simultaneously your obligations
1575 under this License and any other pertinent obligations, then as a
1576 consequence you may not distribute the Library at all. For example, if
1577 a patent license would not permit royalty-free redistribution of the
1578 Library by all those who receive copies directly or indirectly through
1579 you, then the only way you could satisfy both it and this License would
1580 be to refrain entirely from distribution of the Library.</P>
1581<P>If any portion of this section is held invalid or unenforceable under
1582 any particular circumstance, the balance of the section is intended to
1583 apply, and the section as a whole is intended to apply in other
1584 circumstances.</P>
1585<P>It is not the purpose of this section to induce you to infringe any
1586 patents or other property right claims or to contest validity of any
1587 such claims; this section has the sole purpose of protecting the
1588 integrity of the free software distribution system which is implemented
1589 by public license practices. Many people have made generous
1590 contributions to the wide range of software distributed through that
1591 system in reliance on consistent application of that system; it is up
1592 to the author/donor to decide if he or she is willing to distribute
1593 software through any other system and a licensee cannot impose that
1594 choice.</P>
1595<P>This section is intended to make thoroughly clear what is believed to
1596 be a consequence of the rest of this License.</P>
1597<P><STRONG>12.</STRONG> If the distribution and/or use of the Library is
1598 restricted in certain countries either by patents or by copyrighted
1599 interfaces, the original copyright holder who places the Library under
1600 this License may add an explicit geographical distribution limitation
1601 excluding those countries, so that distribution is permitted only in or
1602 among countries not thus excluded. In such case, this License
1603 incorporates the limitation as if written in the body of this License.</P>
1604<P><STRONG>13.</STRONG> The Free Software Foundation may publish revised
1605 and/or new versions of the Library General Public License from time to
1606 time. Such new versions will be similar in spirit to the present
1607 version, but may differ in detail to address new problems or concerns.</P>
1608<P>Each version is given a distinguishing version number. If the Library
1609 specifies a version number of this License which applies to it and &quot;any
1610 later version&quot;, you have the option of following the terms and
1611 conditions either of that version or of any later version published by
1612 the Free Software Foundation. If the Library does not specify a license
1613 version number, you may choose any version ever published by the Free
1614 Software Foundation.</P>
1615<P><STRONG>14.</STRONG> If you wish to incorporate parts of the Library
1616 into other free programs whose distribution conditions are incompatible
1617 with these, write to the author to ask for permission. For software
1618 which is copyrighted by the Free Software Foundation, write to the Free
1619 Software Foundation; we sometimes make exceptions for this. Our
1620 decision will be guided by the two goals of preserving the free status
1621 of all derivatives of our free software and of promoting the sharing
1622 and reuse of software generally.</P>
97ae2a96 1623<P><STRONG>NO WARRANTY</STRONG></P>
753453e4 1624<P><STRONG>15.</STRONG> BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE,
1625 THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY
1626 APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
1627 HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY &quot;AS IS&quot; WITHOUT
1628 WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
1629 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
1630 PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE
1631 OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU
1632 ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.</P>
1633<P><STRONG>16.</STRONG> IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR
1634 AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO
1635 MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE
1636 LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL
1637 OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
1638 LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
1639 RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
1640 FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
1641 SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
1642 DAMAGES.</P>
97ae2a96 1643<H4>END OF TERMS AND CONDITIONS</H4>
c8475f2d 1644</BODY>
1645</HTML>