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>