docs-xml/smbdotconf/browse/preferredmaster.xml

   1 <samba:parameter name="preferred master"
   2                  context="G"
   3                  type="enum"
   4                  enumlist="enum_bool_auto"
   5                  function="_preferred_master"
   6                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   7 <synonym>prefered master</synonym>
   8  <description>
   9         <para>
  10         This boolean parameter controls if <citerefentry><refentrytitle>nmbd</refentrytitle>
  11         <manvolnum>8</manvolnum></citerefentry> is a preferred master browser  for its workgroup.
  12         </para>
  13
  14         <para>
  15         If this is set to <constant>yes</constant>, on startup, <command moreinfo="none">nmbd</command> will force
  16         an election, and it will have a slight advantage in winning the election.  It is recommended that this
  17         parameter is used in conjunction with <smbconfoption name="domain master">yes</smbconfoption>, so that
  18         <command moreinfo="none">nmbd</command> can guarantee becoming a domain master.
  19         </para>
  20
  21         <para>
  22         Use this option with caution, because if there are several hosts (whether Samba servers, Windows 95 or NT)
  23         that are preferred  master browsers on the same subnet, they will each periodically  and continuously attempt
  24         to become the local master browser. This will result in unnecessary broadcast traffic and reduced browsing
  25         capabilities.
  26         </para>
  27 </description>
  28 <related>os level</related>
  29 <value type="default">auto</value>
  30 </samba:parameter>