<samba:parameter name="domain master"
context="G"
basic="1" advanced="1" developer="1"
xmlns:samba="http://samba.org/common">
<listitem>
<para>Tell <citerefentry><refentrytitle>smbd</refentrytitle>
<manvolnum>8</manvolnum></citerefentry> to enable WAN-wide browse list
collation. Setting this option causes <command moreinfo="none">nmbd</command> to
claim a special domain specific NetBIOS name that identifies
it as a domain master browser for its given <link linkend="WORKGROUP">
<parameter moreinfo="none">workgroup</parameter></link>. Local master browsers
in the same <parameter moreinfo="none">workgroup</parameter> on broadcast-isolated
subnets will give this <command moreinfo="none">nmbd</command> their local browse lists,
and then ask <citerefentry><refentrytitle>smbd</refentrytitle>
<manvolnum>8</manvolnum></citerefentry> for a complete copy of the browse
list for the whole wide area network. Browser clients will then contact
their local master browser, and will receive the domain-wide browse list,
instead of just the list for their broadcast-isolated subnet.</para>
<para>Note that Windows NT Primary Domain Controllers expect to be
able to claim this <parameter moreinfo="none">workgroup</parameter> specific special
NetBIOS name that identifies them as domain master browsers for
that <parameter moreinfo="none">workgroup</parameter> by default (i.e. there is no
way to prevent a Windows NT PDC from attempting to do this). This
means that if this parameter is set and <command moreinfo="none">nmbd</command> claims
the special name for a <parameter moreinfo="none">workgroup</parameter> before a Windows
NT PDC is able to do so then cross subnet browsing will behave
strangely and may fail.</para>
<para>If <link linkend="DOMAINLOGONS"><command moreinfo="none">domain logons = yes</command>
</link>, then the default behavior is to enable the <parameter moreinfo="none">domain
master</parameter> parameter. If <parameter moreinfo="none">domain logons</parameter> is
not enabled (the default setting), then neither will <parameter moreinfo="none">domain
master</parameter> be enabled by default.</para>
<para>Default: <command moreinfo="none">domain master = auto</command></para>
</listitem>
</samba:parameter>