2 .\" "$Id: cupsaddsmb.man.in 6047 2006-10-20 14:52:55Z mike $"
4 .\" cupsaddsmb man page for the Common UNIX Printing System (CUPS).
6 .\" Copyright 1997-2006 by Easy Software Products.
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
15 .\" Attn: CUPS Licensing Information
16 .\" Easy Software Products
17 .\" 44141 Airport View Drive, Suite 204
18 .\" Hollywood, Maryland 20636 USA
20 .\" Voice: (301) 373-9600
21 .\" EMail: cups-info@cups.org
22 .\" WWW: http://www.cups.org
24 .TH cupsaddsmb 8 "Common UNIX Printing System" "20 October 2006" "Easy Software Products"
26 cupsaddsmb \- export printers to samba for windows clients
33 .I samba-user[%samba-password]
42 .I samba-user[%samba-password]
45 ] [ -v ] printer [ ... printer ]
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.
55 \fIcupsaddsmb\fR supports the following options:
59 Specifies the SAMBA server which defaults to the CUPS server.
61 -U samba-user[%samba-password]
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.
70 Exports all known printers. Otherwise only the named printers are
75 Specifies a different CUPS server to use.
79 Specifies that verbose information should be shown. This is
80 useful for debugging SAMBA configuration problems.
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
86 first configure the SAMBA \fIsmb.conf(5)\fR file to support
87 printing through CUPS and provide a printer driver download
97 comment = All Printers
98 path = /var/spool/samba
107 comment = Printer Drivers
108 path = /etc/samba/drivers
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.
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
123 %WINDIR%\\SYSTEM32\\SPOOL\\DRIVERS\\W32X86\\3 folder.
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.
133 Once you have extracted the driver files, copy them to the
134 \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below:
137 [Windows 2000 and higher]
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.
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
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.
160 Once you have extracted the driver files, copy them to the
161 \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below:
164 [Windows 2000 and higher]
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)
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.
179 .SH ADOBE POSTSCRIPT DRIVERS FOR WINDOWS 95, 98, AND ME
180 \fIcupsaddsmb\fR can use the Adobe PostScript printer driver for
181 Windows 95, 98, and ME, which are available for download from the
182 Adobe web site (http://www.adobe.com).
184 The Adobe driver does not support the page-label, job-billing, or
185 job-hold-until options.
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:
192 [Windows 95, 98, and Me]
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.
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.
210 \fIsmbd(8)\fR, \fIsmb.conf(5)\fR,
211 http://localhost:631/help
213 http://www.cups.org/windows/
216 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
218 .\" End of "$Id: cupsaddsmb.man.in 6047 2006-10-20 14:52:55Z mike $".