docs:smbdotconf: make formatting of headers uniform.
[Samba.git] / docs-xml / smbdotconf / misc / remotebrowsesync.xml
blob91a8c8f8829af11373a13056022a608a8b935655
1 <samba:parameter name="remote browse sync"
2                  context="G"
3                  type="string"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6         <para>
7         This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
8         <manvolnum>8</manvolnum></citerefentry> to periodically request 
9         synchronization of browse lists with the master browser of a Samba 
10         server that is on a remote segment. This option will allow you to 
11         gain browse lists for multiple workgroups across routed networks. This 
12         is done in a manner that does not work with any non-Samba servers.
13         </para>
15         <para>
16         This is useful if you want your Samba server and all local 
17         clients to appear in a remote workgroup for which the normal browse 
18         propagation rules don't work. The remote workgroup can be anywhere 
19         that you can send IP packets to.
20         </para>
22         <para>
23         For example:
24 <programlisting>
25 <parameter>remote browse sync = 192.168.2.255 192.168.4.255</parameter>
26 </programlisting>
27         the above line would cause <command>nmbd</command> to request the master browser on the 
28         specified subnets or addresses to synchronize their browse lists with 
29         the local server.
30         </para>
32         <para>
33         The IP addresses you choose would normally be the broadcast 
34         addresses of the remote networks, but can also be the IP addresses 
35         of known browse masters if your network config is that stable. If 
36         a machine IP address is given Samba makes NO attempt to validate 
37         that the remote machine is available, is listening, nor that it 
38         is in fact the browse master on its segment.
39         </para>
41         <para>
42         The <smbconfoption name="remote browse sync"/> may be used on networks
43         where there is no WINS server, and may be used on disjoint networks where
44         each network has its own WINS server.
45         </para>
46 </description>
48 <value type="default"></value>
49 </samba:parameter>