man/cupsaddsmb.man.in

   1 .\"
   2 .\" "$Id: cupsaddsmb.man.in 11206 2013-07-31 18:16:09Z msweet $"
   3 .\"
   4 .\"   cupsaddsmb man page for CUPS.
   5 .\"
   6 .\"   Copyright 2007-2013 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 "CUPS" "8 July 2013" "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
  96     [print$]
  97         comment = Printer Drivers
  98         path = /etc/samba/drivers
  99         browseable = yes
 100         guest ok = no
 101         read only = yes
 102         write list = root
 103 .fi
 104 .LP
 105 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 .SH MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS
 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 .LP
 118 However, currently only Windows 2000 and higher is supported by the Microsoft
 119 driver, so you will also need to get the Adobe driver to support
 120 Windows 95, 98, and Me clients. The Adobe and Microsoft drivers
 121 for Windows 2000 are identical.
 122 .LP
 123 Once you have extracted the driver files, copy the 32-bit drivers
 124 to the \fI/usr/share/cups/drivers\fR directory and the 64-bit
 125 drivers to the \fI/usr/share/cups/drivers/x64\fR directory exactly
 126 as named below:
 127 .nf
 128
 129     [Windows 2000 and higher]
 130     ps5ui.dll
 131     pscript.hlp
 132     pscript.ntf
 133     pscript5.dll
 134 .fi
 135 .LP
 136 \fBNote:\fR Unlike Windows, case is significant - make sure that
 137 you use the lowercase filenames shown above, otherwise
 138 \fIcupsaddsmb\fR will fail to export the drivers.
 139
 140 .SH ADOBE POSTSCRIPT DRIVERS FOR WINDOWS 95, 98, AND ME
 141 \fIcupsaddsmb\fR can use the Adobe PostScript printer driver for
 142 Windows 95, 98, and ME, which are available for download from the
 143 Adobe web site (http://www.adobe.com).
 144 .LP
 145 The Adobe driver does not support the page-label, job-billing, or
 146 job-hold-until options.
 147 .LP
 148 Once you have installed the driver on a Windows system, copy the
 149 following files to the \fI/usr/share/cups/drivers\fR directory
 150 exactly as named below:
 151 .nf
 152
 153     [Windows 95, 98, and Me]
 154     ADFONTS.MFM
 155     ADOBEPS4.DRV
 156     ADOBEPS4.HLP
 157     ICONLIB.DLL
 158     PSMON.DLL
 159 .fi
 160 .LP
 161 \fBNote:\fR Unlike Windows, case is significant - make sure that
 162 you use the UPPERCASE filenames shown above, otherwise
 163 \fIcupsaddsmb\fR will fail to export the drivers.
 164
 165 .SH KNOWN ISSUES
 166 Getting the full set of Windows driver files should be easier.
 167
 168 .SH SEE ALSO
 169 \fIsmbd(8)\fR, \fIsmb.conf(5)\fR,
 170 http://localhost:631/help
 171
 172 .SH COPYRIGHT
 173 Copyright 2007-2013 by Apple Inc.
 174 .\"
 175 .\" End of "$Id: cupsaddsmb.man.in 11206 2013-07-31 18:16:09Z msweet $".
 176 .\"