summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/browse/domainmaster.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docbook/smbdotconf/browse/domainmaster.xml')
-rw-r--r--docs/docbook/smbdotconf/browse/domainmaster.xml66
1 files changed, 35 insertions, 31 deletions
diff --git a/docs/docbook/smbdotconf/browse/domainmaster.xml b/docs/docbook/smbdotconf/browse/domainmaster.xml
index cf2d504e4d..7bd334bbb5 100644
--- a/docs/docbook/smbdotconf/browse/domainmaster.xml
+++ b/docs/docbook/smbdotconf/browse/domainmaster.xml
@@ -1,34 +1,38 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="DOMAINMASTER"/>domain master (G)</term>
- <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>
+<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>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>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>
+ <para>Default: <command moreinfo="none">domain master = auto</command></para>
+</listitem>
+</samba:parameter>