doc/help/man-cupsaddsmb.html

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