]>
Commit | Line | Data |
---|---|---|
f3955b6b | 1 | README - CUPS v1.3.0 - 2007-08-03 |
2 | --------------------------------- | |
3fe51f4f | 3 | |
93d2f0c0 | 4 | Looking for compile instructions? Read the file "INSTALL.txt" |
5 | instead... | |
58834631 | 6 | |
3e7eb9bb | 7 | |
93d2f0c0 | 8 | INTRODUCTION |
3e7eb9bb | 9 | |
781996c9 | 10 | CUPS provides a portable printing layer for UNIX(r)-based |
87af3cc8 | 11 | operating systems. It was developed by Easy Software Products |
12 | and is now owned and maintained by Apple Inc. to promote a | |
13 | standard printing solution for all UNIX vendors and users. CUPS | |
14 | provides the System V and Berkeley command-line interfaces. | |
d50c1a7c | 15 | |
781996c9 | 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 | |
22 | to support real-world printing under UNIX. | |
d50c1a7c | 23 | |
781996c9 | 24 | CUPS includes an image file RIP that supports printing of |
67774b09 | 25 | image files to non-PostScript printers. GPL Ghostscript now |
26 | includes the "cups" driver to support printing of PostScript | |
27 | files within the CUPS driver framework. Sample drivers for | |
28 | Dymo, EPSON, HP, OKIDATA, and Zebra printers are included that | |
29 | use these filters. | |
d50c1a7c | 30 | |
781996c9 | 31 | CUPS is licensed under the GNU General Public License and GNU |
87af3cc8 | 32 | Library General Public License versions 2. |
5d66e133 | 33 | |
34 | ||
cedfb4b7 | 35 | READING THE DOCUMENTATION |
36 | ||
781996c9 | 37 | Once you have installed the software you can access the |
38 | documentation (and a bunch of other stuff) on-line at: | |
cedfb4b7 | 39 | |
781996c9 | 40 | http://localhost:631/ |
cedfb4b7 | 41 | |
781996c9 | 42 | If you're having trouble getting that far, the documentation |
43 | is located under the "doc/help" directory. | |
cedfb4b7 | 44 | |
781996c9 | 45 | Please read the documentation before asking questions. |
cedfb4b7 | 46 | |
47 | ||
93d2f0c0 | 48 | GETTING SUPPORT AND OTHER RESOURCES |
49 | ||
781996c9 | 50 | If you have problems, READ THE DOCUMENTATION FIRST! We also |
51 | provide many discussion forums which are available at: | |
93d2f0c0 | 52 | |
781996c9 | 53 | http://www.cups.org/newsgroups.php |
93d2f0c0 | 54 | |
781996c9 | 55 | See the CUPS web site at "http://www.cups.org/" for other |
56 | site links. | |
93d2f0c0 | 57 | |
58 | ||
64ec3e94 | 59 | SETTING UP PRINTER QUEUES USING YOUR WEB BROWSER |
60 | ||
87af3cc8 | 61 | CUPS 1.3 includes a web-based administration tool that allows |
781996c9 | 62 | you to manage printers, classes, and jobs on your server. |
63 | Open the following URL in your browser to access the printer | |
64 | administration tools: | |
64ec3e94 | 65 | |
781996c9 | 66 | http://localhost:631/admin/ |
64ec3e94 | 67 | |
781996c9 | 68 | DO NOT use the hostname for your machine - it will not work |
69 | with the default CUPS configuration. To enable | |
70 | administration access on other addresses, check the "Allow | |
71 | Remote Administration" box and click on the "Change Settings" | |
72 | button. | |
64ec3e94 | 73 | |
781996c9 | 74 | You will be asked for the administration password (root or |
75 | any other user in the sys/system/root group on your system) | |
76 | when performing any administrative function. | |
5d66e133 | 77 | |
64ec3e94 | 78 | |
79 | SETTING UP PRINTER QUEUES FROM THE COMMAND-LINE | |
3e7eb9bb | 80 | |
781996c9 | 81 | CUPS works best with PPD (PostScript Printer Description) |
82 | files. In a pinch you can also use System V style printer | |
83 | interface scripts. | |
3e7eb9bb | 84 | |
781996c9 | 85 | CUPS includes several sample PPD files you can use: |
c9e6a22c | 86 | |
781996c9 | 87 | Driver PPD File |
88 | ----------------------------- ------------ | |
89 | Dymo Label Printers dymo.ppd | |
87af3cc8 | 90 | Intellitech Intellibar intelbar.ppd |
781996c9 | 91 | EPSON Stylus Color Series stcolor.ppd |
92 | EPSON Stylus Photo Series stphoto.ppd | |
93 | EPSON Stylus New Color Series stcolor2.ppd | |
94 | EPSON Stylus New Photo Series stphoto2.ppd | |
95 | EPSON 9-pin Series epson9.ppd | |
96 | EPSON 24-pin Series epson24.ppd | |
97 | HP DeskJet Series deskjet.ppd | |
98 | HP LaserJet Series laserjet.ppd | |
99 | OKIDATA 9-Pin Series okidata9.ppd | |
100 | OKIDATA 24-Pin Series okidat24.ppd | |
489ffdaf | 101 | Zebra CPCL Label Printer zebracpl.ppd |
781996c9 | 102 | Zebra EPL1 Label Printer zebraep1.ppd |
103 | Zebra EPL2 Label Printer zebraep2.ppd | |
104 | Zebra ZPL Label Printer zebra.ppd | |
3e7eb9bb | 105 | |
781996c9 | 106 | Run the "lpinfo" command to list the available printers: |
3e7eb9bb | 107 | |
781996c9 | 108 | lpinfo -v |
3e7eb9bb | 109 | |
781996c9 | 110 | Then use the correct URI to add the printer using the |
111 | "lpadmin" command: | |
3e7eb9bb | 112 | |
781996c9 | 113 | lpadmin -p printername -E -v URI -m filename.ppd |
3e7eb9bb | 114 | |
781996c9 | 115 | Network printers typically use "socket" or "lpd" URIs: |
d50c1a7c | 116 | |
781996c9 | 117 | lpadmin -p printername -E -v socket://11.22.33.44 -m filename.ppd |
118 | lpadmin -p printername -E -v lpd://11.22.33.44/ -m filename.ppd | |
d50c1a7c | 119 | |
781996c9 | 120 | The sample drivers provide basic printing capabilities, but |
121 | generally do not exercise the full potential of the printers | |
4e8d321f | 122 | or CUPS. |
093b0c0f | 123 | |
d50c1a7c | 124 | |
125 | PRINTING FILES | |
126 | ||
781996c9 | 127 | CUPS provides both the System V "lp" and Berkeley "lpr" |
128 | commands for printing: | |
d50c1a7c | 129 | |
781996c9 | 130 | lp filename |
131 | lpr filename | |
d50c1a7c | 132 | |
781996c9 | 133 | Both the "lp" and "lpr" commands support printing options for |
134 | the driver: | |
d50c1a7c | 135 | |
781996c9 | 136 | lp -omedia=A4 -oresolution=600dpi filename |
137 | lpr -omedia=A4 -oresolution=600dpi filename | |
d50c1a7c | 138 | |
781996c9 | 139 | CUPS recognizes many types of images files as well as PDF, |
140 | PostScript, HP-GL/2, and text files, so you can print those | |
141 | files directly rather than through an application. | |
d50c1a7c | 142 | |
781996c9 | 143 | If you have an application that generates output specifically |
144 | for your printer then you need to use the "-oraw" or "-l" | |
145 | options: | |
d50c1a7c | 146 | |
781996c9 | 147 | lp -oraw filename |
148 | lpr -l filename | |
d50c1a7c | 149 | |
781996c9 | 150 | This will prevent the filters from misinterpreting your print |
151 | file. | |
3e7eb9bb | 152 | |
c9e6a22c | 153 | |
154 | LEGAL STUFF | |
3e7eb9bb | 155 | |
4e8d321f | 156 | CUPS is Copyright 2007 by Apple Inc. CUPS, the CUPS logo, and |
157 | the Common UNIX Printing System are the trademark property of | |
158 | Apple Inc. | |
d50c1a7c | 159 | |
781996c9 | 160 | The MD5 Digest code is Copyright 1999 Aladdin Enterprises. |
5d66e133 | 161 | |
781996c9 | 162 | The PDF filter (pdftops) is based on the Xpdf software, |
163 | Copyright 1996-2005 by Derek B. Noonburg. | |
5d66e133 | 164 | |
781996c9 | 165 | This software is based in part on the work of the Independent |
166 | JPEG Group. | |
5d66e133 | 167 | |
781996c9 | 168 | CUPS is provided under the terms of the GNU General Public |
169 | License and GNU Library General Public License. This program | |
170 | is distributed in the hope that it will be useful, but | |
171 | WITHOUT ANY WARRANTY; without even the implied warranty of | |
172 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
173 | "doc/help/license.html" or "LICENSE.txt" files for more | |
174 | information. |