man/cupsaddsmb.man.in

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