From 86850860f871700da02000f5b7af374563134344 Mon Sep 17 00:00:00 2001
From: Andrew Bartlett <abartlet@samba.org>
Date: Wed, 15 Jan 2014 14:48:40 +1300
Subject: 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>
---
docs-xml/smbdotconf/protocol/readraw.xml | 9 ++++-----
docs-xml/smbdotconf/protocol/writeraw.xml | 20 ++++++++++++++++----
2 files changed, 20 insertions(+), 9 deletions(-)
(limited to 'docs-xml/smbdotconf')
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>
--
cgit