summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/browse/preferredmaster.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docbook/smbdotconf/browse/preferredmaster.xml')
-rw-r--r--docs/docbook/smbdotconf/browse/preferredmaster.xml25
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/docbook/smbdotconf/browse/preferredmaster.xml b/docs/docbook/smbdotconf/browse/preferredmaster.xml
new file mode 100644
index 0000000000..53934fdb78
--- /dev/null
+++ b/docs/docbook/smbdotconf/browse/preferredmaster.xml
@@ -0,0 +1,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>