docs/textdocs/PRINTER_DRIVER.txt

   1 !==
   2 !== PRINTER_DRIVER.txt for Samba release TNG-prealpha 11 Feb 2000
   3 !==
   4 ==========================================================================
   5         Supporting the famous PRINTER$ share
   6
   7         Jean-Francois.Micouleau@utc.fr, 10/26/97
   8         modified by herb@sgi.com 1/2/98
   9
  10 ===========================================================================
  11
  12 Disclaimer:
  13
  14         This ONLY works with Windows 95
  15         It does NOT work with Windows NT 4
  16
  17
  18 Goal:
  19
  20         When you click on a samba shared printer, you can now install the driver
  21         automatically onto the Windows 95 machine, as you would from an NT server.
  22
  23 How To:
  24
  25         It's a three step config.
  26
  27         First, create a new directory, where you will put the driver files, and
  28         make a share in smb.conf pointing to it.
  29
  30         Example:
  31
  32                 [printer$]
  33                   path=/usr/local/samba/printer
  34                   public=yes
  35                   writable=no
  36                   browseable=yes
  37
  38         Second, you have to build the list of drivers required for a specific
  39         printer. This is the most complicated thing to do. Get the files
  40         'msprint.inf' and 'msprint2.inf' from Windows 95, the easiest way is to
  41         grab them from a working Windows 95 computer. They are usually located
  42         in 'c:\windows\inf'. Look in them for the printer you have. Run the new
  43         program 'make_printerdef' with the file name and the printer name as
  44         parameters. If you have drivers for an unsupported or updated printer,
  45         first install these drivers on an Windows 95 system. There will be a
  46         file created in your inf directory named 'oem?.inf' (where the ? is some
  47         number). Use this file instead of msprint.inf.
  48
  49         Example: (from the /usr/local/samba/lib directory)
  50
  51         make_printerdef msprint.inf "Apple LaserWriter" >> printers.def
  52
  53         The program will print out a list of required files to stderr.
  54         Copy all the files listed into the directory you created in step 1.
  55         If you have "preserve case = yes" make sure your files names match
  56         EXACTLY the names listed.
  57
  58         Third, you need to add 2 new parameters in smb.conf. One is in the
  59         [global] section, called 'printer driver file' pointing to the printer
  60         description file you just created, and the other in each printer share,
  61         called 'printer driver location' pointing to where the client will get
  62         the drivers. Don't forget to set correctly the printer driver parameter
  63         to the Windows printer name.
  64
  65         Example:
  66
  67                 [global]
  68                   printer driver file=/usr/local/samba/lib/printers.def
  69
  70                 [lp]
  71                    comment = My old printer laser
  72                    browseable = yes
  73                    printable = yes
  74                    public = yes
  75                    writable = no
  76                    create mode = 0700
  77                    printer driver=Apple LaserWriter
  78                    printer driver location=\\%h\PRINTER$
  79
  80         %h will expand to the computer name, and PRINTER$ is the name of the
  81         share created in step one.
  82
  83
  84 If it doesn't work for you, don't send flame ! It worked for me. In case of
  85 trouble don't hesitate to send me a mail with your smb.conf file and
  86 printers.def
  87
  88
  89 *******  added by herb@sgi.com
  90
  91 For those of you who like to know the details, and in case I have guessed
  92 wrong on some of the fields - The following is the format of the entries
  93 in the printers.def file: (entries are 1 single line - they are split here
  94 for readability)
  95
  96 <Long Printer Name>:<Driver File Name>:<Data File Name>:<Help File Name>:
  97 <Language Monitor Name>:<Default Data Type>:<Comma Separated list of Files>
  98
  99 The <Help File Name> and the <Language Monitor Name> can be empty.
 100 If no <Driver File Name> or <Data File Name> are specified in the inf file,
 101 these will default to the section name for the printer.
 102
 103 The following is an excerpt from the MSPRINT2.INF file on a WIN95 machine.
 104 I have deleted all but the entries relating to installing a driver for the
 105 "QMS ColorScript 100 Model 30" printer. Using this "file" I'll try to
 106 explain how the printers.def file is created.
 107
 108 make_printerdef is run with the first argument being the name of this
 109 file (MSPRINT2.INF in this case) and the second argument being the
 110 name of the printer ("QMS ColorScript 100 Model 30" in this case).
 111
 112 The printer name is first found in the "Model section" to obtain the
 113 name of the "Installer Section" (this is the name after the equal sign).
 114 We ignore the alternate name.
 115
 116 The "Installer Section" contains entries for "CopyFiles" and "DataSection".
 117 The "CopyFiles" line gives a list of all the required files for this
 118 printer. If the name begins with an @ it is the name of a file (after
 119 you strip off the @), otherwise it is the name of a "Copy Section" which
 120 in turn is a list of files required. This printer has one file listed
 121 "QCS30503.SPD" and two sections "COLOR_QMS_100_30" and "PSCRIPT". The
 122 "COLOR_QMS_100_30" section is listed in the "[DestinationDirs]" as
 123 having a value of 23. This means that all files listed in this section
 124 should go into the "color" subdirectory. The list of files to copy for
 125 this printer is thus:
 126
 127 QCS30503.SPD,color\QMS10030.ICM,PSCRIPT.DRV,PSCRIPT.HLP,PSCRIPT.INI,
 128 TESTPS.TXT,APPLE380.SPD,FONTS.MFM,ICONLIB.DLL,PSMON.DLL
 129
 130 From the "Data Section" we obtain values for "DriverFile", "HelpFile",
 131 and "LanguageMonitor". The % around the value for "LanguageMonitor"
 132 indicates that it is a string that can be localized so its actual value
 133 is obtained from the "[Strings]" section. The "Data Section" could also
 134 have contained an entry for "DefaultDataType".
 135
 136 Using the information we have obtained we can now construct the entry
 137 for the printers.def file.
 138
 139 <Long Printer Name>     -> QMS ColorScript 100 Model 30  (name given
 140                                 on the command line)
 141 <Driver File Name>      -> PSCRIPT.DRV  (given in Data Section)
 142 <Data File Name>        -> QCS30503.SPD (defaults to Install Section name)
 143 <Help File Name>        -> PSCRIPT.HLP  (given in Data Section)
 144 <Language Monitor Name> -> PostScript Language Monitor  (given in Data Section)
 145 <Default Data Type>     -> RAW (default if not specified)
 146
 147
 148 So.... the enty (actually one line but split here for readability) would
 149 be:
 150
 151 QMS ColorScript 100 Model 30:PSCRIPT.DRV:QCS30503.SPD:
 152 PSCRIPT.HLP:PostScript Language Monitor:RAW:
 153 QCS30503.SPD,color\QMS10030.ICM,PSCRIPT.DRV,PSCRIPT.HLP,PSCRIPT.INI,
 154 TESTPS.TXT,APPLE380.SPD,FONTS.MFM,ICONLIB.DLL,PSMON.DLL
 155
 156 ---------------------- Info from MSPRINT2.INF ------------------------
 157 ;
 158 ; The Manufacturer section lists all of the manufacturers that we will
 159 ; display in the Dialog box
 160
 161 [Manufacturer]
 162 "QMS"
 163
 164
 165 ;
 166 ; Model sections. Each section here corresponds with an entry listed in the
 167 ; [Manufacturer] section, above. The models will be displayed in the order
 168 ; that they appear in the INF file.
 169 ;
 170 ; Each model lists a variation of its own name as a compatible ID. This
 171 ; is done primarily as an optimization during upgrade.
 172 ;
 173 [QMS]
 174 "QMS ColorScript 100 Model 30"    = QCS30503.SPD,QMS_ColorScript_100_Model_30
 175
 176
 177 ;
 178 ; Installer Sections
 179 ;
 180 ; These sections control file installation, and reference all files that
 181 ; need to be copied. The section name will be assumed to be the driver
 182 ; file, unless there is an explicit DriverFile section listed.
 183 ;
 184 [QCS30503.SPD]
 185 CopyFiles=@QCS30503.SPD,COLOR_QMS_100_30,PSCRIPT
 186 DataSection=PSCRIPT_DATA
 187
 188 ; Copy Sections
 189 ;
 190 ; Lists of files that are actually copied. These sections are referenced
 191 ; from the installer sections, above. Only create a section if it contains
 192 ; two or more files (if we only copy a single file, identify it in the
 193 ; installer section, using the @filename notation) or if it's a color
 194 ; profile (since the DestinationDirs can only handle sections, and not
 195 ; individual files).
 196 ;
 197 [COLOR_QMS_100_30]
 198 QMS10030.ICM
 199
 200 [PSCRIPT]
 201 PSCRIPT.DRV
 202 PSCRIPT.HLP
 203 PSCRIPT.INI
 204 TESTPS.TXT
 205 APPLE380.SPD
 206 FONTS.MFM
 207 ICONLIB.DLL
 208 PSMON.DLL
 209
 210
 211 ;
 212 ; Data Sections
 213 ;
 214 ; These sections contain data that is shared between devices.
 215 ;
 216 [PSCRIPT_DATA]
 217 DriverFile=PSCRIPT.DRV
 218 HelpFile=PSCRIPT.HLP
 219 LanguageMonitor=%PS_MONITOR%
 220
 221
 222 ;
 223 ; Color profiles go to the colors directory. All other files go to the
 224 ; system directory
 225 ;
 226
 227 [DestinationDirs]
 228 DefaultDestDir=11
 229 COLOR_QMS_100_30=23
 230 COLOR_TEKTRONIX_200I=23
 231 COLOR_TEKTRONIX_III_PXI=23
 232
 233
 234 ;
 235 ; Localizable Strings
 236 ;
 237 [Strings]
 238 MS="Microsoft"
 239 PS_MONITOR="PostScript Language Monitor,PSMON.DLL"
 240