man/cupsaddsmb.man.in

   1 .\"
   2 .\" "$Id: cupsaddsmb.man.in 6649 2007-07-11 21:46:42Z mike $"
   3 .\"
   4 .\"   cupsaddsmb man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 2007 by Apple Inc.
   7 .\"   Copyright 1997-2006 by Easy Software Products.
   8 .\"
   9 .\"   These coded instructions, statements, and computer programs are the
  10 .\"   property of Apple Inc. and are protected by Federal copyright
  11 .\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  12 .\"   which should have been included with this file.  If this file is
  13 .\"   file is missing or damaged, see the license at "http://www.cups.org/".
  14 .\"
  15 .TH cupsaddsmb 8 "Common UNIX Printing System" "20 October 2006" "Apple Inc."
  16 .SH NAME
  17 cupsaddsmb \- export printers to samba for windows clients
  18
  19 .SH SYNOPSIS
  20 .B cupsaddsmb
  21 [ -H
  22 .I samba-server
  23 ] [ -U
  24 .I samba-user[%samba-password]
  25 ] [ -h
  26 .I cups-server[:port]
  27 ] [ -v ] -a
  28 .br
  29 .B cupsaddsmb
  30 [ -H
  31 .I samba-server
  32 ] [ -U
  33 .I samba-user[%samba-password]
  34 ] [ -h
  35 .I cups-server[:port]
  36 ] [ -v ] printer [ ... printer ]
  37
  38 .SH DESCRIPTION
  39 \fIcupsaddsmb\fR exports printers to the SAMBA software (version
  40 2.2.0 or higher) for use with Windows clients. Depending on the
  41 SAMBA configuration, you may need to provide a password to
  42 export the printers. This program requires the Windows printer
  43 driver files described below.
  44
  45 .SH OPTIONS
  46 \fIcupsaddsmb\fR supports the following options:
  47 .TP 5
  48 -H samba-server
  49 .br
  50 Specifies the SAMBA server which defaults to the CUPS server.
  51 .TP 5
  52 -U samba-user[%samba-password]
  53 .br
  54 Specifies the SAMBA print admin username which defaults to your
  55 current username. If the username contains a percent (%)
  56 character, then the text following the percent is treated as the
  57 SAMBA password to use.
  58 .TP 5
  59 -a
  60 .br
  61 Exports all known printers. Otherwise only the named printers are
  62 exported.
  63 .TP 5
  64 -h cups-server[:port]
  65 .br
  66 Specifies a different CUPS server to use.
  67 .TP 5
  68 -v
  69 .br
  70 Specifies that verbose information should be shown. This is
  71 useful for debugging SAMBA configuration problems.
  72
  73 .SH SAMBA CONFIGURATION
  74 \fIcupsaddsmb\fR uses the new RPC-based printing support in
  75 SAMBA 2.2.x to provide printer drivers and PPD files to Windows
  76 client machines. In order to use this functionality, you must
  77 first configure the SAMBA \fIsmb.conf(5)\fR file to support
  78 printing through CUPS and provide a printer driver download
  79 share, as follows:
  80 .nf
  81
  82     [global]
  83         load printers = yes
  84         printing = cups
  85         printcap name = cups
  86
  87     [printers]
  88         comment = All Printers
  89         path = /var/spool/samba
  90         browseable = no
  91         public = yes
  92         guest ok = yes
  93         writable = no
  94         printable = yes
  95         printer admin = root
  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 .fi
 105 .LP
 106 This configuration assumes a FHS-compliant installation of
 107 SAMBA; adjust the [printers] and [print$] share paths
 108 accordingly on your system as needed.
 109
 110 .SH MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS
 111 The base driver for Windows 2000 and higher is the Microsoft
 112 PostScript driver, which is available on any system running
 113 Windows 2000 or higher in the
 114 %WINDIR%\\SYSTEM32\\SPOOL\\DRIVERS\\W32X86\\3 folder.
 115 .LP
 116 The CUPS printer driver is preferred over the Microsoft driver
 117 since it supports the page-label, job-billing, and
 118 job-hold-until options fully on all printers. However, currently
 119 only Windows 2000 and higher is supported by the Microsoft
 120 driver, so you will also need to get the Adobe driver to support
 121 Windows 95, 98, and Me clients. The Adobe and Microsoft drivers
 122 for Windows 2000 are identical.
 123 .LP
 124 Once you have extracted the driver files, copy them to the
 125 \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below:
 126 .nf
 127
 128     [Windows 2000 and higher]
 129     ps5ui.dll
 130     pscript.hlp
 131     pscript.ntf
 132     pscript5.dll
 133 .fi
 134 .LP
 135 \fBNote:\fR Unlike Windows, case is significant - make sure that
 136 you use the lowercase filenames shown above, otherwise
 137 \fIcupsaddsmb\fR will fail to export the drivers.
 138
 139 .SH CUPS POSTSCRIPT DRIVERS FOR WINDOWS
 140 \fIcupsaddsmb\fR can use the CUPS v6 PostScript printer driver
 141 for Windows, which is available for download from the CUPS web
 142 site.
 143 .LP
 144 The CUPS printer driver is preferred over the Adobe and
 145 Microsoft drivers since it supports the page-label, job-billing,
 146 and job-hold-until options fully on all printers. However,
 147 currently only Windows 2000 and higher is supported by the CUPS
 148 driver, so you will also need to get the Adobe driver to support
 149 Windows 95, 98, and Me clients.
 150 .LP
 151 Once you have extracted the driver files, copy them to the
 152 \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below:
 153 .nf
 154
 155     [Windows 2000 and higher]
 156     cups6.inf (from www.cups.org)
 157     cups6.ini (from www.cups.org)
 158     cupsps6.dll (from www.cups.org)
 159     cupsui6.dll (from www.cups.org)
 160     ps5ui.dll (from your Windows system)
 161     pscript.hlp (from your Windows system)
 162     pscript.ntf (from your Windows system)
 163     pscript5.dll (from your Windows system)
 164 .fi
 165 .LP
 166 \fBNote:\fR Unlike Windows, case is significant - make sure that
 167 you use the lowercase filenames shown above, otherwise
 168 \fIcupsaddsmb\fR will fail to export the drivers.
 169
 170 .SH ADOBE POSTSCRIPT DRIVERS FOR WINDOWS 95, 98, AND ME
 171 \fIcupsaddsmb\fR can use the Adobe PostScript printer driver for
 172 Windows 95, 98, and ME, which are available for download from the
 173 Adobe web site (http://www.adobe.com).
 174 .LP
 175 The Adobe driver does not support the page-label, job-billing, or
 176 job-hold-until options.
 177 .LP
 178 Once you have installed the driver on a Windows system, copy the
 179 following files to the \fI@CUPS_DATADIR@/drivers\fR directory
 180 exactly as named below:
 181 .nf
 182
 183     [Windows 95, 98, and Me]
 184     ADFONTS.MFM
 185     ADOBEPS4.DRV
 186     ADOBEPS4.HLP
 187     ICONLIB.DLL
 188     PSMON.DLL
 189 .fi
 190 .LP
 191 \fBNote:\fR Unlike Windows, case is significant - make sure that
 192 you use the UPPERCASE filenames shown above, otherwise
 193 \fIcupsaddsmb\fR will fail to export the drivers.
 194
 195 .SH KNOWN ISSUES
 196 \fIcupsaddsmb\fR currently only supports 32-bit x86 drivers on
 197 Windows 2000 and higher. Support for 64-bit x86 drivers will be
 198 added in a future release.
 199
 200 .SH SEE ALSO
 201 \fIsmbd(8)\fR, \fIsmb.conf(5)\fR,
 202 http://localhost:631/help
 203 .br
 204 http://www.cups.org/windows/
 205
 206 .SH COPYRIGHT
 207 Copyright 2007 by Apple Inc.
 208 .\"
 209 .\" End of "$Id: cupsaddsmb.man.in 6649 2007-07-11 21:46:42Z mike $".
 210 .\"