summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/misc/remoteannounce.xml
blob: 019cc306a7bb611903cacbf3acf32128d05578cf (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
<samba:parameter name="remote announce"
	         context="G"
		 advanced="1" developer="1"
		 xmlns:samba="http://samba.org/common">
<listitem>
	<para>This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
	<manvolnum>8</manvolnum></citerefentry>to periodically announce itself 
	to arbitrary IP addresses with an arbitrary workgroup name.</para>

	<para>This is useful if you want your Samba server 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:</para>

	<para><command moreinfo="none">remote announce = 192.168.2.255/SERVERS 
	192.168.4.255/STAFF</command></para>

	<para>the above line would cause <command moreinfo="none">nmbd</command> to announce itself 
	to the two given IP addresses using the given workgroup names. 
	If you leave out the workgroup name then the one given in 
	the <link linkend="WORKGROUP"><parameter moreinfo="none">workgroup</parameter></link> 
	parameter is used instead.</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.</para>

	<para>See the documentation file <ulink url="improved-browsing.html">BROWSING</ulink> 
	in the <filename moreinfo="none">docs/</filename> directory.</para>
		
	<para>Default: <command moreinfo="none">remote announce = &lt;empty string&gt;</command></para>
</listitem>
</samba:parameter>