man/cupsaddsmb.man

   1 .\"
   2 .\" "$Id: cupsaddsmb.man 4919 2006-01-12 14:13:01Z mike $"
   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" "12 January 2006" "Easy Software Products"
  25 .SH NAME
  26 cupsaddsmb \- export printers to samba for windows clients
  27 .SH SYNOPSIS
  28 .B cupsaddsmb
  29 [ -H
  30 .I samba-server
  31 ] [ -U
  32 .I samba-user[%samba-password]
  33 ] [ -h
  34 .I cups-server
  35 ] [ -v ] -a
  36 .br
  37 .B cupsaddsmb
  38 [ -H
  39 .I samba-server
  40 ] [ -U
  41 .I samba-user[%samba-password]
  42 ] [ -h
  43 .I cups-server
  44 ] [ -v ] printer [ ... printer ]
  45 .SH DESCRIPTION
  46 \fIcupsaddsmb\fR exports printers to the SAMBA software (version
  47 2.2.0 or higher) for use with Windows clients. Depending on the
  48 SAMBA configuration, you may need to provide a password to
  49 export the printers. This program requires the Windows printer
  50 driver files described below.
  51 .LP
  52 The \fI-H\fR option specifies the SAMBA server which defaults
  53 to the CUPS server.
  54 .LP
  55 The \fI-U\fR option specifies the SAMBA print admin username
  56 which defaults to your current username. If the username contains
  57 a percent (%) character, then the text following the percent is
  58 treated as the SAMBA password to use.
  59 .LP
  60 The \fI-a\fR option exports all known printers. Otherwise only
  61 the named printers are exported.
  62 .LP
  63 The \fI-h\fR option specifies a different CUPS server to use.
  64 .LP
  65 The \fI-v\fR option specifies that verbose information should be
  66 shown and is useful for debugging SAMBA configuration problems.
  67 .SH SAMBA CONFIGURATION
  68 \fIcupsaddsmb\fR 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 SAMBA (via the smb.conf file) to support
  72 printing through CUPS and provide a printer driver download
  73 share, as follows:
  74 .nf
  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         printer admin = root
  90
  91     [print$]
  92         comment = Printer Drivers
  93         path = /etc/samba/drivers
  94         browseable = yes
  95         guest ok = no
  96         read only = yes
  97         write list = root
  98 .fi
  99 .LP
 100 This configuration assumes a FHS-compliant installation of
 101 SAMBA; adjust the [printers] and [print$] share paths
 102 accordingly on your system as needed.
 103
 104 .SH MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS
 105 The base driver for Windows 2000 and higher is the Microsoft
 106 PostScript driver, which is available on any system running
 107 Windows 2000 or higher in the
 108 %WINDOWS%\\SYSTEM32\\SPOOL\\DRIVERS\\W32X86\\3 folder.
 109 .LP
 110 The CUPS printer driver is preferred over the Microsoft driver
 111 since it supports the page-label, job-billing, and
 112 job-hold-until options fully on all printers. However, currently
 113 only Windows 2000 and higher is supported by the Microsoft
 114 driver, so you will also need to get the Adobe driver to support
 115 Windows 95, 98, and Me clients. The Adobe and Microsoft drivers
 116 for Windows 2000 are identical.
 117 .LP
 118 Once you have extracted the driver files, create a "drivers"
 119 directory in the CUPS data directory (usually /usr/share/cups)
 120 and copy the files exactly as named below:
 121 .nf
 122
 123     [Windows 2000 and higher]
 124     ps5ui.dll
 125     pscript.hlp
 126     pscript.ntf
 127     pscript5.dll
 128 .fi
 129
 130 .SH CUPS POSTSCRIPT DRIVERS FOR WINDOWS
 131 \fIcupsaddsmb\fR can use the CUPS v6 PostScript printer driver
 132 for Windows, which is available for download from the CUPS web
 133 site.
 134 .LP
 135 The CUPS printer driver is preferred over the Adobe and
 136 Microsoft drivers since it supports the page-label, job-billing,
 137 and job-hold-until options fully on all printers. However,
 138 currently only Windows 2000 and higher is supported by the CUPS
 139 driver, so you will also need to get the Adobe driver to support
 140 Windows 95, 98, and Me clients.
 141 .LP
 142 Once you have extracted the driver files, create a "drivers"
 143 directory in the CUPS data directory (usually /usr/share/cups)
 144 and copy the files exactly as named below:
 145 .nf
 146
 147     [Windows 2000 and higher]
 148     cups6.ini
 149     cupsui6.dll
 150     cupsdrv6.dll
 151     ps5ui.dll
 152     pscript.hlp
 153     pscript.ntf
 154     pscript5.dll
 155 .fi
 156
 157 .SH ADOBE POSTSCRIPT DRIVERS FOR WINDOWS
 158 \fIcupsaddsmb\fR can use the Adobe PostScript printer driver for
 159 Windows, which are available for download from the Adobe web
 160 site (http://www.adobe.com).
 161 .LP
 162 The CUPS printer driver is preferred over the Adobe drivers
 163 since they support the page-label, job-billing, and
 164 job-hold-until options fully on all printers. You can use the
 165 Adobe drivers for Windows 9x and the CUPS drivers for Windows
 166 2000 and higher. The Adobe and Microsoft drivers for Windows 2000
 167 are identical.
 168 .LP
 169 Once you have extracted the driver files, create a "drivers"
 170 directory in the CUPS data directory (usually /usr/share/cups)
 171 and copy the files exactly as named below:
 172 .nf
 173
 174     [Windows 95, 98, and Me]
 175     ADFONTS.MFM
 176     ADOBEPS4.DRV
 177     ADOBEPS4.HLP
 178     ICONLIB.DLL
 179     PSMON.DLL
 180 .fi
 181 .SH SEE ALSO
 182 CUPS Software Administrators Manual,
 183 http://localhost:631/documentation.html
 184 http://www.cups.org/windows/
 185 .SH COPYRIGHT
 186 Copyright 1993-2006 by Easy Software Products, All Rights Reserved.
 187 .\"
 188 .\" End of "$Id: cupsaddsmb.man 4919 2006-01-12 14:13:01Z mike $".
 189 .\"