docs-xml/smbdotconf/tuning/blocksize.xml

   1 <samba:parameter name="block size"
   2                                 type="integer"
   3                  context="S"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6     <para>This parameter controls the behavior of <citerefentry><refentrytitle>smbd</refentrytitle>
   7     <manvolnum>8</manvolnum></citerefentry> when reporting disk free
   8     sizes. By default, this reports a disk block size of 1024 bytes.
   9     </para>
  10
  11     <para>Changing this parameter may have some effect on the
  12     efficiency of client writes, this is not yet confirmed. This
  13     parameter was added to allow advanced administrators to change
  14     it (usually to a higher value) and test the effect it has on
  15     client write performance without re-compiling the code. As this
  16     is an experimental option it may be removed in a future release.
  17     </para>
  18
  19     <para>Changing this option does not change the disk free reporting
  20     size, just the block size unit reported to the client.
  21     </para>
  22 </description>
  23
  24 <value type="default">1024</value>
  25 <value type="example">4096</value>
  26
  27 </samba:parameter>