3 <!-- SECTION: Man Pages -->
5 <link rel=
"stylesheet" type=
"text/css" href=
"../cups-printable.css">
6 <title>cupsaddsmb(
8)
</title>
9 <h1 class=
"title">cupsaddsmb(
8)
</h1>
10 <h2 class=
"title"><a name=
"NAME">Name
</a></h2>
11 cupsaddsmb - export printers to samba for windows clients
13 <h2 class=
"title"><a name=
"SYNOPSIS">Synopsis
</a></h2>
18 <i>samba-user[%samba-password]
</i>
20 <i>cups-server[:port]
</i>
27 <i>samba-user[%samba-password]
</i>
29 <i>cups-server[:port]
</i>
30 ] [ -v ] printer [ ... printer ]
32 <h2 class=
"title"><a name=
"DESCRIPTION">Description
</a></h2>
33 <i>cupsaddsmb
</i> exports printers to the SAMBA software (version
34 2.2.0 or higher) for use with Windows clients. Depending on the
35 SAMBA configuration, you may need to provide a password to
36 export the printers. This program requires the Windows printer
37 driver files described below.
39 <h2 class=
"title"><a name=
"OPTIONS">Options
</a></h2>
40 <i>cupsaddsmb
</i> supports the following options:
43 <dd style=
"margin-left: 5.0em"><br>
44 Specifies the SAMBA server which defaults to the CUPS server.
45 <dt>-U samba-user[%samba-password]
46 <dd style=
"margin-left: 5.0em"><br>
47 Specifies the SAMBA print admin username which defaults to your
48 current username. If the username contains a percent (%)
49 character, then the text following the percent is treated as the
50 SAMBA password to use.
52 <dd style=
"margin-left: 5.0em"><br>
53 Exports all known printers. Otherwise only the named printers are
55 <dt>-h cups-server[:port]
56 <dd style=
"margin-left: 5.0em"><br>
57 Specifies a different CUPS server to use.
59 <dd style=
"margin-left: 5.0em"><br>
60 Specifies that verbose information should be shown. This is
61 useful for debugging SAMBA configuration problems.
64 <h2 class=
"title"><a name=
"SAMBA_CONFIGURATION">Samba Configuration
</a></h2>
65 <i>cupsaddsmb
</i> uses the new RPC-based printing support in
66 SAMBA
2.2.x to provide printer drivers and PPD files to Windows
67 client machines. In order to use this functionality, you must
68 first configure the SAMBA
<i>smb.conf(
5)
</i> file to support
69 printing through CUPS and provide a printer driver download
79 comment = All Printers
80 path = /var/spool/samba
88 comment = Printer Drivers
89 path = /etc/samba/drivers
95 <p>This configuration assumes a FHS-compliant installation of
96 SAMBA; adjust the [printers] and [print$] share paths
97 accordingly on your system as needed.
99 <h2 class=
"title"><a name=
"MICROSOFT_POSTSCRIPT_DRIVERS_FOR_WINDOWS">Microsoft Postscript Drivers For Windows
</a></h2>
100 The base driver for Windows
2000 and higher is the Microsoft
101 PostScript driver, which is available on any system running
102 Windows
2000 or higher in the
103 %WINDIR%\SYSTEM32\SPOOL\DRIVERS\W32X86\
3 folder for
32-bit
105 %WINDIR%\SYSTEM32\SPOOL\DRIVERS\X64\
3 folder for
64-bit
107 <p>However, currently only Windows
2000 and higher is supported by the Microsoft
108 driver, so you will also need to get the Adobe driver to support
109 Windows
95,
98, and Me clients. The Adobe and Microsoft drivers
110 for Windows
2000 are identical.
111 <p>Once you have extracted the driver files, copy the
32-bit drivers
112 to the
<i>/usr/share/cups/drivers
</i> directory and the
64-bit
113 drivers to the
<i>/usr/share/cups/drivers/x64
</i> directory exactly
117 [Windows
2000 and higher]
123 <p><b>Note:
</b> Unlike Windows, case is significant - make sure that
124 you use the lowercase filenames shown above, otherwise
125 <i>cupsaddsmb
</i> will fail to export the drivers.
127 <h2 class=
"title"><a name=
"ADOBE_POSTSCRIPT_DRIVERS_FOR_WINDOWS_95__98__AND_ME">Adobe Postscript Drivers For Windows
95,
98, And Me
</a></h2>
128 <i>cupsaddsmb
</i> can use the Adobe PostScript printer driver for
129 Windows
95,
98, and ME, which are available for download from the
130 Adobe web site (
<a href=
"http://www.adobe.com)">http://www.adobe.com)
</a>.
131 <p>The Adobe driver does not support the page-label, job-billing, or
132 job-hold-until options.
133 <p>Once you have installed the driver on a Windows system, copy the
134 following files to the
<i>/usr/share/cups/drivers
</i> directory
135 exactly as named below:
138 [Windows
95,
98, and Me]
145 <p><b>Note:
</b> Unlike Windows, case is significant - make sure that
146 you use the UPPERCASE filenames shown above, otherwise
147 <i>cupsaddsmb
</i> will fail to export the drivers.
149 <h2 class=
"title"><a name=
"KNOWN_ISSUES">Known Issues
</a></h2>
150 Getting the full set of Windows driver files should be easier.
152 <h2 class=
"title"><a name=
"SEE_ALSO">See Also
</a></h2>
153 <i>smbd(
8)
</i>,
<i>smb.conf(
5)
</i>,
154 <a href=
"http://localhost:631/help">http://localhost:
631/help
</a>
156 <h2 class=
"title"><a name=
"COPYRIGHT">Copyright
</a></h2>
157 Copyright
2007-
2013 by Apple Inc.