Next update of VFS modules development guide
[sfrench/samba-autobuild/.git] / docs / smbdotconf / browse / oslevel.xml
1 <samba:parameter name="os level"
2                  context="G"
3                                  type="integer"
4                  basic="1" advanced="1" developer="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7         <para>
8         This integer value controls what level Samba advertises itself as for browse elections. The value of this
9         parameter determines whether <citerefentry><refentrytitle>nmbd</refentrytitle>
10         <manvolnum>8</manvolnum></citerefentry> has a chance of becoming a local master browser for the <smbconfoption
11         name="workgroup"/> in the local broadcast area.
12 </para>
13                 
14         <para><emphasis>
15         Note:</emphasis> By default, Samba will win a local master browsing election over all Microsoft operating
16         systems except a Windows NT 4.0/2000 Domain Controller. This means that a misconfigured Samba host can
17         effectively isolate a subnet for browsing purposes. This parameter is largely auto-configured in the Samba-3
18         release series and it is seldom necessary to manually override the default setting. Please refer to
19         chapter 9 of the Samba-3 HOWTO document for further information regarding the use of this parameter.
20         <emphasis>Note:</emphasis> The maximum value for this parameter is 255. If you use higher values, counting
21         will start at 0!
22         </para>
23 </description>
24 <value type="default">20</value>
25 <value type="example">65</value>
26 </samba:parameter>