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.</para>
  13
  14     <para>This option is really designed for file systems that support
  15     fast allocation of large numbers of blocks such as extent-based file systems.
  16     On file systems that don't support extents (most notably ext3) this can
  17     make Samba slower. When you work with large files over >100MB on file
  18     systems without extents you may even run into problems with clients
  19     running into timeouts.</para>
  20
  21     <para>When you have an extent based filesystem it's likely that we can make
  22     use of unwritten extents which allows Samba to allocate even large amounts
  23     of space very fast and you will not see any timeout problems caused by
  24     strict allocate. With strict allocate in use you will also get much better
  25     out of quota messages in case you use quotas. Another advantage of
  26     activating this setting is that it will help to reduce file
  27     fragmentation.</para>
  28
  29     <para>To give you an idea on which filesystems this setting might currently
  30     be a good option for you: XFS, ext4, btrfs, ocfs2 on Linux and JFS2 on
  31     AIX support unwritten extents. On Filesystems that do not support it,
  32     preallocation is probably an expensive operation where you will see reduced
  33     performance and risk to let clients run into timeouts when creating large
  34     files. Examples are ext3, ZFS, HFS+ and most others, so be aware if you
  35     activate this setting on those filesystems.</para>
  36
  37 </description>
  38
  39 <value type="default">no</value>
  40 </samba:parameter>