svn commit: samba-docs r1116 - in trunk/smbdotconf/tuning: .

[ab at samba.org]

Author: ab
Date: 2007-05-17 12:19:46 +0000 (Thu, 17 May 2007)
New Revision: 1116

WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba-docs&rev=1116

Log:
Document async I/O options
Added:
   trunk/smbdotconf/tuning/aioreadsize.xml
   trunk/smbdotconf/tuning/aiowritesize.xml


Changeset:
Added: trunk/smbdotconf/tuning/aioreadsize.xml
===================================================================
--- trunk/smbdotconf/tuning/aioreadsize.xml	2007-05-16 17:47:29 UTC (rev 1115)
+++ trunk/smbdotconf/tuning/aioreadsize.xml	2007-05-17 12:19:46 UTC (rev 1116)
@@ -0,0 +1,22 @@
+<samba:parameter name="aio read size"
+                 context="S"
+		 type="integer"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+  <para>If Samba has been built with asynchronous I/O support and this
+    integer parameter is set to non-zero value,
+    Samba will read from file asynchronously when size of request is bigger
+    than this value. Note that it happens only for non-chained and non-chaining
+    reads and when not using write cache.</para>
+
+  <para>Current implementation of asynchronous I/O in Samba 3.0 does support
+    only up to 10 outstanding asynchronous requests, read and write combined.</para>
+
+  <related>write cache size</related>
+  <related>aio write size</related>
+</description>
+
+<value type="default">0</value>
+<value type="example">16384<comment> Use asynchronous I/O for reads bigger than 16KB
+    request size</comment></value>
+</samba:parameter>

Added: trunk/smbdotconf/tuning/aiowritesize.xml
===================================================================
--- trunk/smbdotconf/tuning/aiowritesize.xml	2007-05-16 17:47:29 UTC (rev 1115)
+++ trunk/smbdotconf/tuning/aiowritesize.xml	2007-05-17 12:19:46 UTC (rev 1116)
@@ -0,0 +1,22 @@
+<samba:parameter name="aio write size"
+                 context="S"
+		 type="integer"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+  <para>If Samba has been built with asynchronous I/O support and this
+    integer parameter is set to non-zero value,
+    Samba will write to file asynchronously when size of request is bigger
+    than this value. Note that it happens only for non-chained and non-chaining
+    reads and when not using write cache.</para>
+
+  <para>Current implementation of asynchronous I/O in Samba 3.0 does support
+    only up to 10 outstanding asynchronous requests, read and write combined.</para>
+  
+  <related>write cache size</related>
+  <related>aio read size</related>
+</description>
+
+<value type="default">0</value>
+<value type="example">16384<comment> Use asynchronous I/O for writes bigger than 16KB
+    request size</comment></value>
+</samba:parameter>