2606f2028b367f77e7946602aedb8ac90bf11c75
[kai/samba.git] / docs-xml / smbdotconf / tuning / strictallocate.xml
1 <samba:parameter name="strict allocate"
2                  context="S"
3                                  type="boolean"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6     <para>This is a boolean that controls the handling of 
7     disk space allocation in the server. When this is set to <constant>yes</constant> 
8     the server will change from UNIX behaviour of not committing real
9     disk storage blocks when a file is extended to the Windows behaviour
10     of actually forcing the disk system to allocate real storage blocks
11     when a file is created or extended to be a given size. In UNIX
12     terminology this means that Samba will stop creating sparse files.
13     This can be slow on some systems.</para>
14
15     <para>When strict allocate is <constant>no</constant> the server does sparse
16     disk block allocation when a file is extended.</para>
17
18     <para>Setting this to <constant>yes</constant> can help Samba return
19     out of quota messages on systems that are restricting the disk quota
20     of users.</para>
21 </description>
22
23 <value type="default">no</value>
24 </samba:parameter>