1<!DOCTYPE HTML>
2<html>
3<!-- SECTION: Man Pages -->
4<head>
5	<link rel="stylesheet" type="text/css" href="/cups-printable.css">
6	<title>cupsaddsmb(8)</title>
7</head>
8<body>
9<h1 class="title">cupsaddsmb(8)</h1>
10<h2 class="title"><a name="NAME">Name</a></h2>
11cupsaddsmb - export printers to samba for windows clients
12
13<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
14<b>cupsaddsmb</b>
15[
16<b>-H</b>
17<i>samba-server</i>
18] [
19<b>-U</b>
20<i>samba-user[%samba-password]</i>
21] [
22<b>-h</b>
23<i>cups-server[:port]</i>
24] [
25<b>-v</b>
26]
27<b>-a</b>
28<br>
29<b>cupsaddsmb</b>
30[
31<b>-H</b>
32<i>samba-server</i>
33] [
34<b>-U</b>
35<i>samba-user[%samba-password]</i>
36] [
37<b>-h</b>
38<i>cups-server[:port]</i>
39] [
40<b>-v</b>
41]
42<i>printer</i>
43[ ...
44<i>printer</i>
45]
46<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
47The <b>cupsaddsmb</b> program exports printers to the SAMBA software (version 2.2.0 or higher) for use with Windows clients.
48Depending on the SAMBA configuration, you may need to provide a password to export the printers.
49This program requires the Windows printer driver files described below.
50<h3><a name="SAMBA_CONFIGURATION">Samba Configuration</a></h3>
51<b>cupsaddsmb</b> uses the RPC-based printing support in SAMBA to provide printer drivers and PPD files to Windows client machines.
52In order to use this functionality, you must first configure the SAMBA
53<b>smb.conf</b>(5)
54file to support printing through CUPS and provide a printer driver download
55share, as follows:
56<pre class="man">
57
58    [global]
59	load printers = yes
60	printing = cups
61	printcap name = cups
62
63    [printers]
64	comment = All Printers
65	path = /var/spool/samba
66	browseable = no
67	public = yes
68	guest ok = yes
69	writable = no
70	printable = yes
71
72    [print$]
73	comment = Printer Drivers
74	path = /etc/samba/drivers
75	browseable = yes
76	guest ok = no
77	read only = yes
78	write list = root
79
80</pre>
81This configuration assumes a FHS-compliant installation of SAMBA; adjust the [printers] and [print$] share paths accordingly on your system as needed.
82<h3><a name="MICROSOFT_POSTSCRIPT_DRIVERS_FOR_WINDOWS">Microsoft Postscript Drivers For Windows</a></h3>
83The base driver for Windows 2000 and higher is the Microsoft PostScript driver, which is available on any system running Windows 2000 or higher in the %WINDIR%\SYSTEM32\SPOOL\DRIVERS\W32X86\3 folder for 32-bit drivers and %WINDIR%\SYSTEM32\SPOOL\DRIVERS\X64\3 folder for 64-bit drivers.
84<p>Copy the 32-bit drivers to the <i>/usr/share/cups/drivers</i> directory and the 64-bit drivers to the <i>/usr/share/cups/drivers/x64</i> directory exactly as named below:
85<pre class="man">
86
87    ps5ui.dll
88    pscript.hlp
89    pscript.ntf
90    pscript5.dll
91
92</pre>
93<b>Note:</b> Unlike Windows, case is significant - make sure that you use the lowercase filenames shown above, otherwise <b>cupsaddsmb</b> will fail to export the drivers.
94<h2 class="title"><a name="OPTIONS">Options</a></h2>
95<b>cupsaddsmb</b> supports the following options:
96<dl class="man">
97<dt><b>-H </b><i>samba-server</i>
98<dd style="margin-left: 5.0em">Specifies the SAMBA server which defaults to the CUPS server.
99<dt><b>-U </b><i>samba-user</i>[<b>%</b><i>samba-password</i>]
100<dd style="margin-left: 5.0em">Specifies the SAMBA print admin username which defaults to your current username.
101If the username contains a percent (%) character, then the text following the percent is treated as the SAMBA password to use.
102<dt><b>-a</b>
103<dd style="margin-left: 5.0em">Exports all known printers.
104Otherwise only the named printers are exported.
105<dt><b>-h </b><i>cups-server</i>[<b>:</b><i>port</i>]
106<dd style="margin-left: 5.0em">Specifies a different CUPS server to use.
107<dt><b>-v</b>
108<dd style="margin-left: 5.0em">Specifies that verbose information should be shown.
109This is useful for debugging SAMBA configuration problems.
110</dl>
111<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
112<b>rpcclient</b>(1),
113<b>smbclient</b>(1),
114<b>smbd</b>(8),
115<b>smb.conf</b>(5),
116CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
117<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
118Copyright &copy; 2007-2014 by Apple Inc.
119
120</body>
121</html>
122