doc/help/man-cupsaddsmb.html

   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>
  11 cupsaddsmb - 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>
  47 The <b>cupsaddsmb</b> program exports printers to the SAMBA software (version 2.2.0 or higher) for use with Windows clients.
  48 Depending on the SAMBA configuration, you may need to provide a password to export the printers.
  49 This 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.
  52 In order to use this functionality, you must first configure the SAMBA
  53 <b>smb.conf</b>(5)
  54 file to support printing through CUPS and provide a printer driver download
  55 share, 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>
  81 This 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>
  83 The 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.
 101 If 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.
 104 Otherwise 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.
 109 This 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),
 116 CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
 117 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
 118 Copyright &copy; 2007-2015 by Apple Inc.
 119
 120 </body>
 121 </html>