man/cupsaddsmb.man.in

   1 .\"
   2 .\" "$Id: cupsaddsmb.man.in 5327 2006-03-23 19:53:24Z 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" "23 March 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[:port]
  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[:port]
  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 .SH OPTIONS
  52 \fIcupsaddsmb\fR supports the following options:
  53 .TP 5
  54 -H samba-server
  55 .br
  56 Specifies the SAMBA server which defaults to the CUPS server.
  57 .TP 5
  58 -U samba-user[%samba-password]
  59 .br
  60 Specifies the SAMBA print admin username which defaults to your
  61 current username. If the username contains a percent (%)
  62 character, then the text following the percent is treated as the
  63 SAMBA password to use.
  64 .TP 5
  65 -a
  66 .br
  67 Exports all known printers. Otherwise only the named printers are
  68 exported.
  69 .TP 5
  70 -h cups-server[:port]
  71 .br
  72 Specifies a different CUPS server to use.
  73 .TP 5
  74 -v
  75 .br
  76 Specifies that verbose information should be shown. This is
  77 useful for debugging SAMBA configuration problems.
  78 .SH SAMBA CONFIGURATION
  79 \fIcupsaddsmb\fR uses the new RPC-based printing support in
  80 SAMBA 2.2.x to provide printer drivers and PPD files to Windows
  81 client machines. In order to use this functionality, you must
  82 first configure the SAMBA \fIsmb.conf(5)\fR file to support
  83 printing through CUPS and provide a printer driver download
  84 share, as follows:
  85 .nf
  86
  87     [global]
  88         load printers = yes
  89         printing = cups
  90         printcap name = cups
  91
  92     [printers]
  93         comment = All Printers
  94         path = /var/spool/samba
  95         browseable = no
  96         public = yes
  97         guest ok = yes
  98         writable = no
  99         printable = yes
 100         printer admin = root
 101
 102     [print$]
 103         comment = Printer Drivers
 104         path = /etc/samba/drivers
 105         browseable = yes
 106         guest ok = no
 107         read only = yes
 108         write list = root
 109 .fi
 110 .LP
 111 This configuration assumes a FHS-compliant installation of
 112 SAMBA; adjust the [printers] and [print$] share paths
 113 accordingly on your system as needed.
 114
 115 .SH MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS
 116 The base driver for Windows 2000 and higher is the Microsoft
 117 PostScript driver, which is available on any system running
 118 Windows 2000 or higher in the
 119 %WINDOWS%\\SYSTEM32\\SPOOL\\DRIVERS\\W32X86\\3 folder.
 120 .LP
 121 The CUPS printer driver is preferred over the Microsoft driver
 122 since it supports the page-label, job-billing, and
 123 job-hold-until options fully on all printers. However, currently
 124 only Windows 2000 and higher is supported by the Microsoft
 125 driver, so you will also need to get the Adobe driver to support
 126 Windows 95, 98, and Me clients. The Adobe and Microsoft drivers
 127 for Windows 2000 are identical.
 128 .LP
 129 Once you have extracted the driver files, copy them to the
 130 \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below:
 131 .nf
 132
 133     [Windows 2000 and higher]
 134     ps5ui.dll
 135     pscript.hlp
 136     pscript.ntf
 137     pscript5.dll
 138 .fi
 139
 140 .SH CUPS POSTSCRIPT DRIVERS FOR WINDOWS
 141 \fIcupsaddsmb\fR can use the CUPS v6 PostScript printer driver
 142 for Windows, which is available for download from the CUPS web
 143 site.
 144 .LP
 145 The CUPS printer driver is preferred over the Adobe and
 146 Microsoft drivers since it supports the page-label, job-billing,
 147 and job-hold-until options fully on all printers. However,
 148 currently only Windows 2000 and higher is supported by the CUPS
 149 driver, so you will also need to get the Adobe driver to support
 150 Windows 95, 98, and Me clients.
 151 .LP
 152 Once you have extracted the driver files, copy them to the
 153 \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below:
 154 .nf
 155
 156     [Windows 2000 and higher]
 157     cups6.ini
 158     cupsui6.dll
 159     cupsdrv6.dll
 160     ps5ui.dll
 161     pscript.hlp
 162     pscript.ntf
 163     pscript5.dll
 164 .fi
 165
 166 .SH ADOBE POSTSCRIPT DRIVERS FOR WINDOWS 95, 98, AND ME
 167 \fIcupsaddsmb\fR can use the Adobe PostScript printer driver for
 168 Windows 95, 98, and ME, which are available for download from the
 169 Adobe web site (http://www.adobe.com).
 170 .LP
 171 The Adobe driver does not support the page-label, job-billing, or
 172 job-hold-until options.
 173 .LP
 174 Once you have extracted the driver files, copy them to the
 175 \fI@CUPS_DATADIR@/drivers\fR directory exactly as named below:
 176 .nf
 177
 178     [Windows 95, 98, and Me]
 179     ADFONTS.MFM
 180     ADOBEPS4.DRV
 181     ADOBEPS4.HLP
 182     ICONLIB.DLL
 183     PSMON.DLL
 184 .fi
 185 .SH SEE ALSO
 186 \fIsmbd(8)\fR, \fIsmb.conf(5)\fR,
 187 http://localhost:631/help
 188 .br
 189 http://www.cups.org/windows/
 190 .SH COPYRIGHT
 191 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
 192 .\"
 193 .\" End of "$Id: cupsaddsmb.man.in 5327 2006-03-23 19:53:24Z mike $".
 194 .\"