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