[SCM] Samba Shared Repository - branch v3-5-test updated

[Karolin Seeger]

The branch, v3-5-test has been updated
       via  b3c5b9d... s3-docs: Remove trailing whitespaces and fix a typo.
       via  cbf728c... s3:docs: add some advice for usage of strict allocate (cherry picked from commit 37115f91aebec9c846e54790c6bcf433ae35888a)
      from  d68c7db... tsocket/bsd: fix comment in tdgram_bsd_recvfrom_handler()

http://gitweb.samba.org/?p=samba.git;a=shortlog;h=v3-5-test


- Log -----------------------------------------------------------------
commit b3c5b9d7739143cc3cc7c004a73fce2969aaa6b8
Author: Karolin Seeger <kseeger at samba.org>
Date:   Thu Feb 18 13:10:21 2010 +0100

    s3-docs: Remove trailing whitespaces and fix a typo.
    
    Karolin
    (cherry picked from commit 494819773d61daa32d4ee2a0a15088f3b4abe6e2)

commit cbf728ce617323ca866799370491a402800772c1
Author: Björn Jacke <bj at sernet.de>
Date:   Wed Feb 17 23:03:32 2010 +0100

    s3:docs: add some advice for usage of strict allocate
    (cherry picked from commit 37115f91aebec9c846e54790c6bcf433ae35888a)

-----------------------------------------------------------------------

Summary of changes:
 docs-xml/smbdotconf/tuning/strictallocate.xml |   28 +++++++++++++++++-------
 1 files changed, 20 insertions(+), 8 deletions(-)


Changeset truncated at 500 lines:

diff --git a/docs-xml/smbdotconf/tuning/strictallocate.xml b/docs-xml/smbdotconf/tuning/strictallocate.xml
index 2606f20..1855574 100644
--- a/docs-xml/smbdotconf/tuning/strictallocate.xml
+++ b/docs-xml/smbdotconf/tuning/strictallocate.xml
@@ -3,21 +3,33 @@
 				 type="boolean"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <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> 
+    <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>
+    This can be slow on some systems. When you work with large files like
+    >100MB or so you may even run into problems with clients running into
+    timeouts.</para>
 
-    <para>When strict allocate is <constant>no</constant> the server does sparse
-    disk block allocation when a file is extended.</para>
+    <para>When you have an extent based filesystem it's likely that we can make
+    use of unwritten extents which allows Samba to allocate even large amounts
+    of space very fast and you will not see any timeout problems caused by
+    strict allocate. With strict allocate in use you will also get much better
+    out of quota messages in case you use quotas. Another advantage of
+    activating this setting is that it will help to reduce file
+    fragmentation.</para>
+
+    <para>To give you an idea on which filesystems this setting might currently
+    be a good option for you: XFS, ext4, btrfs, ocfs2 on Linux and JFS2 on
+    AIX support unwritten extents. On Filesystems that do not support it,
+    preallocation is probably an expensive operation where you will see reduced
+    performance and risk to let clients run into timeouts when creating large
+    files. Examples are ext3, ZFS, HFS+ and most others, so be aware if you
+    activate this setting on those filesystems.</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 Shared Repository