docs-xml/smbdotconf/printing/forceprintername.xml

   1 <samba:parameter name="force printername"
   2                  context="S"
   3                  type="boolean"
   4                  print="1"
   5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   6 <description>
   7     <para>When printing from Windows NT (or later),
   8     each printer in <filename>smb.conf</filename> has two
   9     associated names which can be used by the client.  The first
  10     is the sharename (or shortname) defined in smb.conf.  This
  11     is the only printername available for use by Windows 9x clients.
  12     The second name associated with a printer can be seen when
  13     browsing to the "Printers" (or "Printers and Faxes") folder
  14     on the Samba server.  This is referred to simply as the printername
  15     (not to be confused with the <parameter>printer name</parameter> option).
  16     </para>
  17
  18     <para>When assigning a new driver to a printer on a remote
  19     Windows compatible print server such as Samba, the Windows client
  20     will rename the printer to match the driver name just uploaded.
  21     This can result in confusion for users when multiple
  22     printers are bound to the same driver.  To prevent Samba from
  23     allowing the printer's printername to differ from the sharename
  24     defined in smb.conf, set <parameter>force printername = yes</parameter>.
  25     </para>
  26
  27     <para>Be aware that enabling this parameter may affect migrating
  28     printers from a Windows server to Samba since Windows has no way to
  29     force the sharename and printername to match.</para>
  30
  31     <para>It is recommended that this parameter's value not be changed
  32     once the printer is in use by clients as this could cause a user
  33     not be able to delete printer connections from their local Printers
  34     folder.</para>
  35
  36 </description>
  37
  38 <value type="default">no</value>
  39 </samba:parameter>