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 <p style="margin-left: 5.0em; text-indent: -5.0em">-H samba-server
  42 <br>
  43 <br>
  44 Specifies the SAMBA server which defaults to the CUPS server.
  45 <p style="margin-left: 5.0em; text-indent: -5.0em">-U samba-user[%samba-password]
  46 <br>
  47 <br>
  48 Specifies the SAMBA print admin username which defaults to your
  49 current username. If the username contains a percent (%)
  50 character, then the text following the percent is treated as the
  51 SAMBA password to use.
  52 <p style="margin-left: 5.0em; text-indent: -5.0em">-a
  53 <br>
  54 <br>
  55 Exports all known printers. Otherwise only the named printers are
  56 exported.
  57 <p style="margin-left: 5.0em; text-indent: -5.0em">-h cups-server[:port]
  58 <br>
  59 <br>
  60 Specifies a different CUPS server to use.
  61 <p style="margin-left: 5.0em; text-indent: -5.0em">-v
  62 <br>
  63 <br>
  64 Specifies that verbose information should be shown. This is
  65 useful for debugging SAMBA configuration problems.
  66
  67 <h2 class="title"><a name="SAMBA_CONFIGURATION">Samba Configuration</a></h2>
  68 <i>cupsaddsmb</i> uses the new RPC-based printing support in
  69 SAMBA 2.2.x to provide printer drivers and PPD files to Windows
  70 client machines. In order to use this functionality, you must
  71 first configure the SAMBA <i>smb.conf(5)</i> file to support
  72 printing through CUPS and provide a printer driver download
  73 share, as follows:
  74 <pre>
  75
  76     [global]
  77         load printers = yes
  78         printing = cups
  79         printcap name = cups
  80
  81     [printers]
  82         comment = All Printers
  83         path = /var/spool/samba
  84         browseable = no
  85         public = yes
  86         guest ok = yes
  87         writable = no
  88         printable = yes
  89
  90     [print$]
  91         comment = Printer Drivers
  92         path = /etc/samba/drivers
  93         browseable = yes
  94         guest ok = no
  95         read only = yes
  96         write list = root
  97 </pre>
  98 <p>This configuration assumes a FHS-compliant installation of
  99 SAMBA; adjust the [printers] and [print$] share paths
 100 accordingly on your system as needed.
 101
 102 <h2 class="title"><a name="MICROSOFT_POSTSCRIPT_DRIVERS_FOR_WINDOWS">Microsoft Postscript Drivers For Windows</a></h2>
 103 The base driver for Windows 2000 and higher is the Microsoft
 104 PostScript driver, which is available on any system running
 105 Windows 2000 or higher in the
 106 %WINDIR%\SYSTEM32\SPOOL\DRIVERS\W32X86\3 folder for 32-bit
 107 drivers and
 108 %WINDIR%\SYSTEM32\SPOOL\DRIVERS\X64\3 folder for 64-bit
 109 drivers.
 110 <p>However, currently only Windows 2000 and higher is supported by the Microsoft
 111 driver, so you will also need to get the Adobe driver to support
 112 Windows 95, 98, and Me clients. The Adobe and Microsoft drivers
 113 for Windows 2000 are identical.
 114 <p>Once you have extracted the driver files, copy the 32-bit drivers
 115 to the <i>/usr/share/cups/drivers</i> directory and the 64-bit
 116 drivers to the <i>/usr/share/cups/drivers/x64</i> directory exactly
 117 as named below:
 118 <pre>
 119
 120     [Windows 2000 and higher]
 121     ps5ui.dll
 122     pscript.hlp
 123     pscript.ntf
 124     pscript5.dll
 125 </pre>
 126 <p><b>Note:</b> Unlike Windows, case is significant - make sure that
 127 you use the lowercase filenames shown above, otherwise
 128 <i>cupsaddsmb</i> will fail to export the drivers.
 129
 130 <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>
 131 <i>cupsaddsmb</i> can use the Adobe PostScript printer driver for
 132 Windows 95, 98, and ME, which are available for download from the
 133 Adobe web site (<a href="http://www.adobe.com).">http://www.adobe.com).</a>
 134 <p>The Adobe driver does not support the page-label, job-billing, or
 135 job-hold-until options.
 136 <p>Once you have installed the driver on a Windows system, copy the
 137 following files to the <i>/usr/share/cups/drivers</i> directory
 138 exactly as named below:
 139 <pre>
 140
 141     [Windows 95, 98, and Me]
 142     ADFONTS.MFM
 143     ADOBEPS4.DRV
 144     ADOBEPS4.HLP
 145     ICONLIB.DLL
 146     PSMON.DLL
 147 </pre>
 148 <p><b>Note:</b> Unlike Windows, case is significant - make sure that
 149 you use the UPPERCASE filenames shown above, otherwise
 150 <i>cupsaddsmb</i> will fail to export the drivers.
 151
 152 <h2 class="title"><a name="KNOWN_ISSUES">Known Issues</a></h2>
 153 Getting the full set of Windows driver files should be easier.
 154
 155 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
 156 <i>smbd(8)</i>, <i>smb.conf(5)</i>,
 157 <a href="http://localhost:631/help">http://localhost:631/help</a>
 158
 159 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
 160 Copyright 2007-2013 by Apple Inc.
 161
 162 </body>
 163 </html>