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