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 [ -H
  16 <i>samba-server</i>
  17 ] [ -U
  18 <i>samba-user[%samba-password]</i>
  19 ] [ -h
  20 <i>cups-server[:port]</i>
  21 ] [ -v ] -a
  22 <br>
  23 <b>cupsaddsmb</b>
  24 [ -H
  25 <i>samba-server</i>
  26 ] [ -U
  27 <i>samba-user[%samba-password]</i>
  28 ] [ -h
  29 <i>cups-server[:port]</i>
  30 ] [ -v ] printer [ ... printer ]
  31
  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.
  38
  39 <h2 class="title"><a name="OPTIONS">Options</a></h2>
  40 <i>cupsaddsmb</i> supports the following options:
  41 <dl class="man">
  42 <dt>-H samba-server
  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.
  51 <dt>-a
  52 <dd style="margin-left: 5.0em"><br>
  53 Exports all known printers. Otherwise only the named printers are
  54 exported.
  55 <dt>-h cups-server[:port]
  56 <dd style="margin-left: 5.0em"><br>
  57 Specifies a different CUPS server to use.
  58 <dt>-v
  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.
  62
  63 </dl>
  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
  70 share, as follows:
  71 <pre class="man">
  72
  73     [global]
  74         load printers = yes
  75         printing = cups
  76         printcap name = cups
  77
  78     [printers]
  79         comment = All Printers
  80         path = /var/spool/samba
  81         browseable = no
  82         public = yes
  83         guest ok = yes
  84         writable = no
  85         printable = yes
  86
  87     [print$]
  88         comment = Printer Drivers
  89         path = /etc/samba/drivers
  90         browseable = yes
  91         guest ok = no
  92         read only = yes
  93         write list = root
  94 </pre>
  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.
  98
  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
 104 drivers and
 105 %WINDIR%\SYSTEM32\SPOOL\DRIVERS\X64\3 folder for 64-bit
 106 drivers.
 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
 114 as named below:
 115 <pre class="man">
 116
 117     [Windows 2000 and higher]
 118     ps5ui.dll
 119     pscript.hlp
 120     pscript.ntf
 121     pscript5.dll
 122 </pre>
 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.
 126
 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:
 136 <pre class="man">
 137
 138     [Windows 95, 98, and Me]
 139     ADFONTS.MFM
 140     ADOBEPS4.DRV
 141     ADOBEPS4.HLP
 142     ICONLIB.DLL
 143     PSMON.DLL
 144 </pre>
 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.
 148
 149 <h2 class="title"><a name="KNOWN_ISSUES">Known Issues</a></h2>
 150 Getting the full set of Windows driver files should be easier.
 151
 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>
 155
 156 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
 157 Copyright 2007-2013 by Apple Inc.
 158
 159 </body>
 160 </html>