summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/protocol/readraw.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docbook/smbdotconf/protocol/readraw.xml')
-rw-r--r--docs/docbook/smbdotconf/protocol/readraw.xml24
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/docbook/smbdotconf/protocol/readraw.xml b/docs/docbook/smbdotconf/protocol/readraw.xml
new file mode 100644
index 0000000000..6b24f39d68
--- /dev/null
+++ b/docs/docbook/smbdotconf/protocol/readraw.xml
@@ -0,0 +1,24 @@
+<samba:parameter name="read raw"
+ context="G"
+ developer="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This parameter controls whether or not the server
+ will support the raw read SMB requests when transferring data
+ to clients.</para>
+
+ <para>If enabled, raw reads allow reads of 65535 bytes in
+ one packet. This typically provides a major performance benefit.
+ </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 reads.</para>
+
+ <para>In general this parameter should be viewed as a system tuning
+ tool and left severely alone. See also <link linkend="WRITERAW">
+ <parameter moreinfo="none">write raw</parameter></link>.</para>
+
+ <para>Default: <command moreinfo="none">read raw = yes</command></para>
+</listitem>
+</samba:parameter>