From: Vinit Agnihotri Date: Tue, 5 Mar 2024 11:16:49 +0000 (-0800) Subject: param: Add additional key 'options' for interfaces X-Git-Url: http://git.samba.org/samba.git/?a=commitdiff_plain;h=9fcb62cf22d237fb61d1297e9e53418ce73105a3;p=vlendec%2Fsamba-autobuild%2F.git param: Add additional key 'options' for interfaces The key 'options' specifies if server should spawn/kill listning sockets in event of add/dropped ip addresses on specified interface. Signed-off-by: Vinit Agnihotri Reviewed-by: Martin Schwenke Reviewed-by: Andrew Bartlett --- diff --git a/docs-xml/smbdotconf/base/interfaces.xml b/docs-xml/smbdotconf/base/interfaces.xml index cbc29712385..b41327c7550 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"