This commit was manufactured by cvs2svn to create branch 'SAMBA_3_0'.(This used to...
[samba.git] / docs / docbook / smbdotconf / base / interfaces.xml
1 <samba:parameter name="interfaces"
2                  context="G"
3                  basic="1" advanced="1" wizard="1" developer="1"
4                  xmlns:samba="http://samba.org/common">
5 <listitem>
6         <para>This option allows you to override the default 
7         network interfaces list that Samba will use for browsing, name 
8         registration and other NBT traffic. By default Samba will query 
9         the kernel for the list of all active interfaces and use any 
10         interfaces except 127.0.0.1 that are broadcast capable.</para>
11
12         <para>The option takes a list of interface strings. Each string 
13         can be in any of the following forms:</para>
14
15         <itemizedlist>
16                 <listitem><para>a network interface name (such as eth0). 
17                 This may include shell-like wildcards so eth* will match 
18                 any interface starting with the substring &quot;eth&quot;</para></listitem>
19                         
20                 <listitem><para>an IP address. In this case the netmask is 
21                 determined from the list of interfaces obtained from the 
22                 kernel</para></listitem>
23                         
24                 <listitem><para>an IP/mask pair. </para></listitem>
25                         
26                 <listitem><para>a broadcast/mask pair.</para></listitem>
27         </itemizedlist>
28
29         <para>The &quot;mask&quot; parameters can either be a bit length (such 
30         as 24 for a C class network) or a full netmask in dotted 
31         decimal form.</para>
32
33         <para>The &quot;IP&quot; parameters above can either be a full dotted 
34         decimal IP address or a hostname which will be looked up via 
35         the OS's normal hostname resolution mechanisms.</para>
36
37         <para>For example, the following line:</para>
38                 
39         <para><command moreinfo="none">interfaces = eth0 192.168.2.10/24 192.168.3.10/255.255.255.0</command></para>
40
41         <para>would configure three network interfaces corresponding 
42         to the eth0 device and IP addresses 192.168.2.10 and 192.168.3.10. 
43         The netmasks of the latter two interfaces would be set to 255.255.255.0.</para>
44
45         <para>See also <link linkend="BINDINTERFACESONLY"><parameter moreinfo="none">bind 
46         interfaces only</parameter></link>.</para>
47                 
48         <para>Default: <emphasis>all active interfaces except 127.0.0.1 
49         that are broadcast capable</emphasis></para>
50 </listitem>
51 </samba:parameter>