]>
Commit | Line | Data |
---|---|---|
7159de3d | 1 | README - CUPS v1.1.9 - 07/06/2001 |
5a39f97a | 2 | --------------------------------- |
64ec3e94 | 3 | |
93d2f0c0 | 4 | Looking for compile instructions? Read the file "INSTALL.txt" |
5 | instead... | |
58834631 | 6 | |
3e7eb9bb | 7 | |
93d2f0c0 | 8 | INTRODUCTION |
3e7eb9bb | 9 | |
93d2f0c0 | 10 | CUPS provides a portable printing layer for UNIX(r)-based |
11 | operating systems. It has been developed by Easy Software | |
12 | Products to promote a standard printing solution for all UNIX | |
13 | vendors and users. CUPS provides the System V and Berkeley | |
14 | command-line interfaces. | |
15 | ||
16 | CUPS uses the Internet Printing Protocol ("IPP") as the basis | |
17 | for managing print jobs and queues. The Line Printer Daemon | |
18 | ("LPD") Server Message Block ("SMB"), and AppSocket (a.k.a. | |
19 | JetDirect) protocols are also supported with reduced | |
20 | functionality. CUPS adds network printer browsing and | |
21 | PostScript Printer Description ("PPD") based printing options to | |
22 | support real-world printing under UNIX. | |
23 | ||
24 | CUPS also includes a customized version of GNU Ghostscript | |
25 | (currently based off GNU Ghostscript 5.50) and an image file RIP | |
26 | that are used to support non-PostScript printers. Sample | |
27 | drivers for HP and EPSON printers are included that use these | |
28 | filters. | |
29 | ||
30 | Drivers for over 2300 printers are provided with our ESP Print | |
31 | Pro software, available at: | |
3e7eb9bb | 32 | |
58834631 | 33 | http://www.easysw.com/printpro |
d50c1a7c | 34 | |
93d2f0c0 | 35 | CUPS is licensed under the GNU General Public License and GNU |
36 | Library General Public License. Please contact Easy Software | |
37 | Products for commercial support and "binary distribution" | |
38 | rights. | |
d50c1a7c | 39 | |
40 | ||
41 | SYSTEM REQUIREMENTS | |
42 | ||
93d2f0c0 | 43 | Binary distributions require a minimum of 10MB of free disk |
44 | space. We do not recommend using CUPS on a workstation with less | |
45 | than 32MB of RAM or a PC with less than 16MB of RAM. | |
d50c1a7c | 46 | |
93d2f0c0 | 47 | If you are installing from source you'll need ANSI-compliant C |
48 | and C++ compilers and optionally one or more image file support | |
49 | libraries. Complete source installation instructions can be | |
50 | found in the file "INSTALL.txt". | |
d50c1a7c | 51 | |
52 | ||
53 | SOFTWARE REQUIREMENTS | |
54 | ||
7428af94 | 55 | The following operating system software is required to install |
56 | one of the binary distributions from Easy Software Products: | |
d50c1a7c | 57 | |
7159de3d | 58 | - AIX 4.3 or higher |
59 | - Compaq Tru64 UNIX (aka OSF1 aka Digital UNIX) 4.0 or higher | |
d50c1a7c | 60 | - HP-UX 10.20 or higher |
61 | - IRIX 5.3 or higher | |
cedfb4b7 | 62 | - Linux 2.0 with glibc2 or higher |
d50c1a7c | 63 | - Solaris 2.5 or higher (SPARC or Intel) |
64 | ||
65 | ||
5d66e133 | 66 | INSTALLING "PORTABLE" CUPS DISTRIBUTIONS |
d50c1a7c | 67 | |
93d2f0c0 | 68 | We are currently distributing "portable" CUPS binary |
69 | distributions in TAR format with installation and removal | |
70 | scripts generated by our ESP Package Manager (EPM) software, | |
71 | which is available from: | |
cedfb4b7 | 72 | |
73 | http://www.easysw.com/epm | |
d50c1a7c | 74 | |
93d2f0c0 | 75 | WARNING: Installing CUPS will overwrite your existing printing |
76 | system. Backup files are made by the installation script and | |
77 | restored by the removal script, so if you experience problems | |
78 | you should be able to remove the CUPS software to restore your | |
79 | previous configuration. However, Easy Software Products makes | |
80 | no warranty for this and will not be liable for any lost | |
81 | revenues, etc. | |
3e7eb9bb | 82 | |
93d2f0c0 | 83 | To install the CUPS software you will need to be logged in as |
84 | root (doing an "su" is good enough). Once you are the root | |
85 | user, run the installation script with: | |
c9e6a22c | 86 | |
d50c1a7c | 87 | ./cups.install ENTER |
3e7eb9bb | 88 | |
93d2f0c0 | 89 | After asking you a few yes/no questions the CUPS software will |
90 | be installed and the scheduler will be started automatically. | |
3e7eb9bb | 91 | |
3e7eb9bb | 92 | |
5d66e133 | 93 | INSTALLING HOST-SPECIFIC (RPM, DEBIAN, ETC.) DISTRIBUTIONS |
94 | ||
93d2f0c0 | 95 | The host-specific distributions use the operating system |
96 | software installation tools. To install a host-specific | |
97 | distribution please consult the CUPS Software Administrators | |
98 | Manual or your operating system documentation. | |
5d66e133 | 99 | |
100 | ||
cedfb4b7 | 101 | READING THE DOCUMENTATION |
102 | ||
93d2f0c0 | 103 | Once you have installed the software you can access the |
104 | documentation (and a bunch of other stuff) on-line at: | |
cedfb4b7 | 105 | |
106 | http://localhost:631 | |
107 | ||
93d2f0c0 | 108 | If you're having trouble getting that far, the documentation is |
109 | located in the "/usr/share/doc/cups" directory in the binary | |
110 | distributions, and under the "doc" directory in the source | |
111 | archives. | |
cedfb4b7 | 112 | |
113 | Please read the documentation before asking questions. | |
114 | ||
115 | ||
93d2f0c0 | 116 | GETTING SUPPORT AND OTHER RESOURCES |
117 | ||
118 | If you have problems, READ THE DOCUMENTATION FIRST! | |
119 | ||
120 | You can subscribe to the CUPS mailing list by sending a message | |
121 | containing "subscribe cups" to majordomo@cups.org. This list is | |
122 | provided to discuss problems, questions, and improvements to the | |
123 | CUPS software. New releases of CUPS are announced to this list | |
124 | as well. | |
125 | ||
126 | Commercial support (with a guaranteed response time) is | |
127 | available from Easy Software Products. For more information | |
128 | see: | |
129 | ||
130 | http://www.easysw.com/cups | |
131 | ||
132 | See the CUPS web site at "http://www.cups.org" for other site | |
133 | links. | |
134 | ||
135 | ||
64ec3e94 | 136 | SETTING UP PRINTER QUEUES USING YOUR WEB BROWSER |
137 | ||
93d2f0c0 | 138 | CUPS 1.1 includes a new web-based administration tool that |
139 | allows you to manage printers, classes, and jobs on your | |
140 | server. To access the printer administration tools open the | |
141 | following URL in your browser: | |
64ec3e94 | 142 | |
143 | http://localhost:631/admin | |
144 | ||
93d2f0c0 | 145 | You will be asked for the administration password (root or any |
146 | other user in the sys/system/root group on your system) and then | |
147 | shown a menu of available functions. | |
64ec3e94 | 148 | |
93d2f0c0 | 149 | DO NOT use the hostname for your machine - it will not work with |
150 | the default CUPS configuration. To enable administration access | |
151 | on other addresses, consult the CUPS Software Administrators | |
152 | Manual. | |
5d66e133 | 153 | |
64ec3e94 | 154 | |
155 | SETTING UP PRINTER QUEUES FROM THE COMMAND-LINE | |
3e7eb9bb | 156 | |
93d2f0c0 | 157 | CUPS works best with PPD (PostScript Printer Description) |
158 | files. In a pinch you can also use System V style printer | |
159 | interface scripts. | |
3e7eb9bb | 160 | |
93d2f0c0 | 161 | Six sample PPD files are provided with this distribution that |
162 | utilize the PostScript and image file RIPs and the sample EPSON | |
163 | and HP printer drivers. To add the sample DeskJet driver to the | |
164 | system for a printer connected to the parallel port, use one of | |
165 | the following commands: | |
c9e6a22c | 166 | |
d50c1a7c | 167 | Digital UNIX: |
3e7eb9bb | 168 | |
d50c1a7c | 169 | /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/lp0 -E |
3e7eb9bb | 170 | |
d50c1a7c | 171 | HP-UX: |
3e7eb9bb | 172 | |
d50c1a7c | 173 | /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/c2t0d0_lp -E |
c9e6a22c | 174 | |
d50c1a7c | 175 | IRIX: |
3e7eb9bb | 176 | |
d50c1a7c | 177 | /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/plp -E |
3e7eb9bb | 178 | |
d50c1a7c | 179 | Linux: |
3e7eb9bb | 180 | |
64ec3e94 | 181 | /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/lp0 -E |
182 | /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/lp1 -E | |
183 | /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/lp2 -E | |
3e7eb9bb | 184 | |
d50c1a7c | 185 | Solaris: |
3e7eb9bb | 186 | |
d50c1a7c | 187 | /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/bpp0 -E |
188 | /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/ecpp0 -E | |
189 | ||
64ec3e94 | 190 | Similarly, for the other sample drivers you can use: |
d50c1a7c | 191 | |
7159de3d | 192 | Driver PPD File |
193 | ----------------------------- ------------ | |
194 | HP DeskJet Series deskjet.ppd | |
195 | HP New DeskJet Series deskjet2.ppd | |
196 | HP LaserJet Series laserjet.ppd | |
197 | EPSON Stylus Color Series stcolor.ppd | |
198 | EPSON Stylus Photo Series stphoto.ppd | |
199 | EPSON Stylus New Color Series stcolor2.ppd | |
200 | EPSON Stylus New Photo Series stphoto2.ppd | |
201 | EPSON 9-pin Series epson9.ppd | |
202 | EPSON 24-pin Series epson24.ppd | |
d50c1a7c | 203 | |
93d2f0c0 | 204 | These sample drivers provide basic printing capabilities, but |
205 | generally do not exercise the full potential of the printers or | |
206 | CUPS. For commercial printer drivers check out our ESP Print | |
207 | Pro software at: | |
093b0c0f | 208 | |
209 | http://www.easysw.com/printpro | |
210 | ||
d50c1a7c | 211 | |
212 | PRINTING FILES | |
213 | ||
93d2f0c0 | 214 | CUPS provides both the System V "lp" and Berkeley "lpr" commands |
215 | for printing: | |
d50c1a7c | 216 | |
217 | lp filename | |
218 | lpr filename | |
219 | ||
93d2f0c0 | 220 | Both the "lp" and "lpr" commands support printing options for |
221 | the driver: | |
d50c1a7c | 222 | |
223 | lp -omedia=A4 -oresolution=600dpi filename | |
224 | lpr -omedia=A4 -oresolution=600dpi filename | |
225 | ||
93d2f0c0 | 226 | CUPS recognizes many types of images files as well as PDF, |
227 | PostScript, HP-GL/2, and text files, so you can print those | |
228 | files directly rather than through an application. | |
d50c1a7c | 229 | |
93d2f0c0 | 230 | If you have an application that generates output specifically |
231 | for your printer then you need to use the "-oraw" or "-l" | |
232 | options: | |
d50c1a7c | 233 | |
234 | lp -oraw filename | |
235 | lpr -l filename | |
236 | ||
93d2f0c0 | 237 | This will prevent the filters from misinterpreting your print |
238 | file. | |
3e7eb9bb | 239 | |
c9e6a22c | 240 | |
241 | LEGAL STUFF | |
3e7eb9bb | 242 | |
d2935a0f | 243 | CUPS is Copyright 1993-2001 by Easy Software Products. CUPS, |
93d2f0c0 | 244 | the CUPS logo, and the Common UNIX Printing System are the |
245 | trademark property of Easy Software Products. | |
d50c1a7c | 246 | |
5d66e133 | 247 | The MD5 Digest code is Copyright 1999 Aladdin Enterprises. |
248 | ||
249 | The PostScript RIP software (pstoraster) is based on the GNU | |
93d2f0c0 | 250 | Ghostscript 5.50 core, Copyright 1986-1998 by Aladdin |
251 | Enterprises. | |
5d66e133 | 252 | |
7159de3d | 253 | The PDF filter (pdftops) is based on the Xpdf 0.92 software, |
254 | Copyright 1996-2001 by Derek B. Noonburg. | |
5d66e133 | 255 | |
93d2f0c0 | 256 | This software is based in part on the work of the Independent |
257 | JPEG Group. | |
5d66e133 | 258 | |
93d2f0c0 | 259 | CUPS is provided under the terms of the GNU General Public |
260 | License and GNU Library General Public License. This program is | |
261 | distributed in the hope that it will be useful, but WITHOUT ANY | |
262 | WARRANTY; without even the implied warranty of MERCHANTABILITY | |
263 | or FITNESS FOR A PARTICULAR PURPOSE. See the "LICENSE.html", | |
264 | "LICENSE.txt", or "cups.license" files for more information. | |
58834631 | 265 | |
266 | For commercial licensing information, please contact: | |
3e7eb9bb | 267 | |
d50c1a7c | 268 | Attn: CUPS Licensing Information |
269 | Easy Software Products | |
270 | 44141 Airport View Drive, Suite 204 | |
271 | Hollywood, Maryland 20636-3111 USA | |
3e7eb9bb | 272 | |
e338c390 | 273 | Voice: +1.301.373.9600 |
d50c1a7c | 274 | Email: cups-info@cups.org |
275 | WWW: http://www.cups.org | |
58834631 | 276 | |
93d2f0c0 | 277 | Note that commercial licensors may also require a license from |
278 | Artifex Software Inc. which handles commercial licensing of the | |
279 | Ghostscript software, and from Derek B. Noonburg who developed | |
280 | the Xpdf software used to print PDF files. |