Next update of VFS modules development guide
[vlendec/samba-autobuild/.git] / docs / smbdotconf / tuning / strictsync.xml
1 <samba:parameter name="strict sync"
2                  context="S"
3                                  type="boolean"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5  <description>
6     <para>Many Windows applications (including the Windows 98 explorer
7     shell) seem to confuse flushing buffer contents to disk with doing
8     a sync to disk. Under UNIX, a sync call forces the process to be
9     suspended until the kernel has ensured that all outstanding data in
10     kernel disk buffers has been safely stored onto stable storage.
11     This is very slow and should only be done rarely. Setting this
12     parameter to <constant>no</constant> (the default) means that
13     <citerefentry><refentrytitle>smbd</refentrytitle>
14     <manvolnum>8</manvolnum></citerefentry> ignores the Windows
15     applications requests for a sync call. There is only a possibility
16     of losing data if the operating system itself that Samba is running
17     on crashes, so there is little danger in this default setting. In
18     addition, this fixes many performance problems that people have
19     reported with the new Windows98 explorer shell file copies.</para>
20 </description>
21
22 <related>sync always</related>
23 <value type="default">no</value>
24 </samba:parameter>