2 .\" "$Id: cupsaddsmb.man.in 5327 2006-03-23 19:53:24Z 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" "23 March 2006" "Easy Software Products"
26 cupsaddsmb \- export printers to samba for windows clients
32 .I samba-user[%samba-password]
41 .I samba-user[%samba-password]
44 ] [ -v ] printer [ ... printer ]
46 \fIcupsaddsmb\fR exports printers to the SAMBA software (version
47 2.2.0 or higher) for use with Windows clients. Depending on the
48 SAMBA configuration, you may need to provide a password to
49 export the printers. This program requires the Windows printer
50 driver files described below.
52 \fIcupsaddsmb\fR supports the following options:
56 Specifies the SAMBA server which defaults to the CUPS server.
58 -U samba-user[%samba-password]
60 Specifies the SAMBA print admin username which defaults to your
61 current username. If the username contains a percent (%)
62 character, then the text following the percent is treated as the
63 SAMBA password to use.
67 Exports all known printers. Otherwise only the named printers are
72 Specifies a different CUPS server to use.
76 Specifies that verbose information should be shown. This is
77 useful for debugging SAMBA configuration problems.
78 .SH SAMBA CONFIGURATION
79 \fIcupsaddsmb\fR uses the new RPC-based printing support in
80 SAMBA 2.2.x to provide printer drivers and PPD files to Windows
81 client machines. In order to use this functionality, you must
82 first configure the SAMBA \fIsmb.conf(5)\fR file to support
83 printing through CUPS and provide a printer driver download
93 comment = All Printers
94 path = /var/spool/samba
103 comment = Printer Drivers
104 path = /etc/samba/drivers
111 This configuration assumes a FHS-compliant installation of
112 SAMBA; adjust the [printers] and [print$] share paths
113 accordingly on your system as needed.
115 .SH MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS
116 The base driver for Windows 2000 and higher is the Microsoft
117 PostScript driver, which is available on any system running
118 Windows 2000 or higher in the
119 %WINDOWS%\\SYSTEM32\\SPOOL\\DRIVERS\\W32X86\\3 folder.
121 The CUPS printer driver is preferred over the Microsoft driver
122 since it supports the page-label, job-billing, and
123 job-hold-until options fully on all printers. However, currently
124 only Windows 2000 and higher is supported by the Microsoft
125 driver, so you will also need to get the Adobe driver to support
126 Windows 95, 98, and Me clients. The Adobe and Microsoft drivers
127 for Windows 2000 are identical.
129 Once you have extracted the driver files, copy them to the
130 \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below:
133 [Windows 2000 and higher]
140 .SH CUPS POSTSCRIPT DRIVERS FOR WINDOWS
141 \fIcupsaddsmb\fR can use the CUPS v6 PostScript printer driver
142 for Windows, which is available for download from the CUPS web
145 The CUPS printer driver is preferred over the Adobe and
146 Microsoft drivers since it supports the page-label, job-billing,
147 and job-hold-until options fully on all printers. However,
148 currently only Windows 2000 and higher is supported by the CUPS
149 driver, so you will also need to get the Adobe driver to support
150 Windows 95, 98, and Me clients.
152 Once you have extracted the driver files, copy them to the
153 \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below:
156 [Windows 2000 and higher]
166 .SH ADOBE POSTSCRIPT DRIVERS FOR WINDOWS 95, 98, AND ME
167 \fIcupsaddsmb\fR can use the Adobe PostScript printer driver for
168 Windows 95, 98, and ME, which are available for download from the
169 Adobe web site (http://www.adobe.com).
171 The Adobe driver does not support the page-label, job-billing, or
172 job-hold-until options.
174 Once you have extracted the driver files, copy them to the
175 \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below:
178 [Windows 95, 98, and Me]
186 \fIsmbd(8)\fR, \fIsmb.conf(5)\fR,
187 http://localhost:631/help
189 http://www.cups.org/windows/
191 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
193 .\" End of "$Id: cupsaddsmb.man.in 5327 2006-03-23 19:53:24Z mike $".