]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
2abf387c | 2 | .\" "$Id: cupsaddsmb.man.in 6049 2006-10-20 15:07:21Z mike $" |
ef416fc2 | 3 | .\" |
4 | .\" cupsaddsmb man page for the Common UNIX Printing System (CUPS). | |
5 | .\" | |
6 | .\" Copyright 1997-2006 by Easy Software Products. | |
7 | .\" | |
8 | .\" These coded instructions, statements, and computer programs are the | |
9 | .\" property of Easy Software Products and are protected by Federal | |
10 | .\" copyright law. Distribution and use rights are outlined in the file | |
11 | .\" "LICENSE.txt" which should have been included with this file. If this | |
12 | .\" file is missing or damaged please contact Easy Software Products | |
13 | .\" at: | |
14 | .\" | |
15 | .\" Attn: CUPS Licensing Information | |
16 | .\" Easy Software Products | |
17 | .\" 44141 Airport View Drive, Suite 204 | |
18 | .\" Hollywood, Maryland 20636 USA | |
19 | .\" | |
20 | .\" Voice: (301) 373-9600 | |
21 | .\" EMail: cups-info@cups.org | |
22 | .\" WWW: http://www.cups.org | |
23 | .\" | |
2abf387c | 24 | .TH cupsaddsmb 8 "Common UNIX Printing System" "20 October 2006" "Easy Software Products" |
ef416fc2 | 25 | .SH NAME |
26 | cupsaddsmb \- export printers to samba for windows clients | |
89d46774 | 27 | |
ef416fc2 | 28 | .SH SYNOPSIS |
29 | .B cupsaddsmb | |
30 | [ -H | |
31 | .I samba-server | |
32 | ] [ -U | |
33 | .I samba-user[%samba-password] | |
34 | ] [ -h | |
bd7854cb | 35 | .I cups-server[:port] |
ef416fc2 | 36 | ] [ -v ] -a |
37 | .br | |
38 | .B cupsaddsmb | |
39 | [ -H | |
40 | .I samba-server | |
41 | ] [ -U | |
42 | .I samba-user[%samba-password] | |
43 | ] [ -h | |
bd7854cb | 44 | .I cups-server[:port] |
ef416fc2 | 45 | ] [ -v ] printer [ ... printer ] |
89d46774 | 46 | |
ef416fc2 | 47 | .SH DESCRIPTION |
48 | \fIcupsaddsmb\fR exports printers to the SAMBA software (version | |
49 | 2.2.0 or higher) for use with Windows clients. Depending on the | |
50 | SAMBA configuration, you may need to provide a password to | |
51 | export the printers. This program requires the Windows printer | |
52 | driver files described below. | |
89d46774 | 53 | |
bd7854cb | 54 | .SH OPTIONS |
55 | \fIcupsaddsmb\fR supports the following options: | |
56 | .TP 5 | |
57 | -H samba-server | |
58 | .br | |
59 | Specifies the SAMBA server which defaults to the CUPS server. | |
60 | .TP 5 | |
61 | -U samba-user[%samba-password] | |
62 | .br | |
63 | Specifies the SAMBA print admin username which defaults to your | |
64 | current username. If the username contains a percent (%) | |
65 | character, then the text following the percent is treated as the | |
66 | SAMBA password to use. | |
67 | .TP 5 | |
68 | -a | |
69 | .br | |
70 | Exports all known printers. Otherwise only the named printers are | |
71 | exported. | |
72 | .TP 5 | |
73 | -h cups-server[:port] | |
80ca4592 | 74 | .br |
bd7854cb | 75 | Specifies a different CUPS server to use. |
76 | .TP 5 | |
77 | -v | |
80ca4592 | 78 | .br |
bd7854cb | 79 | Specifies that verbose information should be shown. This is |
80 | useful for debugging SAMBA configuration problems. | |
89d46774 | 81 | |
ef416fc2 | 82 | .SH SAMBA CONFIGURATION |
83 | \fIcupsaddsmb\fR uses the new RPC-based printing support in | |
84 | SAMBA 2.2.x to provide printer drivers and PPD files to Windows | |
85 | client machines. In order to use this functionality, you must | |
bd7854cb | 86 | first configure the SAMBA \fIsmb.conf(5)\fR file to support |
ef416fc2 | 87 | printing through CUPS and provide a printer driver download |
88 | share, as follows: | |
89 | .nf | |
90 | ||
91 | [global] | |
92 | load printers = yes | |
93 | printing = cups | |
94 | printcap name = cups | |
95 | ||
96 | [printers] | |
97 | comment = All Printers | |
98 | path = /var/spool/samba | |
99 | browseable = no | |
100 | public = yes | |
101 | guest ok = yes | |
102 | writable = no | |
103 | printable = yes | |
104 | printer admin = root | |
105 | ||
106 | [print$] | |
107 | comment = Printer Drivers | |
108 | path = /etc/samba/drivers | |
109 | browseable = yes | |
110 | guest ok = no | |
111 | read only = yes | |
112 | write list = root | |
113 | .fi | |
114 | .LP | |
115 | This configuration assumes a FHS-compliant installation of | |
116 | SAMBA; adjust the [printers] and [print$] share paths | |
117 | accordingly on your system as needed. | |
118 | ||
119 | .SH MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS | |
120 | The base driver for Windows 2000 and higher is the Microsoft | |
121 | PostScript driver, which is available on any system running | |
122 | Windows 2000 or higher in the | |
2abf387c | 123 | %WINDIR%\\SYSTEM32\\SPOOL\\DRIVERS\\W32X86\\3 folder. |
ef416fc2 | 124 | .LP |
125 | The CUPS printer driver is preferred over the Microsoft driver | |
126 | since it supports the page-label, job-billing, and | |
127 | job-hold-until options fully on all printers. However, currently | |
128 | only Windows 2000 and higher is supported by the Microsoft | |
129 | driver, so you will also need to get the Adobe driver to support | |
130 | Windows 95, 98, and Me clients. The Adobe and Microsoft drivers | |
131 | for Windows 2000 are identical. | |
132 | .LP | |
bd7854cb | 133 | Once you have extracted the driver files, copy them to the |
134 | \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below: | |
ef416fc2 | 135 | .nf |
136 | ||
137 | [Windows 2000 and higher] | |
138 | ps5ui.dll | |
139 | pscript.hlp | |
140 | pscript.ntf | |
141 | pscript5.dll | |
142 | .fi | |
89d46774 | 143 | .LP |
144 | \fBNote:\fR Unlike Windows, case is significant - make sure that | |
145 | you use the lowercase filenames shown above, otherwise | |
146 | \fIcupsaddsmb\fR will fail to export the drivers. | |
ef416fc2 | 147 | |
148 | .SH CUPS POSTSCRIPT DRIVERS FOR WINDOWS | |
149 | \fIcupsaddsmb\fR can use the CUPS v6 PostScript printer driver | |
150 | for Windows, which is available for download from the CUPS web | |
151 | site. | |
152 | .LP | |
153 | The CUPS printer driver is preferred over the Adobe and | |
154 | Microsoft drivers since it supports the page-label, job-billing, | |
155 | and job-hold-until options fully on all printers. However, | |
156 | currently only Windows 2000 and higher is supported by the CUPS | |
157 | driver, so you will also need to get the Adobe driver to support | |
158 | Windows 95, 98, and Me clients. | |
159 | .LP | |
bd7854cb | 160 | Once you have extracted the driver files, copy them to the |
161 | \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below: | |
ef416fc2 | 162 | .nf |
163 | ||
164 | [Windows 2000 and higher] | |
ed486911 | 165 | cups6.inf (from www.cups.org) |
166 | cups6.ini (from www.cups.org) | |
167 | cupsps6.dll (from www.cups.org) | |
168 | cupsui6.dll (from www.cups.org) | |
169 | ps5ui.dll (from your Windows system) | |
170 | pscript.hlp (from your Windows system) | |
171 | pscript.ntf (from your Windows system) | |
172 | pscript5.dll (from your Windows system) | |
ef416fc2 | 173 | .fi |
89d46774 | 174 | .LP |
175 | \fBNote:\fR Unlike Windows, case is significant - make sure that | |
176 | you use the lowercase filenames shown above, otherwise | |
177 | \fIcupsaddsmb\fR will fail to export the drivers. | |
ef416fc2 | 178 | |
bd7854cb | 179 | .SH ADOBE POSTSCRIPT DRIVERS FOR WINDOWS 95, 98, AND ME |
ef416fc2 | 180 | \fIcupsaddsmb\fR can use the Adobe PostScript printer driver for |
bd7854cb | 181 | Windows 95, 98, and ME, which are available for download from the |
182 | Adobe web site (http://www.adobe.com). | |
ef416fc2 | 183 | .LP |
bd7854cb | 184 | The Adobe driver does not support the page-label, job-billing, or |
185 | job-hold-until options. | |
ef416fc2 | 186 | .LP |
89d46774 | 187 | Once you have installed the driver on a Windows system, copy the |
188 | following files to the \fI@CUPS_DATADIR@/drivers\fR directory | |
189 | exactly as named below: | |
ef416fc2 | 190 | .nf |
191 | ||
192 | [Windows 95, 98, and Me] | |
193 | ADFONTS.MFM | |
194 | ADOBEPS4.DRV | |
195 | ADOBEPS4.HLP | |
196 | ICONLIB.DLL | |
197 | PSMON.DLL | |
198 | .fi | |
89d46774 | 199 | .LP |
200 | \fBNote:\fR Unlike Windows, case is significant - make sure that | |
201 | you use the UPPERCASE filenames shown above, otherwise | |
202 | \fIcupsaddsmb\fR will fail to export the drivers. | |
203 | ||
2abf387c | 204 | .SH KNOWN ISSUES |
205 | \fIcupsaddsmb\fR currently only supports 32-bit x86 drivers on | |
206 | Windows 2000 and higher. Support for 64-bit x86 drivers will be | |
207 | added in a future release. | |
208 | ||
ef416fc2 | 209 | .SH SEE ALSO |
bd7854cb | 210 | \fIsmbd(8)\fR, \fIsmb.conf(5)\fR, |
211 | http://localhost:631/help | |
212 | .br | |
ef416fc2 | 213 | http://www.cups.org/windows/ |
89d46774 | 214 | |
ef416fc2 | 215 | .SH COPYRIGHT |
bd7854cb | 216 | Copyright 1997-2006 by Easy Software Products, All Rights Reserved. |
ef416fc2 | 217 | .\" |
2abf387c | 218 | .\" End of "$Id: cupsaddsmb.man.in 6049 2006-10-20 15:07:21Z mike $". |
ef416fc2 | 219 | .\" |