]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/svd.html
Load cups into easysw/current.
[thirdparty/cups.git] / doc / svd.html
CommitLineData
ef416fc2 1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
2<HTML>
3<HEAD>
4<TITLE>CUPS Software Version Description</TITLE>
5<META NAME="author" CONTENT="Easy Software Products">
6<META NAME="copyright" CONTENT="Copyright 1997-2003, All Rights Reserved">
7<META NAME="docnumber" CONTENT="CUPS-SVD-1.2">
8<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso-8859-1">
9<STYLE TYPE="text/css"><!--
10BODY { font-family: serif }
11H1 { font-family: sans-serif }
12H2 { font-family: sans-serif }
13H3 { font-family: sans-serif }
14H4 { font-family: sans-serif }
15H5 { font-family: sans-serif }
16H6 { font-family: sans-serif }
17SUB { font-size: smaller }
18SUP { font-size: smaller }
19PRE { font-family: monospace }
20--></STYLE>
21</HEAD>
22<BODY>
23<CENTER><A HREF="#CONTENTS"><IMG SRC="images/cups-large.gif" BORDER="0" WIDTH="431" HEIGHT="511"><BR>
24<H1>CUPS Software Version Description</H1></A><BR>
25CUPS-SVD-1.2<BR>
26Easy Software Products<BR>
27Copyright 1997-2003, All Rights Reserved<BR>
28</CENTER>
29<HR>
30<H1 ALIGN="CENTER"><A NAME="CONTENTS">Table of Contents</A></H1>
31<BR>
32<BR><B><A HREF="#1">1 Scope</A></B>
33<UL>
34<LI><A HREF="#1_1">1.1 Identification</A></LI>
35<LI><A HREF="#1_2">1.2 System Overview</A></LI>
36<LI><A HREF="#1_3">1.3 Document Overview</A></LI>
37</UL>
38<B><A HREF="#2">2 References</A></B>
39<UL>
40<LI><A HREF="#2_1">2.1 CUPS Documentation</A></LI>
41<LI><A HREF="#2_2">2.2 Other Documents</A></LI>
42</UL>
43<B><A HREF="#3">3 Additions</A></B>
44<UL>
45<LI><A HREF="#3_1">3.1 Filters</A></LI>
46<UL>
47<LI><A HREF="#3_1_1">3.1.1 imagetoraster, imagetops</A></LI>
48<LI><A HREF="#3_1_2">3.1.2 pdftops</A></LI>
49<LI><A HREF="#3_1_3">3.1.3 pstoraster</A></LI>
50<LI><A HREF="#3_1_4">3.1.4 rastertoepson</A></LI>
51</UL>
52<LI><A HREF="#3_2">3.2 User-Defined Printers and Options</A></LI>
53<LI><A HREF="#3_3">3.3 Daemons</A></LI>
54<UL>
55<LI><A HREF="#3_3_1">3.3.1 cups-lpd</A></LI>
56<LI><A HREF="#3_3_2">3.3.2 cups-polld</A></LI>
57</UL>
58<LI><A HREF="#3_4">3.4 Commands</A></LI>
59<UL>
60<LI><A HREF="#3_4_1">3.4.1 lpoptions</A></LI>
61<LI><A HREF="#3_4_2">3.4.2 lpmove</A></LI>
62<LI><A HREF="#3_4_3">3.4.3 lpinfo</A></LI>
63</UL>
64<LI><A HREF="#3_5">3.5 IPP Implementation</A></LI>
65</UL>
66<B><A HREF="#4">4 Changes</A></B>
67<UL>
68<LI><A HREF="#4_1">4.1 Directory Structure</A></LI>
69<LI><A HREF="#4_2">4.2 IPP Implementation</A></LI>
70</UL>
71<B><A HREF="#5">A Glossary</A></B>
72<UL>
73<LI><A HREF="#5_1">A.1 Terms</A></LI>
74<LI><A HREF="#5_2">A.2 Acronyms</A></LI>
75</UL>
76<HR>
77<H1><A NAME="1">1 Scope</A></H1>
78<H2><A NAME="1_1">1.1 Identification</A></H2>
79 This software version description document provides release information
80 for the Common UNIX Printing System (&quot;CUPS&quot;) Version 1.1.
81<H2><A NAME="1_2">1.2 System Overview</A></H2>
82<P>CUPS provides a portable printing layer for UNIX&reg;-based operating
83 systems. It has been developed by<A HREF="http://www.easysw.com"> Easy
84 Software Products</A> to promote a standard printing solution for all
85 UNIX vendors and users. CUPS provides the System V and Berkeley
86 command-line interfaces.</P>
87<P>CUPS uses the Internet Printing Protocol (&quot;IPP&quot;) as the basis for
88 managing print jobs and queues. The Line Printer Daemon (&quot;LPD&quot;) Server
89 Message Block (&quot;SMB&quot;), and AppSocket (a.k.a. JetDirect) protocols are
90 also supported with reduced functionality. CUPS adds network printer
91 browsing and PostScript Printer Description (&quot;PPD&quot;) based printing
92 options to support real-world printing under UNIX.</P>
93<P>CUPS also includes a customized version of GNU Ghostscript (currently
94 based off GNU Ghostscript 5.50) and an image file RIP that are used to
95 support non-PostScript printers. Sample drivers for HP and EPSON
96 printers are included that use these filters.</P>
97<H2><A NAME="1_3">1.3 Document Overview</A></H2>
98<P>This software version description document is organized into the
99 following sections:</P>
100<UL>
101<LI><A HREF="#1">1 - Scope</A></LI>
102<LI><A HREF="#2">2 - References</A></LI>
103<LI><A HREF="#3">3 - Additions</A></LI>
104<LI><A HREF="#4">4 - Changes</A></LI>
105<LI><A HREF="#5">A - Glossary</A></LI>
106</UL>
107<H1><A NAME="2">2 References</A></H1>
108<H2><A NAME="2_1">2.1 CUPS Documentation</A></H2>
109<P>The following CUPS documentation is referenced by this document:</P>
110<UL>
111<LI>CUPS-CMP-1.2: CUPS Configuration Management Plan</LI>
112<LI>CUPS-IDD-1.2: CUPS System Interface Design Description</LI>
113<LI>CUPS-IPP-1.2: CUPS Implementation of IPP</LI>
114<LI>CUPS-SAM-1.2.x: CUPS Software Administrators Manual</LI>
115<LI>CUPS-SDD-1.2: CUPS Software Design Description</LI>
116<LI>CUPS-SPM-1.2.x: CUPS Software Programming Manual</LI>
117<LI>CUPS-SSR-1.2: CUPS Software Security Report</LI>
118<LI>CUPS-STP-1.2: CUPS Software Test Plan</LI>
119<LI>CUPS-SUM-1.2.x: CUPS Software Users Manual</LI>
120<LI>CUPS-SVD-1.2: CUPS Software Version Description</LI>
121</UL>
122<H2><A NAME="2_2">2.2 Other Documents</A></H2>
123<P>The following non-CUPS documents are referenced by this document:</P>
124<UL>
125<LI><A HREF="http://partners.adobe.com/asn/developer/PDFS/TN/5003.PPD_Spec_v4.3.pdf">
126Adobe PostScript Printer Description File Format Specification, Version
127 4.3.</A></LI>
128<LI><A HREF="http://partners.adobe.com/asn/developer/PDFS/TN/PLRM.pdf">
129Adobe PostScript Language Reference, Third Edition.</A></LI>
130<LI>IPP: Job and Printer Set Operations</LI>
131<LI>IPP/1.1: Encoding and Transport</LI>
132<LI>IPP/1.1: Implementers Guide</LI>
133<LI>IPP/1.1: Model and Semantics</LI>
134<LI><A HREF="http://www.ietf.org/rfc/rfc1179.txt">RFC 1179, Line Printer
135 Daemon Protocol</A></LI>
136<LI><A HREF="http://www.ietf.org/rfc/rfc2567.txt">RFC 2567, Design Goals
137 for an Internet Printing Protocol</A></LI>
138<LI><A HREF="http://www.ietf.org/rfc/rfc2568.txt">RFC 2568, Rationale
139 for the Structure of the Model and Protocol for the Internet Printing
140 Protocol</A></LI>
141<LI><A HREF="http://www.ietf.org/rfc/rfc2569.txt">RFC 2569, Mapping
142 between LPD and IPP Protocols</A></LI>
143<LI><A HREF="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616, Hypertext
144 Transfer Protocol -- HTTP/1.1</A></LI>
145<LI><A HREF="http://www.ietf.org/rfc/rfc2617.txt">RFC 2617, HTTP
146 Authentication: Basic and Digest Access</A> Authentication</LI>
147</UL>
148<H1><A NAME="3">3 Additions</A></H1>
149<P>CUPS 1.2 includes many new features from the 1.0.x releases.</P>
150<H2><A NAME="3_1">3.1 Filters</A></H2>
151<H3><A NAME="3_1_1">3.1.1 <CODE>imagetoraster</CODE>, <CODE>imagetops</CODE>
152</A></H3>
153<P>The image file filters have been upgraded to support conversion of
154 Microsoft Bitmap (&quot;BMP&quot;) and Alias PIX files.</P>
155<H3><A NAME="3_1_2">3.1.2 pdftops</A></H3>
156<P>A new pdftops filter has been developed that is based on the
157 excellent Xpdf 0.90 software from Derek B. Noonburg. The new filter is
158 faster, smaller, and considerably more reliable than the
159 Ghostscript-based filter in CUPS 1.0.</P>
160<H3><A NAME="3_1_3">3.1.3 pstoraster</A></H3>
161<P>The <CODE>pstoraster</CODE> filter has been integrated with GNU
162 GhostScript 5.50. The new RIP supports most Level 3 PostScript language
163 features.</P>
164<H3><A NAME="3_1_4">3.1.4 rastertoepson</A></H3>
165<P>The new <CODE>rastertoepson</CODE> filter supports EPSON printers
166 using the ESC/P or ESC/P2 command sets. PPDs are supplied for 9-pin,
167 24-pin, Stylus Color, and Stylus Photo printers.</P>
168<H2><A NAME="3_2">3.2 User-Defined Printers and Options</A></H2>
169<P>The new <CODE>lpoptions</CODE> command allows users to configure
170 default document options and create additional &quot;instances&quot; of existing
171 printers, each with unique options.</P>
172<P>The <CODE>lp</CODE>, <CODE>lpr</CODE>, and <CODE>lpstat</CODE>
173 commands have been upgraded to use this option and printer instance
174 information automatically.</P>
175<H2><A NAME="3_3">3.3 Daemons</A></H2>
176<P>CUPS 1.2 includes two new daemons that provide enhanced network
177 printing support.</P>
178<H3><A NAME="3_3_1">3.3.1 cups-lpd</A></H3>
179<P>The <CODE>cups-lpd</CODE> daemon provides support for clients using
180 the Line Printer Daemon protocol.</P>
181<H3><A NAME="3_3_2">3.3.2 cups-polld</A></H3>
182<P>The <CODE>cups-polld</CODE> daemon provides remote polling services
183 for the scheduler.</P>
184<H2><A NAME="3_4">3.4 Commands</A></H2>
185<P>CUPS 1.2 includes several new printing commands.</P>
186<H3><A NAME="3_4_1">3.4.1 lpoptions</A></H3>
187<P>The <CODE>lpoptions</CODE> command provides user-defined printers and
188 options.</P>
189<H3><A NAME="3_4_2">3.4.2 lpmove</A></H3>
190<P>The <CODE>lpmove</CODE> command moves a print job to a new
191 destination.</P>
192<H3><A NAME="3_4_3">3.4.3 lpinfo</A></H3>
193<P>The <CODE>lpinfo</CODE> command lists the available PPD files or
194 devices.</P>
195<H2><A NAME="3_5">3.5 IPP Implementation</A></H2>
196<P>CUPS 1.2 adds support for the <CODE>set-job-attributes</CODE>
197 extension operation as well as two new CUPS-specific extension
198 operations to determine which devices and printer drivers are available
199 on the system.</P>
200<P>Further information on the CUPS implementation of IPP can be found in
201 CUPS-IPP-1.2.</P>
202<H1><A NAME="4">4 Changes</A></H1>
203<P>CUPS 1.2 includes many changes from the 1.1.x releases.</P>
204<H2><A NAME="4_1">4.1 Directory Structure</A></H2>
205<P>The directory structure in CUPS 1.2 has been modified to conform to
206 the Filesystem Hierarchy Standard, 2.2. The following table describes
207 the new file locations.
208<CENTER>
209<TABLE BORDER WIDTH="80%"><CAPTION> Table 1: Directory structure changes
210 from CUPS 1.1.x to 1.2.x.</CAPTION>
211<TR><TH>Description</TH><TH>CUPS 1.1.x</TH><TH>CUPS 1.2.x</TH></TR>
212<TR><TD>Backends</TD><TD>/var/cups/backend</TD><TD>/usr/lib/cups/backend</TD>
213</TR>
214<TR><TD>CGI programs</TD><TD>/var/cups/cgi-bin</TD><TD>
215/usr/lib/cups/cgi-bin</TD></TR>
216<TR><TD>Configuration files</TD><TD>/var/cups/conf</TD><TD>/etc/cups</TD>
217</TR>
218<TR><TD>Documentation</TD><TD>/usr/share/cups/doc</TD><TD>
219/usr/share/doc/cups</TD></TR>
220<TR><TD>Filter programs</TD><TD>/var/cups/filter</TD><TD>
221/usr/lib/cups/filter</TD></TR>
222<TR><TD>Interface scripts</TD><TD>/var/cups/interfaces</TD><TD>
223/etc/cups/interfaces</TD></TR>
224<TR><TD>Locale data</TD><TD>/usr/lib/locale</TD><TD>/usr/share/locale</TD>
225</TR>
226<TR><TD>Log files</TD><TD>/var/cups/logs</TD><TD>/var/log/cups</TD></TR>
227<TR><TD>PPD files</TD><TD>/var/cups/ppd</TD><TD>/etc/cups/ppd</TD></TR>
228<TR><TD>Request files</TD><TD>/var/cups/requests</TD><TD>/var/spool/cups</TD>
229</TR>
230</TABLE>
231</CENTER>
232</P>
233<H2><A NAME="4_2">4.2 IPP Implementation</A></H2>
234<P>CUPS 1.2 is based on version 1.1 of the Internet Printing Protocol.</P>
235<P>The new scheduler supports the <CODE>create-job</CODE> and <CODE>
236send-document</CODE> operations. In addition, the <CODE>job-sheets</CODE>
237, <CODE>job-sheets-default</CODE>, and <CODE>job-sheets-supported</CODE>
238 attributes are now supported for banner pages.</P>
239<P>The <CODE>CUPS-get-printers</CODE> and <CODE>CUPS-get-classes</CODE>
240 operations have been upgraded to support limited filtering based upon
241 the <CODE>printer-type</CODE>, <CODE>printer-location</CODE>, <CODE>
242printer-info</CODE>, and <CODE>printer-make-and-model</CODE> attributes.</P>
243<P>The <CODE>CUPS-add-printer</CODE> operation now supports the <CODE>
244ppd-name</CODE> attribute to specify a locally-available PPD file rather
245 than sending the PPD file from the client with the request.</P>
246<P>Further information on the CUPS implementation of IPP can be found in
247 CUPS-IPP-1.2.</P>
248<H1 TYPE="A" VALUE="1"><A NAME="5">A Glossary</A></H1>
249<H2><A NAME="5_1">A.1 Terms</A></H2>
250<DL>
251<DT>C</DT>
252<DD>A computer language.</DD>
253<DT>parallel</DT>
254<DD>Sending or receiving data more than 1 bit at a time.</DD>
255<DT>pipe</DT>
256<DD>A one-way communications channel between two programs.</DD>
257<DT>serial</DT>
258<DD>Sending or receiving data 1 bit at a time.</DD>
259<DT>socket</DT>
260<DD>A two-way network communications channel.</DD>
261</DL>
262<H2><A NAME="5_2">A.2 Acronyms</A></H2>
263<DL>
264<DT>ASCII</DT>
265<DD>American Standard Code for Information Interchange</DD>
266<DT>CUPS</DT>
267<DD>Common UNIX Printing System</DD>
268<DT>ESC/P</DT>
269<DD>EPSON Standard Code for Printers</DD>
270<DT>FTP</DT>
271<DD>File Transfer Protocol</DD>
272<DT>HP-GL</DT>
273<DD>Hewlett-Packard Graphics Language</DD>
274<DT>HP-PCL</DT>
275<DD>Hewlett-Packard Page Control Language</DD>
276<DT>HP-PJL</DT>
277<DD>Hewlett-Packard Printer Job Language</DD>
278<DT>IETF</DT>
279<DD>Internet Engineering Task Force</DD>
280<DT>IPP</DT>
281<DD>Internet Printing Protocol</DD>
282<DT>ISO</DT>
283<DD>International Standards Organization</DD>
284<DT>LPD</DT>
285<DD>Line Printer Daemon</DD>
286<DT>MIME</DT>
287<DD>Multimedia Internet Mail Exchange</DD>
288<DT>PPD</DT>
289<DD>PostScript Printer Description</DD>
290<DT>SMB</DT>
291<DD>Server Message Block</DD>
292<DT>TFTP</DT>
293<DD>Trivial File Transfer Protocol</DD>
294</DL>
295</BODY>
296</HTML>