summaryrefslogtreecommitdiff
path: root/docs/smbdotconf/misc/remotebrowsesync.xml
blob: c966c95be076a56539407f884a476d8e5a66f8ce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
<samba:parameter name="remote browse sync"
	         context="G"
		 advanced="1" developer="1"
		 type="list"
		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
	<para>
	This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
	<manvolnum>8</manvolnum></citerefentry> to periodically request 
	synchronization of browse lists with the master browser of a Samba 
	server that is on a remote segment. This option will allow you to 
	gain browse lists for multiple workgroups across routed networks. This 
	is done in a manner that does not work with any non-Samba servers.
	</para>

	<para>
	This is useful if you want your Samba server and all local 
	clients to appear in a remote workgroup for which the normal browse 
	propagation rules don't work. The remote workgroup can be anywhere 
	that you can send IP packets to.
	</para>

	<para>
	For example:
<programlisting>
<parameter>remote browse sync = 192.168.2.255 192.168.4.255</parameter>
</programlisting>
	the above line would cause <command>nmbd</command> to request the master browser on the 
	specified subnets or addresses to synchronize their browse lists with 
	the local server.
	</para>

	<para>
	The IP addresses you choose would normally be the broadcast 
	addresses of the remote networks, but can also be the IP addresses 
	of known browse masters if your network config is that stable. If 
	a machine IP address is given Samba makes NO attempt to validate 
	that the remote machine is available, is listening, nor that it 
	is in fact the browse master on its segment.
	</para>

	<para>
	The <smbconfoption name="remote browse sync"/> may be used on networks
	where there is no WINS server, and may be used on disjoint networks where
	each network has its own WINS server.
	</para>
</description>

<value type="default"></value>
</samba:parameter>