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