]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
bc44d920 | 2 | .\" "$Id: cupsaddsmb.man.in 6649 2007-07-11 21:46:42Z mike $" |
ef416fc2 | 3 | .\" |
4 | .\" cupsaddsmb man page for the Common UNIX Printing System (CUPS). | |
5 | .\" | |
bc44d920 | 6 | .\" Copyright 2007 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 | .\" |
bc44d920 | 15 | .TH cupsaddsmb 8 "Common UNIX Printing System" "20 October 2006" "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 | |
95 | printer admin = root | |
96 | ||
97 | [print$] | |
98 | comment = Printer Drivers | |
99 | path = /etc/samba/drivers | |
100 | browseable = yes | |
101 | guest ok = no | |
102 | read only = yes | |
103 | write list = root | |
104 | .fi | |
105 | .LP | |
106 | This configuration assumes a FHS-compliant installation of | |
107 | SAMBA; adjust the [printers] and [print$] share paths | |
108 | accordingly on your system as needed. | |
109 | ||
110 | .SH MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS | |
111 | The base driver for Windows 2000 and higher is the Microsoft | |
112 | PostScript driver, which is available on any system running | |
113 | Windows 2000 or higher in the | |
2abf387c | 114 | %WINDIR%\\SYSTEM32\\SPOOL\\DRIVERS\\W32X86\\3 folder. |
ef416fc2 | 115 | .LP |
116 | The CUPS printer driver is preferred over the Microsoft driver | |
117 | since it supports the page-label, job-billing, and | |
118 | job-hold-until options fully on all printers. However, currently | |
119 | only Windows 2000 and higher is supported by the Microsoft | |
120 | driver, so you will also need to get the Adobe driver to support | |
121 | Windows 95, 98, and Me clients. The Adobe and Microsoft drivers | |
122 | for Windows 2000 are identical. | |
123 | .LP | |
bd7854cb | 124 | Once you have extracted the driver files, copy them to the |
125 | \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below: | |
ef416fc2 | 126 | .nf |
127 | ||
128 | [Windows 2000 and higher] | |
129 | ps5ui.dll | |
130 | pscript.hlp | |
131 | pscript.ntf | |
132 | pscript5.dll | |
133 | .fi | |
89d46774 | 134 | .LP |
135 | \fBNote:\fR Unlike Windows, case is significant - make sure that | |
136 | you use the lowercase filenames shown above, otherwise | |
137 | \fIcupsaddsmb\fR will fail to export the drivers. | |
ef416fc2 | 138 | |
139 | .SH CUPS POSTSCRIPT DRIVERS FOR WINDOWS | |
140 | \fIcupsaddsmb\fR can use the CUPS v6 PostScript printer driver | |
141 | for Windows, which is available for download from the CUPS web | |
142 | site. | |
143 | .LP | |
144 | The CUPS printer driver is preferred over the Adobe and | |
145 | Microsoft drivers since it supports the page-label, job-billing, | |
146 | and job-hold-until options fully on all printers. However, | |
147 | currently only Windows 2000 and higher is supported by the CUPS | |
148 | driver, so you will also need to get the Adobe driver to support | |
149 | Windows 95, 98, and Me clients. | |
150 | .LP | |
bd7854cb | 151 | Once you have extracted the driver files, copy them to the |
152 | \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below: | |
ef416fc2 | 153 | .nf |
154 | ||
155 | [Windows 2000 and higher] | |
ed486911 | 156 | cups6.inf (from www.cups.org) |
157 | cups6.ini (from www.cups.org) | |
158 | cupsps6.dll (from www.cups.org) | |
159 | cupsui6.dll (from www.cups.org) | |
160 | ps5ui.dll (from your Windows system) | |
161 | pscript.hlp (from your Windows system) | |
162 | pscript.ntf (from your Windows system) | |
163 | pscript5.dll (from your Windows system) | |
ef416fc2 | 164 | .fi |
89d46774 | 165 | .LP |
166 | \fBNote:\fR Unlike Windows, case is significant - make sure that | |
167 | you use the lowercase filenames shown above, otherwise | |
168 | \fIcupsaddsmb\fR will fail to export the drivers. | |
ef416fc2 | 169 | |
bd7854cb | 170 | .SH ADOBE POSTSCRIPT DRIVERS FOR WINDOWS 95, 98, AND ME |
ef416fc2 | 171 | \fIcupsaddsmb\fR can use the Adobe PostScript printer driver for |
bd7854cb | 172 | Windows 95, 98, and ME, which are available for download from the |
173 | Adobe web site (http://www.adobe.com). | |
ef416fc2 | 174 | .LP |
bd7854cb | 175 | The Adobe driver does not support the page-label, job-billing, or |
176 | job-hold-until options. | |
ef416fc2 | 177 | .LP |
89d46774 | 178 | Once you have installed the driver on a Windows system, copy the |
179 | following files to the \fI@CUPS_DATADIR@/drivers\fR directory | |
180 | exactly as named below: | |
ef416fc2 | 181 | .nf |
182 | ||
183 | [Windows 95, 98, and Me] | |
184 | ADFONTS.MFM | |
185 | ADOBEPS4.DRV | |
186 | ADOBEPS4.HLP | |
187 | ICONLIB.DLL | |
188 | PSMON.DLL | |
189 | .fi | |
89d46774 | 190 | .LP |
191 | \fBNote:\fR Unlike Windows, case is significant - make sure that | |
192 | you use the UPPERCASE filenames shown above, otherwise | |
193 | \fIcupsaddsmb\fR will fail to export the drivers. | |
194 | ||
2abf387c | 195 | .SH KNOWN ISSUES |
196 | \fIcupsaddsmb\fR currently only supports 32-bit x86 drivers on | |
197 | Windows 2000 and higher. Support for 64-bit x86 drivers will be | |
198 | added in a future release. | |
199 | ||
ef416fc2 | 200 | .SH SEE ALSO |
bd7854cb | 201 | \fIsmbd(8)\fR, \fIsmb.conf(5)\fR, |
202 | http://localhost:631/help | |
203 | .br | |
ef416fc2 | 204 | http://www.cups.org/windows/ |
89d46774 | 205 | |
ef416fc2 | 206 | .SH COPYRIGHT |
bc44d920 | 207 | Copyright 2007 by Apple Inc. |
ef416fc2 | 208 | .\" |
bc44d920 | 209 | .\" End of "$Id: cupsaddsmb.man.in 6649 2007-07-11 21:46:42Z mike $". |
ef416fc2 | 210 | .\" |