diff options
author | Andrew Bartlett <abartlet@samba.org> | 2014-01-15 14:48:40 +1300 |
---|---|---|
committer | Andrew Bartlett <abartlet@samba.org> | 2014-02-12 13:17:13 +1300 |
commit | 86850860f871700da02000f5b7af374563134344 (patch) | |
tree | f667e5e2a3e45f60fa7c37501b4f2b436f9e8041 /docs-xml/smbdotconf | |
parent | aea623e050530ad79c47e590373ad8241eb3914d (diff) | |
download | samba-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/smbdotconf')
-rw-r--r-- | docs-xml/smbdotconf/protocol/readraw.xml | 9 | ||||
-rw-r--r-- | docs-xml/smbdotconf/protocol/writeraw.xml | 20 |
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> |