From: Stefan Metzmacher Date: Thu, 7 May 2020 10:04:00 +0000 (+0200) Subject: docs-xml/smbdotconf: clarify the quoting for advanced "interfaces" options X-Git-Tag: ldb-2.2.0~629 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=afd3bd01eb463081cb85724260a0840cd98b38c2;p=thirdparty%2Fsamba.git docs-xml/smbdotconf: clarify the quoting for advanced "interfaces" options Signed-off-by: Stefan Metzmacher Reviewed-by: Ralph Boehme Autobuild-User(master): Stefan Metzmacher Autobuild-Date(master): Thu May 7 16:23:40 UTC 2020 on sn-devel-184 --- diff --git a/docs-xml/smbdotconf/base/interfaces.xml b/docs-xml/smbdotconf/base/interfaces.xml index b804e64be9e..cbc29712385 100644 --- a/docs-xml/smbdotconf/base/interfaces.xml +++ b/docs-xml/smbdotconf/base/interfaces.xml @@ -41,12 +41,13 @@ In order to support SMB3 multi-channel configurations, smbd understands - some extra data that can be appended after the actual interface with - this extended syntax: + some extra parameters which can be appended after the actual interface with + this extended syntax (note that the quoting is important in order to handle the ; and , + characters): - interface[;key1=value1[,key2=value2[...]]] + "interface[;key1=value1[,key2=value2[...]]]" @@ -58,18 +59,29 @@ development rather than for production use. At least on Linux systems, these values should be auto-detected, but the settings can serve as last a resort when autodetection is not working or is not available. + The specified values overwrite the auto-detected values. - The example below configures three network interfaces corresponding + 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. The netmasks of the latter two interfaces would be set to 255.255.255.0. + + The other examples show how per interface extra parameters can be specified. + Notice the possible usage of "," and ";", which makes + the double quoting necessary. + bind interfaces only eth0 192.168.2.10/24 192.168.3.10/255.255.255.0 +eth0, 192.168.2.10/24; 192.168.3.10/255.255.255.0 +"eth0;if_index=65,speed=1000000000,capability=RSS" +"lo;speed=1000000000" "eth0;capability=RSS" +"lo;speed=1000000000" , "eth0;capability=RSS" +"eth0;capability=RSS" , "rdma1;capability=RDMA" ; "rdma2;capability=RSS,capability=RDMA"