summaryrefslogtreecommitdiffstats
path: root/docs-xml/smbdotconf/tuning/aiowritesize.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs-xml/smbdotconf/tuning/aiowritesize.xml')
-rw-r--r--docs-xml/smbdotconf/tuning/aiowritesize.xml24
1 files changed, 24 insertions, 0 deletions
diff --git a/docs-xml/smbdotconf/tuning/aiowritesize.xml b/docs-xml/smbdotconf/tuning/aiowritesize.xml
new file mode 100644
index 0000000..1d649fe
--- /dev/null
+++ b/docs-xml/smbdotconf/tuning/aiowritesize.xml
@@ -0,0 +1,24 @@
+<samba:parameter name="aio write size"
+ context="S"
+ type="bytes"
+ xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+ <para>If this integer parameter is set to a non-zero value,
+ Samba will write to files asynchronously when the request size 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>The only reasonable values for this parameter are 0 (no async I/O) and
+ 1 (always do async I/O).</para>
+ <para>Compared to <smbconfoption name="aio read size"/> this parameter has
+ a smaller effect, most writes should end up in the
+ file system cache. Writes that require space allocation might
+ benefit most from going asynchronous.</para>
+
+ <related>write cache size</related>
+ <related>aio read size</related>
+</description>
+
+<value type="default">1</value>
+<value type="example">0<comment>Always do writes synchronously
+ </comment></value>
+</samba:parameter>