summaryrefslogtreecommitdiff
path: root/docs/smbdotconf/tuning/blocksize.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/smbdotconf/tuning/blocksize.xml')
-rw-r--r--docs/smbdotconf/tuning/blocksize.xml23
1 files changed, 23 insertions, 0 deletions
diff --git a/docs/smbdotconf/tuning/blocksize.xml b/docs/smbdotconf/tuning/blocksize.xml
new file mode 100644
index 0000000000..e6e5458163
--- /dev/null
+++ b/docs/smbdotconf/tuning/blocksize.xml
@@ -0,0 +1,23 @@
+<samba:parameter name="block size"
+ type="integer"
+ context="S"
+ xmlns:samba="http://samba.org/common">
+<description>
+ <para>This parameter controls the behavior of <citerefentry><refentrytitle>smbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> when reporting disk free
+ sizes. By default, this reports a disk block size of 1024 bytes.
+ </para>
+
+ <para>Changing this parameter may have some effect on the
+ efficiency of client writes, this is not yet confirmed. This
+ parameter was added to allow advanced administrators to change
+ it (usually to a higher value) and test the effect it has on
+ client write performance without re-compiling the code. As this
+ is an experimental option it may be removed in a future release.
+ </para>
+
+ <para>Changing this option does not change the disk free reporting
+ size, just the block size unit reported to the client.
+ </para>
+</description>
+</samba:parameter>