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 © 2007-2014 by Apple Inc. 119 120</body> 121</html> 122