summaryrefslogtreecommitdiff
path: root/docs/smbdotconf/tuning/strictallocate.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/smbdotconf/tuning/strictallocate.xml')
-rw-r--r--docs/smbdotconf/tuning/strictallocate.xml24
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/smbdotconf/tuning/strictallocate.xml b/docs/smbdotconf/tuning/strictallocate.xml
new file mode 100644
index 0000000000..d1ffdf63a4
--- /dev/null
+++ b/docs/smbdotconf/tuning/strictallocate.xml
@@ -0,0 +1,24 @@
+<samba:parameter name="strict allocate"
+ context="S"
+ type="boolean"
+ xmlns:samba="http://samba.org/common">
+<description>
+ <para>This is a boolean that controls the handling of
+ disk space allocation in the server. When this is set to <constant>yes</constant>
+ the server will change from UNIX behaviour of not committing real
+ disk storage blocks when a file is extended to the Windows behaviour
+ of actually forcing the disk system to allocate real storage blocks
+ when a file is created or extended to be a given size. In UNIX
+ terminology this means that Samba will stop creating sparse files.
+ This can be slow on some systems.</para>
+
+ <para>When strict allocate is <constant>no</constant> the server does sparse
+ disk block allocation when a file is extended.</para>
+
+ <para>Setting this to <constant>yes</constant> can help Samba return
+ out of quota messages on systems that are restricting the disk quota
+ of users.</para>
+</description>
+
+<value type="default">no</value>
+</samba:parameter>