]>
Commit | Line | Data |
---|---|---|
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 | 10 | BODY { font-family: serif } |
11 | H1 { font-family: sans-serif } | |
12 | H2 { font-family: sans-serif } | |
13 | H3 { font-family: sans-serif } | |
14 | H4 { font-family: sans-serif } | |
15 | H5 { font-family: sans-serif } | |
16 | H6 { font-family: sans-serif } | |
17 | SUB { font-size: smaller } | |
18 | SUP { font-size: smaller } | |
19 | PRE { 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> | |
25 | CUPS-SUM-1.1.7<BR> | |
6a921799 | 26 | Easy Software Products<BR> |
d0e6f0a0 | 27 | Copyright 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 <<<<<<< sum.shtml System<SUP>TM</SUP> ("CUPS<SUP>TM</SUP>") | |
129 | Version 1.1.7. ======= System<SUP>TM</SUP> ("CUPS<SUP>TM</SUP>") | |
130 | Version 1.1.13. >>>>>>> 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®-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 ("IPP") as the basis for | |
138 | managing print jobs and queues. The Line Printer Daemon ("LPD") Server | |
139 | Message Block ("SMB"), and AppSocket (a.k.a. JetDirect) protocols are | |
140 | also supported with reduced functionality. CUPS adds network printer | |
141 | browsing and PostScript Printer Description ("PPD") 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> </TD><TH>Description</TH></TR> |
165 | <TR><TD> </TD></TR> | |
166 | <TR VALIGN="TOP"><TD><CODE>lpstat</CODE> | |
753453e4 | 167 | <BR> <CODE>lpstat(1)</CODE></TD><TD> </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> </TD></TR> |
171 | <TR VALIGN="TOP"><TD><VAR>/var</VAR> | |
baee2cec | 172 | <BR><VAR> /usr/share/cups/data/testprint.ps</VAR></TD><TD> </TD><TD> |
97ae2a96 | 173 | File and directory names.</TD></TR> |
174 | <TR><TD> </TD></TR> | |
175 | <TR VALIGN="TOP"><TD NOWRAP><TT>Request ID is Printer-123</TT></TD><TD> | |
176 | </TD><TD>Screen output.</TD></TR> | |
177 | <TR><TD> </TD></TR> | |
178 | <TR VALIGN="TOP"><TD NOWRAP><KBD>lp -d printer filename ENTER</KBD></TD><TD> | |
753453e4 | 179 | </TD><TD>Literal user input; special keys like <KBD>ENTER</KBD> are |
97ae2a96 | 180 | in ALL CAPS.</TD></TR> |
181 | <TR><TD> </TD></TR> | |
753453e4 | 182 | <TR VALIGN="TOP"><TD>12.3</TD><TD> </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> </DD> |
196 | <DT>Mb</DT> | |
97ae2a96 | 197 | <DD>Megabytes, or 1048576 bytes |
753453e4 | 198 | <BR> </DD> |
199 | <DT>Gb</DT> | |
97ae2a96 | 200 | <DD>Gigabytes, or 1073741824 bytes |
753453e4 | 201 | <BR> </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> </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> </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® Windows® 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 ("HTTP") | |
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 ("RIP") 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 ("LPD") 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 "name@server".</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 | 321 | lpr(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, "Standard Printing Options"</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> |
404 | Printer-1 johndoe 4427776 | |
405 | Printer-2 johndoe 15786 | |
406 | Printer-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> |
414 | printer 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> |
424 | Printer-1 johndoe 4427776 | |
425 | Printer-2 johndoe 15786 | |
426 | Printer-3 johndoe 372842 | |
427 | printer 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 "classified" label at | |
542 | the top and bottom.</LI> | |
543 | <LI><CODE>confidential</CODE> - A banner page with a "confidential" | |
544 | label at the top and bottom.</LI> | |
545 | <LI><CODE>secret</CODE> - A banner page with a "secret" 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 "top secret" label at | |
550 | the top and bottom.</LI> | |
551 | <LI><CODE>unclassified</CODE> - A banner page with an "unclassified" | |
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 "printer drivers" 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, "Standard Printer | |
850 | Options"</A>. Rather than specifying these options each time you print | |
851 | a file, CUPS allows you to save them as "default" 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> |
880 | media=A4 sides=two-sided-long-edge | |
881 | <B>lpoptions -p deskjet ENTER</B> | |
882 | media=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 | 895 | deskjet@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>, ("CUPS<SUP>TM</SUP>"), |
939 | is provided under the GNU General Public License ("GPL") and GNU | |
940 | Library General Public License ("LGPL"), 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 "cups" | |
943 | subdirectory of the CUPS source distribution and in the | |
944 | "/usr/include/cups" directory and "libcups.a", "libcups_s.a", | |
945 | "libcups.sl", or "libcups.so" files in the binary distributions.</P> | |
946 | <P>The GNU GPL applies to the remainder of the CUPS distribution, | |
947 | including the "pstoraster" filter which is based upon GNU Ghostscript | |
948 | 5.50 and the "pdftops" 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 "link-to" 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 "pstoraster" 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 "pdftops" 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 | 1013 | Copyright 1989, 1991 Free Software Foundation, Inc. |
1014 | 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
1015 | ||
1016 | Everyone is permitted to copy and distribute verbatim | |
1017 | copies 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 "Program", below, | |
1069 | refers to any such program or work, and a "work based on the Program" | |
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 "modification".) Each licensee is addressed as "you".</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 "any | |
1227 | later version", 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 "AS IS" 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 | 1268 | Copyright (C) 1991 Free Software Foundation, Inc. |
1269 | 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA | |
1270 | Everyone is permitted to copy and distribute verbatim copies | |
1271 | of 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 | "work based on the library" and a "work that uses the library". 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 "this License"). Each | |
1356 | licensee is addressed as "you".</P> | |
1357 | <P>A "library" 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 "Library", below, refers to any such software library or work | |
1361 | which has been distributed under these terms. A "work based on the | |
1362 | Library" 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 "modification".)</P> | |
1367 | <P>"Source code" 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 "work that uses the | |
1459 | Library". 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 "work that uses the Library" 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 "work that uses the | |
1464 | library". The executable is therefore covered by this License. Section | |
1465 | 6 states terms for distribution of such executables.</P> | |
1466 | <P>When a "work that uses the Library" 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 "work that uses the Library" 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 "work that uses the Library", 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 "work that uses the |
1520 | Library" 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 "any | |
1610 | later version", 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 "AS IS" 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> |