syncing docs from 3.0 tree (thanks jelmer).
[Samba.git] / docs / docbook / smbdotconf / misc / remoteannounce.xml
blobd03ea8b0e254651376b12649f897311b3bfef0fa
1 <samba:parameter name="remote announce"
2                  context="G"
3                  advanced="1" developer="1"
4                  xmlns:samba="http://samba.org/common">
5 <listitem>
6         <para>This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
7         <manvolnum>8</manvolnum></citerefentry>to periodically announce itself 
8         to arbitrary IP addresses with an arbitrary workgroup name.</para>
10         <para>This is useful if you want your Samba server to appear 
11         in a remote workgroup for which the normal browse propagation 
12         rules don't work. The remote workgroup can be anywhere that you 
13         can send IP packets to.</para>
15         <para>For example:</para>
17         <para><command moreinfo="none">remote announce = 192.168.2.255/SERVERS 
18         192.168.4.255/STAFF</command></para>
20         <para>the above line would cause <command moreinfo="none">nmbd</command> to announce itself 
21         to the two given IP addresses using the given workgroup names. 
22         If you leave out the workgroup name then the one given in 
23         the <link linkend="WORKGROUP"><parameter moreinfo="none">workgroup</parameter></link> 
24         parameter is used instead.</para>
26         <para>The IP addresses you choose would normally be the broadcast 
27         addresses of the remote networks, but can also be the IP addresses 
28         of known browse masters if your network config is that stable.</para>
30         <para>See <link linkend="NetworkBrowsing"/>.</para>
31                 
32         <para>Default: <command moreinfo="none">remote announce = &lt;empty string&gt;</command></para>
33 </listitem>
34 </samba:parameter>