summaryrefslogtreecommitdiff
path: root/docs-xml/smbdotconf/tuning
diff options
context:
space:
mode:
authorScott Lovenberg <scott.lovenberg@gmail.com>2013-03-04 19:09:12 -0500
committerAndrew Bartlett <abartlet@samba.org>2013-03-06 02:22:24 +0100
commit511e575e29a62c5d7dece91e41dd965e9546147c (patch)
tree634612169610599ac9377031d9307b38a59ea469 /docs-xml/smbdotconf/tuning
parent90cbfc96d118d6b55c47392d8ae421434dea8225 (diff)
downloadsamba-511e575e29a62c5d7dece91e41dd965e9546147c.tar.gz
samba-511e575e29a62c5d7dece91e41dd965e9546147c.tar.bz2
samba-511e575e29a62c5d7dece91e41dd965e9546147c.zip
Documentation: Add a warning to "socket options"
Add a warning to the "socket options" section of the smb.conf man page that changing socket options can be dangerous to performance. Hopefully this will cut down on users reporting poor performance after changing socket options. Signed-off-by: Scott Lovenberg <scott.lovenberg@gmail.com> Reviewed-by: Andrew Bartlett <abartlet@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
Diffstat (limited to 'docs-xml/smbdotconf/tuning')
-rw-r--r--docs-xml/smbdotconf/tuning/socketoptions.xml17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs-xml/smbdotconf/tuning/socketoptions.xml b/docs-xml/smbdotconf/tuning/socketoptions.xml
index 7a5c221939..27ae5fd32b 100644
--- a/docs-xml/smbdotconf/tuning/socketoptions.xml
+++ b/docs-xml/smbdotconf/tuning/socketoptions.xml
@@ -4,6 +4,23 @@
developer="1"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
+ <para>
+ <warning>
+ <para>Modern server operating systems are tuned for high
+ network performance in the majority of situations; when you set socket
+ options you are overriding those settings. Linux in particular has an
+ auto-tuning mechanism for buffer sizes that will be disabled if you
+ specify a socket buffer size. This can potentially cripple your
+ TCP/IP stack.</para>
+
+ <para> Getting the socket options correct can make a big difference to
+ your performance, but getting them wrong can degrade it by just as
+ much. As with any other low level setting, if you must make changes
+ to it, make small changes and <emphasis>test</emphasis> the effect
+ before making any large changes.</para>
+ </warning>
+ </para>
+
<para>This option allows you to set socket options
to be used when talking with the client.</para>