| 1 | <samba:parameter name="interfaces"
|
|---|
| 2 | context="G"
|
|---|
| 3 | type="cmdlist"
|
|---|
| 4 | xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
|
|---|
| 5 | <description>
|
|---|
| 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 NetBIOS over TCP/IP (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 "eth"</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 "mask" 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 "IP" 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>
|
|---|
| 38 | By default Samba enables all active interfaces that are broadcast capable
|
|---|
| 39 | except the loopback adaptor (IP address 127.0.0.1).
|
|---|
| 40 | </para>
|
|---|
| 41 |
|
|---|
| 42 | <para>
|
|---|
| 43 | In order to support SMB3 multi-channel configurations, smbd understands
|
|---|
| 44 | some extra data that can be appended after the actual interface with
|
|---|
| 45 | this extended syntax:
|
|---|
| 46 | </para>
|
|---|
| 47 |
|
|---|
| 48 | <para>
|
|---|
| 49 | interface[;key1=value1[,key2=value2[...]]]
|
|---|
| 50 | </para>
|
|---|
| 51 |
|
|---|
| 52 | <para>
|
|---|
| 53 | Known keys are speed, capability, and if_index. Speed is specified in
|
|---|
| 54 | bits per second. Known capabilities are RSS and RDMA. The
|
|---|
| 55 | if_index should be used with care: the values must not coincide with
|
|---|
| 56 | indexes used by the kernel.
|
|---|
| 57 | Note that these options are mainly intended for testing and
|
|---|
| 58 | development rather than for production use. At least on Linux systems,
|
|---|
| 59 | these values should be auto-detected, but the settings can serve
|
|---|
| 60 | as last a resort when autodetection is not working or is not available.
|
|---|
| 61 | </para>
|
|---|
| 62 |
|
|---|
| 63 | <para>
|
|---|
| 64 | The example below configures three network interfaces corresponding
|
|---|
| 65 | to the eth0 device and IP addresses 192.168.2.10 and 192.168.3.10.
|
|---|
| 66 | The netmasks of the latter two interfaces would be set to 255.255.255.0.
|
|---|
| 67 | </para>
|
|---|
| 68 |
|
|---|
| 69 | </description>
|
|---|
| 70 | <related>bind interfaces only</related>
|
|---|
| 71 |
|
|---|
| 72 | <value type="example">eth0 192.168.2.10/24 192.168.3.10/255.255.255.0</value>
|
|---|
| 73 |
|
|---|
| 74 | <value type="default"/>
|
|---|
| 75 | </samba:parameter>
|
|---|
