[thirdparty/cups.git] / doc / svd.html

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