summaryrefslogtreecommitdiffstats
path: root/docs-xml
diff options
context:
space:
mode:
authorAndrew Bartlett <abartlet@samba.org>2014-01-15 14:48:40 +1300
committerAndrew Bartlett <abartlet@samba.org>2014-02-12 13:17:13 +1300
commit86850860f871700da02000f5b7af374563134344 (patch)
treef667e5e2a3e45f60fa7c37501b4f2b436f9e8041 /docs-xml
parentaea623e050530ad79c47e590373ad8241eb3914d (diff)
downloadsamba-86850860f871700da02000f5b7af374563134344.tar.gz
samba-86850860f871700da02000f5b7af374563134344.tar.xz
samba-86850860f871700da02000f5b7af374563134344.zip
lib/param: Normalise "read raw" and "write raw" parameters
They have been changed to function like normal parameters, removing a special case in the loadparm system. Andrew Bartlett Signed-off-by: Andrew Bartlett <abartlet@samba.org> Reviewed-by: Garming Sam <garming@catalyst.net.nz> Reviewed-by: Michael Adam <obnox@samba.org>
Diffstat (limited to 'docs-xml')
-rw-r--r--docs-xml/smbdotconf/protocol/readraw.xml9
-rw-r--r--docs-xml/smbdotconf/protocol/writeraw.xml20
2 files changed, 20 insertions, 9 deletions
diff --git a/docs-xml/smbdotconf/protocol/readraw.xml b/docs-xml/smbdotconf/protocol/readraw.xml
index 3ff250c1a5a..fb54cc0c000 100644
--- a/docs-xml/smbdotconf/protocol/readraw.xml
+++ b/docs-xml/smbdotconf/protocol/readraw.xml
@@ -2,15 +2,13 @@
context="G"
type="boolean"
developer="1"
- generated_function="0"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
- <para>This parameter controls whether or not the server
- will support the raw read SMB requests when transferring data
- to clients.</para>
+ <para>This is ignored if <smbconfoption name="async echo handler"/> is set,
+ because this feature is incompatible with raw read SMB requests</para>
<para>If enabled, raw reads allow reads of 65535 bytes in
- one packet. This typically provides a major performance benefit.
+ one packet. This typically provides a major performance benefit for some very, very old clients.
</para>
<para>However, some clients either negotiate the allowable
@@ -24,4 +22,5 @@
<value type="default">yes</value>
<related>write raw</related>
+<related>async echo handler</related>
</samba:parameter>
diff --git a/docs-xml/smbdotconf/protocol/writeraw.xml b/docs-xml/smbdotconf/protocol/writeraw.xml
index 963803f62ae..fb9e386b7d1 100644
--- a/docs-xml/smbdotconf/protocol/writeraw.xml
+++ b/docs-xml/smbdotconf/protocol/writeraw.xml
@@ -2,13 +2,25 @@
context="G"
type="boolean"
developer="1"
- generated_function="0"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
- <para>This parameter controls whether or not the server
- will support raw write SMB's when transferring data from clients.
- You should never need to change this parameter.</para>
+ <para>This is ignored if <smbconfoption name="async echo handler"/> is set,
+ because this feature is incompatible with raw write SMB requests</para>
+
+ <para>If enabled, raw writes allow writes of 65535 bytes in
+ one packet. This typically provides a major performance benefit for some very, very old clients.
+ </para>
+
+ <para>However, some clients either negotiate the allowable
+ block size incorrectly or are incapable of supporting larger block
+ sizes, and for these clients you may need to disable raw writes.</para>
+
+<para>In general this parameter should be viewed as a system tuning
+ tool and left severely alone.</para>
</description>
<value type="default">yes</value>
+
+<related>read raw</related>
+<related>async echo handler</related>
</samba:parameter>