docs/docbook/smbdotconf/base/interfaces.xml

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