</para>
<para>
- Known keys are speed, capability, and if_index. Speed is specified in
- bits per second. Known capabilities are RSS and RDMA. The
+ Known keys are speed, capability, if_index and options. Speed
+ is specified in bits per second. Known capabilities are RSS and RDMA. The
if_index should be used with care: the values must not coincide with
indexes used by the kernel.
Note that these options are mainly intended for testing and
The specified values overwrite the auto-detected values.
</para>
+ <para>
+ The possible values for options are
+ "dynamic" and "nodynamic".
+ Use this option in combination with setting
+ <smbconfoption name="bind interfaces only"/>
+ Use the "dynamic" to have smbd open/close listening sockets on the
+ interface, when IP addresses are added to or removed from the interface.
+ Use the "nodynamic" option to ignore any ip add/remove events for
+ interface.
+ Please note that when an IP address is removed, connections to that IP address
+ are also terminated (traditional behaviour has been to keep the TCP flow alive).
+ </para>
+
+ <para>
+ Note that dynamically opening/closing listening sockets is only available on some
+ operating systems (currently Linux).
+ </para>
+
<para>
The first two example below configures three network interfaces corresponding
to the eth0 device and IP addresses 192.168.2.10 and 192.168.3.10.
<value type="example">"lo;speed=1000000000" "eth0;capability=RSS"</value>
<value type="example">"lo;speed=1000000000" , "eth0;capability=RSS"</value>
<value type="example">"eth0;capability=RSS" , "rdma1;capability=RDMA" ; "rdma2;capability=RSS,capability=RDMA"</value>
+<value type="example">"eth0;options=dynamic"</value>
<value type="default"/>
</samba:parameter>