docs/docbook/smbdotconf/browse/domainmaster.xml

   1 <samba:parameter xmlns:samba="http://samba.org/common">
   2                 <term><anchor id="DOMAINMASTER"/>domain master (G)</term>
   3                 <listitem><para>Tell <citerefentry><refentrytitle>smbd</refentrytitle>
   4                 <manvolnum>8</manvolnum></citerefentry> to enable WAN-wide browse list
   5                 collation. Setting this option causes <command moreinfo="none">nmbd</command> to
   6                 claim a special domain specific NetBIOS name that identifies
   7                 it as a domain master browser for its given <link linkend="WORKGROUP">
   8                 <parameter moreinfo="none">workgroup</parameter></link>. Local master browsers
   9                 in the same <parameter moreinfo="none">workgroup</parameter> on broadcast-isolated
  10                 subnets will give this <command moreinfo="none">nmbd</command> their local browse lists,
  11                 and then ask <citerefentry><refentrytitle>smbd</refentrytitle>
  12                 <manvolnum>8</manvolnum></citerefentry> for a complete copy of the browse
  13                 list for the whole wide area network.  Browser clients will then contact
  14                 their local master browser, and will receive the domain-wide browse list,
  15                 instead of just the list for their broadcast-isolated subnet.</para>
  16
  17                 <para>Note that Windows NT Primary Domain Controllers expect to be
  18                 able to claim this <parameter moreinfo="none">workgroup</parameter> specific special
  19                 NetBIOS name that identifies them as domain master browsers for
  20                 that <parameter moreinfo="none">workgroup</parameter> by default (i.e. there is no
  21                 way to prevent a Windows NT PDC from attempting to do this). This
  22                 means that if this parameter is set and <command moreinfo="none">nmbd</command> claims
  23                 the special name for a <parameter moreinfo="none">workgroup</parameter> before a Windows
  24                 NT PDC is able to do so then cross subnet browsing will behave
  25                 strangely and may fail.</para>
  26
  27                 <para>If <link linkend="DOMAINLOGONS"><command moreinfo="none">domain logons = yes</command>
  28                 </link>, then the default behavior is to enable the <parameter moreinfo="none">domain
  29                 master</parameter> parameter.  If <parameter moreinfo="none">domain logons</parameter> is
  30                 not enabled (the default setting), then neither will <parameter moreinfo="none">domain
  31                 master</parameter> be enabled by default.</para>
  32
  33                 <para>Default: <command moreinfo="none">domain master = auto</command></para></listitem>
  34                 </samba:parameter>