From 992f1e6b8f86b346fddd266b04d29cde69585633 Mon Sep 17 00:00:00 2001
From: Jelmer Vernooij <jelmer@samba.org>
Date: Wed, 7 Apr 2004 10:15:11 +0000
Subject: Add all the source files from the old CVS tree, add the 5 missing
 chapters from the HOWTO and add jht's Samba by Example book. (This used to be
 commit 9fb5bcb93e57c5162b3ee6f9c7d777dc0269d100)

---
 docs/smbdotconf/browse/domainmaster.xml | 39 +++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 docs/smbdotconf/browse/domainmaster.xml

(limited to 'docs/smbdotconf/browse/domainmaster.xml')

diff --git a/docs/smbdotconf/browse/domainmaster.xml b/docs/smbdotconf/browse/domainmaster.xml
new file mode 100644
index 0000000000..db43220b98
--- /dev/null
+++ b/docs/smbdotconf/browse/domainmaster.xml
@@ -0,0 +1,39 @@
+<samba:parameter name="domain master"
+				 type="boolean"
+                 context="G"
+                 basic="1" advanced="1" developer="1"
+                 xmlns:samba="http://samba.org/common">
+<description>
+	<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>
+
+</description>
+<value type="default">auto</value>
+</samba:parameter>
-- 
cgit