summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/browse/preferredmaster.xml
blob: 53934fdb78022923d9a2f590598098bf8b00199d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<samba:parameter xmlns:samba="http://samba.org/common">
		<term><anchor id="PREFERREDMASTER"/>preferred master (G)</term>
		<listitem><para>This boolean parameter controls if <ulink url="nmbd.8.html">nmbd(8)</ulink> is a preferred master browser 
		for its workgroup.</para>

		<para>If this is set to <constant>yes</constant>, on startup, <command moreinfo="none">nmbd</command> 
		will force an election, and it will have a slight advantage in 
		winning the election.  It is recommended that this parameter is 
		used in conjunction with <command moreinfo="none"><link linkend="DOMAINMASTER"><parameter moreinfo="none">
		domain master</parameter></link> = yes</command>, so that <command moreinfo="none">
		nmbd</command> can guarantee becoming a domain master.</para>
		
		<para>Use this option with caution, because if there are several 
		hosts (whether Samba servers, Windows 95 or NT) that are preferred 
		master browsers on the same subnet, they will each periodically 
		and continuously attempt to become the local master browser.  
		This will result in unnecessary broadcast traffic and reduced browsing
		capabilities.</para>

		<para>See also <link linkend="OSLEVEL"><parameter moreinfo="none">os level</parameter>
		</link>.</para>

		<para>Default: <command moreinfo="none">preferred master = auto</command></para>
		</listitem>
		</samba:parameter>