summaryrefslogtreecommitdiff
path: root/docs/docbook
diff options
context:
space:
mode:
authorAlexander Bokovoy <ab@samba.org>2003-04-11 14:26:21 +0000
committerAlexander Bokovoy <ab@samba.org>2003-04-11 14:26:21 +0000
commit274b7650447f3580ba78e36a87f1cd88718c2032 (patch)
tree7536074cad0a6aa5e19b91a3691cf04a1671e537 /docs/docbook
parent36814e19a411fdac926267341a86cfff5c79bc69 (diff)
downloadsamba-274b7650447f3580ba78e36a87f1cd88718c2032.tar.gz
samba-274b7650447f3580ba78e36a87f1cd88718c2032.tar.bz2
samba-274b7650447f3580ba78e36a87f1cd88718c2032.zip
Finish conversion of Browse options
(This used to be commit e59bd1d9fba71e7b8841a6d995f7bb9e156a15cc)
Diffstat (limited to 'docs/docbook')
-rw-r--r--docs/docbook/smbdotconf/browse/browsable.xml14
-rw-r--r--docs/docbook/smbdotconf/browse/browseable.xml17
-rw-r--r--docs/docbook/smbdotconf/browse/browselist.xml22
-rw-r--r--docs/docbook/smbdotconf/browse/domainmaster.xml66
-rw-r--r--docs/docbook/smbdotconf/browse/enhancedbrowsing.xml43
-rw-r--r--docs/docbook/smbdotconf/browse/lmannounce.xml47
-rw-r--r--docs/docbook/smbdotconf/browse/lminterval.xml33
-rw-r--r--docs/docbook/smbdotconf/browse/localmaster.xml36
-rw-r--r--docs/docbook/smbdotconf/browse/oslevel.xml42
-rw-r--r--docs/docbook/smbdotconf/browse/preferedmaster.xml15
-rw-r--r--docs/docbook/smbdotconf/browse/preferredmaster.xml46
11 files changed, 210 insertions, 171 deletions
diff --git a/docs/docbook/smbdotconf/browse/browsable.xml b/docs/docbook/smbdotconf/browse/browsable.xml
index 779571cff2..bd35732927 100644
--- a/docs/docbook/smbdotconf/browse/browsable.xml
+++ b/docs/docbook/smbdotconf/browse/browsable.xml
@@ -1,5 +1,9 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="BROWSABLE"/>browsable (S)</term>
- <listitem><para>See the <link linkend="BROWSEABLE"><parameter moreinfo="none">
- browseable</parameter></link>.</para></listitem>
- </samba:parameter>
+<samba:parameter name="browsable"
+ context="S"
+ hide="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>See the <link linkend="BROWSEABLE">
+ <parameter moreinfo="none">browseable</parameter></link>.</para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/browse/browseable.xml b/docs/docbook/smbdotconf/browse/browseable.xml
index c223d6c7d7..5da61cccfb 100644
--- a/docs/docbook/smbdotconf/browse/browseable.xml
+++ b/docs/docbook/smbdotconf/browse/browseable.xml
@@ -1,8 +1,11 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="BROWSEABLE"/>browseable (S)</term>
- <listitem><para>This controls whether this share is seen in
- the list of available shares in a net view and in the browse list.</para>
+<samba:parameter name="browseable"
+ context="S"
+ basic="1" advanced="1" print="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This controls whether this share is seen in
+ the list of available shares in a net view and in the browse list.</para>
- <para>Default: <command moreinfo="none">browseable = yes</command></para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">browseable = yes</command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/browse/browselist.xml b/docs/docbook/smbdotconf/browse/browselist.xml
index f15e2caf2a..17a962a3f5 100644
--- a/docs/docbook/smbdotconf/browse/browselist.xml
+++ b/docs/docbook/smbdotconf/browse/browselist.xml
@@ -1,10 +1,14 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="BROWSELIST"/>browse list (G)</term>
- <listitem><para>This controls whether <citerefentry><refentrytitle>smbd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> will serve a browse list to
- a client doing a <command moreinfo="none">NetServerEnum</command> call. Normally
- set to <constant>yes</constant>. You should never need to change
- this.</para>
+<samba:parameter name="browse list"
+ context="G"
+ advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This controls whether <citerefentry><refentrytitle>smbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> will serve a browse list to
+ a client doing a <command moreinfo="none">NetServerEnum</command> call. Normally
+ set to <constant>yes</constant>. You should never need to change
+ this.</para>
- <para>Default: <command moreinfo="none">browse list = yes</command></para></listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">browse list = yes</command></para>
+</listitem>
+</samba:parameter>
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>
diff --git a/docs/docbook/smbdotconf/browse/enhancedbrowsing.xml b/docs/docbook/smbdotconf/browse/enhancedbrowsing.xml
index cf8d3e54b9..8fb3be1603 100644
--- a/docs/docbook/smbdotconf/browse/enhancedbrowsing.xml
+++ b/docs/docbook/smbdotconf/browse/enhancedbrowsing.xml
@@ -1,24 +1,27 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="ENHANCEDBROWSING"/>enhanced browsing (G)</term>
- <listitem><para>This option enables a couple of enhancements to
- cross-subnet browse propagation that have been added in Samba
- but which are not standard in Microsoft implementations.
- </para>
+<samba:parameter name="enhanced browsing"
+ context="G"
+ advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This option enables a couple of enhancements to
+ cross-subnet browse propagation that have been added in Samba
+ but which are not standard in Microsoft implementations.
+ </para>
- <para>The first enhancement to browse propagation consists of a regular
- wildcard query to a Samba WINS server for all Domain Master Browsers,
- followed by a browse synchronization with each of the returned
- DMBs. The second enhancement consists of a regular randomised browse
- synchronization with all currently known DMBs.</para>
+ <para>The first enhancement to browse propagation consists of a regular
+ wildcard query to a Samba WINS server for all Domain Master Browsers,
+ followed by a browse synchronization with each of the returned
+ DMBs. The second enhancement consists of a regular randomised browse
+ synchronization with all currently known DMBs.</para>
- <para>You may wish to disable this option if you have a problem with empty
- workgroups not disappearing from browse lists. Due to the restrictions
- of the browse protocols these enhancements can cause a empty workgroup
- to stay around forever which can be annoying.</para>
+ <para>You may wish to disable this option if you have a problem with empty
+ workgroups not disappearing from browse lists. Due to the restrictions
+ of the browse protocols these enhancements can cause a empty workgroup
+ to stay around forever which can be annoying.</para>
- <para>In general you should leave this option enabled as it makes
- cross-subnet browse propagation much more reliable.</para>
+ <para>In general you should leave this option enabled as it makes
+ cross-subnet browse propagation much more reliable.</para>
- <para>Default: <command moreinfo="none">enhanced browsing = yes</command></para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">enhanced browsing = yes</command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/browse/lmannounce.xml b/docs/docbook/smbdotconf/browse/lmannounce.xml
index 1551c0991e..b18234443a 100644
--- a/docs/docbook/smbdotconf/browse/lmannounce.xml
+++ b/docs/docbook/smbdotconf/browse/lmannounce.xml
@@ -1,24 +1,27 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="LMANNOUNCE"/>lm announce (G)</term>
- <listitem><para>This parameter determines if <citerefentry><refentrytitle>nmbd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> will produce Lanman announce
- broadcasts that are needed by OS/2 clients in order for them to see
- the Samba server in their browse list. This parameter can have three
- values, <constant>yes</constant>, <constant>no</constant>, or
- <constant>auto</constant>. The default is <constant>auto</constant>.
- If set to <constant>no</constant> Samba will never produce these
- broadcasts. If set to <constant>yes</constant> Samba will produce
- Lanman announce broadcasts at a frequency set by the parameter
- <parameter moreinfo="none">lm interval</parameter>. If set to <constant>auto</constant>
- Samba will not send Lanman announce broadcasts by default but will
- listen for them. If it hears such a broadcast on the wire it will
- then start sending them at a frequency set by the parameter
- <parameter moreinfo="none">lm interval</parameter>.</para>
+<samba:parameter name="lm announce"
+ context="G"
+ advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This parameter determines if <citerefentry><refentrytitle>nmbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> will produce Lanman announce
+ broadcasts that are needed by OS/2 clients in order for them to see
+ the Samba server in their browse list. This parameter can have three
+ values, <constant>yes</constant>, <constant>no</constant>, or
+ <constant>auto</constant>. The default is <constant>auto</constant>.
+ If set to <constant>no</constant> Samba will never produce these
+ broadcasts. If set to <constant>yes</constant> Samba will produce
+ Lanman announce broadcasts at a frequency set by the parameter
+ <parameter moreinfo="none">lm interval</parameter>. If set to <constant>auto</constant>
+ Samba will not send Lanman announce broadcasts by default but will
+ listen for them. If it hears such a broadcast on the wire it will
+ then start sending them at a frequency set by the parameter
+ <parameter moreinfo="none">lm interval</parameter>.</para>
- <para>See also <link linkend="LMINTERVAL"><parameter moreinfo="none">lm interval
- </parameter></link>.</para>
+ <para>See also <link linkend="LMINTERVAL"><parameter moreinfo="none">lm interval</parameter></link>.</para>
- <para>Default: <command moreinfo="none">lm announce = auto</command></para>
- <para>Example: <command moreinfo="none">lm announce = yes</command></para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">lm announce = auto</command></para>
+
+ <para>Example: <command moreinfo="none">lm announce = yes</command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/browse/lminterval.xml b/docs/docbook/smbdotconf/browse/lminterval.xml
index cc17dc15b0..58e4cc30ba 100644
--- a/docs/docbook/smbdotconf/browse/lminterval.xml
+++ b/docs/docbook/smbdotconf/browse/lminterval.xml
@@ -1,17 +1,20 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="LMINTERVAL"/>lm interval (G)</term>
- <listitem><para>If Samba is set to produce Lanman announce
- broadcasts needed by OS/2 clients (see the <link linkend="LMANNOUNCE">
- <parameter moreinfo="none">lm announce</parameter></link> parameter) then this
- parameter defines the frequency in seconds with which they will be
- made. If this is set to zero then no Lanman announcements will be
- made despite the setting of the <parameter moreinfo="none">lm announce</parameter>
- parameter.</para>
+<samba:parameter name="lm interval"
+ context="G"
+ advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>If Samba is set to produce Lanman announce
+ broadcasts needed by OS/2 clients (see the <link linkend="LMANNOUNCE">
+ <parameter moreinfo="none">lm announce</parameter></link> parameter) then this
+ parameter defines the frequency in seconds with which they will be
+ made. If this is set to zero then no Lanman announcements will be
+ made despite the setting of the <parameter moreinfo="none">lm announce</parameter>
+ parameter.</para>
- <para>See also <link linkend="LMANNOUNCE"><parameter moreinfo="none">lm
- announce</parameter></link>.</para>
+ <para>See also <link linkend="LMANNOUNCE"><parameter moreinfo="none">lm announce</parameter></link>.</para>
- <para>Default: <command moreinfo="none">lm interval = 60</command></para>
- <para>Example: <command moreinfo="none">lm interval = 120</command></para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">lm interval = 60</command></para>
+
+ <para>Example: <command moreinfo="none">lm interval = 120</command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/browse/localmaster.xml b/docs/docbook/smbdotconf/browse/localmaster.xml
index dffbd3cb19..ac2626c679 100644
--- a/docs/docbook/smbdotconf/browse/localmaster.xml
+++ b/docs/docbook/smbdotconf/browse/localmaster.xml
@@ -1,18 +1,22 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="LOCALMASTER"/>local master (G)</term>
- <listitem><para>This option allows <citerefentry><refentrytitle>nmbd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> to try and become a local master browser
- on a subnet. If set to <constant>no</constant> then <command moreinfo="none">
- nmbd</command> will not attempt to become a local master browser
- on a subnet and will also lose in all browsing elections. By
- default this value is set to <constant>yes</constant>. Setting this value to <constant>yes</constant> doesn't
- mean that Samba will <emphasis>become</emphasis> the local master
- browser on a subnet, just that <command moreinfo="none">nmbd</command> will <emphasis>
- participate</emphasis> in elections for local master browser.</para>
+<samba:parameter name="local master"
+ context="G"
+ basic="1" advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This option allows <citerefentry><refentrytitle>nmbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> to try and become a local master browser
+ on a subnet. If set to <constant>no</constant> then <command moreinfo="none">
+ nmbd</command> will not attempt to become a local master browser
+ on a subnet and will also lose in all browsing elections. By
+ default this value is set to <constant>yes</constant>. Setting this value to
+ <constant>yes</constant> doesn't mean that Samba will <emphasis>become</emphasis> the
+ local master browser on a subnet, just that <command moreinfo="none">nmbd</command>
+ will <emphasis>participate</emphasis> in elections for local master browser.</para>
- <para>Setting this value to <constant>no</constant> will cause <command moreinfo="none">nmbd</command>
- <emphasis>never</emphasis> to become a local master browser.</para>
+ <para>Setting this value to <constant>no</constant> will cause <command
+ moreinfo="none">nmbd</command> <emphasis>never</emphasis> to become a local
+ master browser.</para>
- <para>Default: <command moreinfo="none">local master = yes</command></para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">local master = yes</command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/browse/oslevel.xml b/docs/docbook/smbdotconf/browse/oslevel.xml
index 927db32204..560516e3f8 100644
--- a/docs/docbook/smbdotconf/browse/oslevel.xml
+++ b/docs/docbook/smbdotconf/browse/oslevel.xml
@@ -1,21 +1,25 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="OSLEVEL"/>os level (G)</term>
- <listitem><para>This integer value controls what level Samba
- advertises itself as for browse elections. The value of this
- parameter determines whether <citerefentry><refentrytitle>nmbd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry>
- has a chance of becoming a local master browser for the <parameter moreinfo="none">
- WORKGROUP</parameter> in the local broadcast area.</para>
+<samba:parameter name="os level"
+ context="G"
+ basic="1" advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This integer value controls what level Samba
+ advertises itself as for browse elections. The value of this
+ parameter determines whether <citerefentry><refentrytitle>nmbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry>
+ has a chance of becoming a local master browser for the <parameter moreinfo="none">
+ WORKGROUP</parameter> in the local broadcast area.</para>
- <para><emphasis>Note :</emphasis>By default, Samba will win
- a local master browsing election over all Microsoft operating
- systems except a Windows NT 4.0/2000 Domain Controller. This
- means that a misconfigured Samba host can effectively isolate
- a subnet for browsing purposes. See <filename moreinfo="none">BROWSING.txt
- </filename> in the Samba <filename moreinfo="none">docs/</filename> directory
- for details.</para>
+ <para><emphasis>Note :</emphasis>By default, Samba will win
+ a local master browsing election over all Microsoft operating
+ systems except a Windows NT 4.0/2000 Domain Controller. This
+ means that a misconfigured Samba host can effectively isolate
+ a subnet for browsing purposes. See <filename moreinfo="none">BROWSING.txt
+ </filename> in the Samba <filename moreinfo="none">docs/</filename> directory
+ for details.</para>
- <para>Default: <command moreinfo="none">os level = 20</command></para>
- <para>Example: <command moreinfo="none">os level = 65 </command></para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">os level = 20</command></para>
+
+ <para>Example: <command moreinfo="none">os level = 65 </command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/browse/preferedmaster.xml b/docs/docbook/smbdotconf/browse/preferedmaster.xml
index 8098626c51..2e8cd938ea 100644
--- a/docs/docbook/smbdotconf/browse/preferedmaster.xml
+++ b/docs/docbook/smbdotconf/browse/preferedmaster.xml
@@ -1,6 +1,9 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="PREFEREDMASTER"/>prefered master (G)</term>
- <listitem><para>Synonym for <link linkend="PREFERREDMASTER"><parameter moreinfo="none">
- preferred master</parameter></link> for people who cannot spell :-).</para>
- </listitem>
- </samba:parameter>
+<samba:parameter name="prefered master"
+ context="G"
+ hide="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>Synonym for <link linkend="PREFERREDMASTER"><parameter moreinfo="none">
+ preferred master</parameter></link> for people who cannot spell :-).</para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/browse/preferredmaster.xml b/docs/docbook/smbdotconf/browse/preferredmaster.xml
index 53934fdb78..31c966b4ac 100644
--- a/docs/docbook/smbdotconf/browse/preferredmaster.xml
+++ b/docs/docbook/smbdotconf/browse/preferredmaster.xml
@@ -1,25 +1,29 @@
-<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>
+<samba:parameter name="preferred master"
+ context="G"
+ basic="1" advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This boolean parameter controls if
+ <citerefentry><refentrytitle>nmbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> 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>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>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>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>
+ <para>Default: <command moreinfo="none">preferred master = auto</command></para>
+</listitem>
+</samba:parameter>