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