docs-xml/smbdotconf/printing/forceprintername.xml

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