diff --git a/docs-xml/smbdotconf/base/interfaces.xml b/docs-xml/smbdotconf/base/interfaces.xml
index cbc297123853..b41327c75508 100644
--- a/docs-xml/smbdotconf/base/interfaces.xml
+++ b/docs-xml/smbdotconf/base/interfaces.xml
@@ -51,8 +51,8 @@
- 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
@@ -62,6 +62,24 @@
The specified values overwrite the auto-detected values.
+
+ The possible values for options are
+ "dynamic" and "nodynamic".
+ Use this option in combination with setting
+
+ 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).
+
+
+
+ Note that dynamically opening/closing listening sockets is only available on some
+ operating systems (currently Linux).
+
+
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.
@@ -82,6 +100,7 @@
"lo;speed=1000000000" "eth0;capability=RSS"
"lo;speed=1000000000" , "eth0;capability=RSS"
"eth0;capability=RSS" , "rdma1;capability=RDMA" ; "rdma2;capability=RSS,capability=RDMA"
+"eth0;options=dynamic"