Merge from Subversion r50.
[nivanova/samba-autobuild/.git] / docs / docbook / smbdotconf / browse / preferredmaster.xml
1 <samba:parameter xmlns:samba="http://samba.org/common">
2                 <term><anchor id="PREFERREDMASTER"/>preferred master (G)</term>
3                 <listitem><para>This boolean parameter controls if <ulink url="nmbd.8.html">nmbd(8)</ulink> is a preferred master browser 
4                 for its workgroup.</para>
5
6                 <para>If this is set to <constant>yes</constant>, on startup, <command moreinfo="none">nmbd</command> 
7                 will force an election, and it will have a slight advantage in 
8                 winning the election.  It is recommended that this parameter is 
9                 used in conjunction with <command moreinfo="none"><link linkend="DOMAINMASTER"><parameter moreinfo="none">
10                 domain master</parameter></link> = yes</command>, so that <command moreinfo="none">
11                 nmbd</command> can guarantee becoming a domain master.</para>
12                 
13                 <para>Use this option with caution, because if there are several 
14                 hosts (whether Samba servers, Windows 95 or NT) that are preferred 
15                 master browsers on the same subnet, they will each periodically 
16                 and continuously attempt to become the local master browser.  
17                 This will result in unnecessary broadcast traffic and reduced browsing
18                 capabilities.</para>
19
20                 <para>See also <link linkend="OSLEVEL"><parameter moreinfo="none">os level</parameter>
21                 </link>.</para>
22
23                 <para>Default: <command moreinfo="none">preferred master = auto</command></para>
24                 </listitem>
25                 </samba:parameter>