]>
Commit | Line | Data |
---|---|---|
d7871c8c | 1 | README - CUPS v1.4b3 - 2009-03-09 |
61cf44e2 MS |
2 | --------------------------------- |
3 | ||
4 | ********************************************************************** | |
5 | ********************************************************************** | |
6 | ********** ********** | |
7 | ********** THIS IS BETA-RELEASE SOFTWARE. DO NOT USE ON ********** | |
8 | ********** PRODUCTION SYSTEMS! REPORT PROBLEMS TO THE ********** | |
9 | ********** CUPS FORUMS OR BUG REPORTING PAGES: ********** | |
10 | ********** ********** | |
11 | ********** http://www.cups.org/newsgroups.php (FORUMS) ********** | |
12 | ********** http://www.cups.org/str.php (BUGS) ********** | |
13 | ********** ********** | |
14 | ********************************************************************** | |
15 | ********************************************************************** | |
ef416fc2 | 16 | |
17 | Looking for compile instructions? Read the file "INSTALL.txt" | |
18 | instead... | |
19 | ||
ef416fc2 | 20 | |
21 | INTRODUCTION | |
22 | ||
557dde9f MS |
23 | The Common UNIX Printing System ("CUPS") is a standards-based, open source |
24 | printing system developed by Apple Inc. for Mac OS® X and other UNIX®-like | |
25 | operating systems. CUPS uses the Internet Printing Protocol ("IPP") and | |
26 | provides System V and Berkeley command-line interfaces, a web interface, | |
27 | and a C API to manage printers and print jobs. It supports printing to | |
28 | both local (parallel, serial, USB) and networked printers, and printers can | |
29 | be shared from one computer to another, even over the Internet! | |
ef416fc2 | 30 | |
557dde9f MS |
31 | Internally, CUPS uses PostScript Printer Description ("PPD") files to |
32 | describe printer capabilities and features and a wide variety of generic | |
33 | and device-specific programs to convert and print many types of files. | |
34 | Sample drivers are included with CUPS to support many Dymo, EPSON, HP, | |
35 | Intellitech, OKIDATA, and Zebra printers. Many more drivers are available | |
36 | online and (in some cases) on the driver CD-ROM that came with your printer. | |
ef416fc2 | 37 | |
557dde9f MS |
38 | CUPS is licensed under the GNU General Public License and GNU Library |
39 | General Public License versions 2. See the file "LICENSE.txt" for more | |
40 | information. | |
ef416fc2 | 41 | |
42 | ||
43 | READING THE DOCUMENTATION | |
44 | ||
557dde9f MS |
45 | Once you have installed the software you can access the documentation (and |
46 | a bunch of other stuff) online at: | |
ef416fc2 | 47 | |
4744bd90 | 48 | http://localhost:631/ |
ef416fc2 | 49 | |
557dde9f MS |
50 | If you're having trouble getting that far, the documentation is located |
51 | under the "doc/help" directory. | |
ef416fc2 | 52 | |
4744bd90 | 53 | Please read the documentation before asking questions. |
ef416fc2 | 54 | |
55 | ||
56 | GETTING SUPPORT AND OTHER RESOURCES | |
57 | ||
557dde9f MS |
58 | If you have problems, READ THE DOCUMENTATION FIRST! We also provide many |
59 | discussion forums which are available at: | |
ef416fc2 | 60 | |
4744bd90 | 61 | http://www.cups.org/newsgroups.php |
ef416fc2 | 62 | |
557dde9f | 63 | See the CUPS web site at "http://www.cups.org/" for other resources. |
ef416fc2 | 64 | |
65 | ||
66 | SETTING UP PRINTER QUEUES USING YOUR WEB BROWSER | |
67 | ||
557dde9f MS |
68 | CUPS includes a web-based administration tool that allows you to manage |
69 | printers, classes, and jobs on your server. Open the following URL in your | |
70 | browser to access the printer administration tools: | |
ef416fc2 | 71 | |
4744bd90 | 72 | http://localhost:631/admin/ |
ef416fc2 | 73 | |
557dde9f MS |
74 | DO NOT use the hostname for your machine - it will not work with the default |
75 | CUPS configuration. To enable administration access on other addresses, | |
76 | check the "Allow Remote Administration" box and click on the "Change | |
77 | Settings" button. | |
ef416fc2 | 78 | |
557dde9f MS |
79 | You will be asked for the administration password (root or any other user in |
80 | the sys/system/root/admin/lpadmin group on your system) when performing any | |
81 | administrative function. | |
ef416fc2 | 82 | |
83 | ||
84 | SETTING UP PRINTER QUEUES FROM THE COMMAND-LINE | |
85 | ||
557dde9f MS |
86 | CUPS works best with PPD (PostScript Printer Description) files. In a pinch |
87 | you can also use System V style printer interface scripts. | |
ef416fc2 | 88 | |
4744bd90 | 89 | CUPS includes several sample PPD files you can use: |
ef416fc2 | 90 | |
557dde9f | 91 | Driver PPD Name |
61cf44e2 MS |
92 | ----------------------------- ------------------------------ |
93 | Dymo Label Printers drv:///sample.drv/dymo.ppd | |
94 | Intellitech Intellibar drv:///sample.drv/intelbar.ppd | |
95 | EPSON Stylus Color Series drv:///sample.drv/stcolor.ppd | |
96 | EPSON Stylus Photo Series drv:///sample.drv/stphoto.ppd | |
97 | EPSON Stylus New Color Series drv:///sample.drv/stcolor2.ppd | |
98 | EPSON Stylus New Photo Series drv:///sample.drv/stphoto2.ppd | |
99 | EPSON 9-pin Series drv:///sample.drv/epson9.ppd | |
100 | EPSON 24-pin Series drv:///sample.drv/epson24.ppd | |
557dde9f MS |
101 | Generic PCL Laser Printer drv:///sample.drv/generpcl.ppd |
102 | Generic PostScript Printer drv:///sample.drv/generic.ppd | |
61cf44e2 MS |
103 | HP DeskJet Series drv:///sample.drv/deskjet.ppd |
104 | HP LaserJet Series drv:///sample.drv/laserjet.ppd | |
105 | OKIDATA 9-Pin Series drv:///sample.drv/okidata9.ppd | |
106 | OKIDATA 24-Pin Series drv:///sample.drv/okidat24.ppd | |
107 | Zebra CPCL Label Printer drv:///sample.drv/zebracpl.ppd | |
108 | Zebra EPL1 Label Printer drv:///sample.drv/zebraep1.ppd | |
109 | Zebra EPL2 Label Printer drv:///sample.drv/zebraep2.ppd | |
110 | Zebra ZPL Label Printer drv:///sample.drv/zebra.ppd | |
111 | ||
112 | Run the "lpinfo -m" command to list the available drivers: | |
113 | ||
114 | lpinfo -m | |
115 | ||
116 | Run the "lpinfo -v" command to list the available printers: | |
ef416fc2 | 117 | |
4744bd90 | 118 | lpinfo -v |
ef416fc2 | 119 | |
557dde9f | 120 | Then use the correct URI to add the printer using the "lpadmin" command: |
ef416fc2 | 121 | |
557dde9f | 122 | lpadmin -p printername -E -v device-uri -m ppd-name |
ef416fc2 | 123 | |
4744bd90 | 124 | Network printers typically use "socket" or "lpd" URIs: |
ef416fc2 | 125 | |
557dde9f MS |
126 | lpadmin -p printername -E -v socket://11.22.33.44 -m ppd-name |
127 | lpadmin -p printername -E -v lpd://11.22.33.44/ -m ppd-name | |
128 | ||
129 | The sample drivers provide basic printing capabilities, but generally do not | |
130 | exercise the full potential of the printers or CUPS. The CUPS web site | |
131 | provides links and drivers: | |
ef416fc2 | 132 | |
557dde9f MS |
133 | http://www.cups.org/ppd.php PPD files |
134 | http://www.cups.org/links.php Links to other drivers | |
ef416fc2 | 135 | |
136 | ||
137 | PRINTING FILES | |
138 | ||
557dde9f MS |
139 | CUPS provides both the System V "lp" and Berkeley "lpr" commands for |
140 | printing: | |
ef416fc2 | 141 | |
4744bd90 | 142 | lp filename |
143 | lpr filename | |
ef416fc2 | 144 | |
557dde9f | 145 | Both the "lp" and "lpr" commands support printing options for the driver: |
ef416fc2 | 146 | |
557dde9f MS |
147 | lp -o media=A4 -o resolution=600dpi filename |
148 | lpr -o media=A4 -o resolution=600dpi filename | |
ef416fc2 | 149 | |
557dde9f MS |
150 | CUPS recognizes many types of images files as well as PDF, PostScript, |
151 | HP-GL/2, and text files, so you can print those files directly rather than | |
152 | through an application. | |
ef416fc2 | 153 | |
557dde9f MS |
154 | If you have an application that generates output specifically for your |
155 | printer then you need to use the "-oraw" or "-l" options: | |
ef416fc2 | 156 | |
557dde9f | 157 | lp -o raw filename |
4744bd90 | 158 | lpr -l filename |
ef416fc2 | 159 | |
4744bd90 | 160 | This will prevent the filters from misinterpreting your print |
161 | file. | |
ef416fc2 | 162 | |
163 | ||
164 | LEGAL STUFF | |
165 | ||
d7871c8c MS |
166 | CUPS is Copyright 2007-2009 by Apple Inc. CUPS and the CUPS logo are |
167 | trademarks of Apple Inc. | |
ef416fc2 | 168 | |
4744bd90 | 169 | The MD5 Digest code is Copyright 1999 Aladdin Enterprises. |
ef416fc2 | 170 | |
557dde9f | 171 | This software is based in part on the work of the Independent JPEG Group. |
ef416fc2 | 172 | |
557dde9f MS |
173 | CUPS is provided under the terms of version 2 of the GNU General Public |
174 | License and GNU Library General Public License. This program is distributed | |
175 | in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even | |
176 | the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | |
177 | See the "doc/help/license.html" or "LICENSE.txt" files for more information. |