sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2025-03-11 16:58:40 +03:00
Code

param: Add additional key 'options' for interfaces

Browse Source 
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 <vagnihotri@ddn.com>
Reviewed-by: Martin Schwenke <mschwenke@ddn.com>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
This commit is contained in:
Vinit Agnihotri 2024-03-05 03:16:49 -08:00 committed by Martin Schwenke
parent 916fabe7e8
commit 9fcb62cf22
1 changed files with 21 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
docs-xml/smbdotconf/base/interfaces.xml
View File

@ -51,8 +51,8 @@
</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
@ -62,6 +62,24 @@
The specified values overwrite the auto-detected values.
</para>
<para>
The possible values for options are
&quot;dynamic&quot; and &quot;nodynamic&quot;.
Use this option in combination with setting
<smbconfoption name="bind interfaces only"/>
Use the &quot;dynamic&quot; to have smbd open/close listening sockets on the
interface, when IP addresses are added to or removed from the interface.
Use the &quot;nodynamic&quot; 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.
@ -82,6 +100,7 @@
<value type="example">&quot;lo;speed=1000000000&quot; &quot;eth0;capability=RSS&quot;</value>
<value type="example">&quot;lo;speed=1000000000&quot; , &quot;eth0;capability=RSS&quot;</value>
<value type="example">&quot;eth0;capability=RSS&quot; , &quot;rdma1;capability=RDMA&quot; ; &quot;rdma2;capability=RSS,capability=RDMA&quot;</value>
<value type="example">&quot;eth0;options=dynamic&quot;</value>
<value type="default"/>
</samba:parameter>