docs-xml/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>This parameter controls whether Samba honors a request
   7     from an SMB client to ensure any outstanding operating system
   8     buffer contents held in memory are safely written onto stable
   9     storage on disk. If set to <constant>yes</constant>, which is
  10     the default, then Windows applications can force the smbd server
  11     to synchronize unwritten data onto the disk. If set to
  12     <constant>no</constant> then smbd will ignore client
  13     requests to synchronize unwritten data onto stable storage on
  14     disk.</para>
  15
  16     <para>In Samba 4.7.0, the default for this parameter changed from
  17     <constant>no</constant> to <constant>yes</constant> to better
  18     match the expectations of SMB2/3 clients and improve application
  19     safety when running against smbd.</para>
  20
  21     <para>The flush request from SMB2/3 clients is handled
  22     asynchronously inside smbd, so leaving the parameter as the default
  23     value of <constant>yes</constant> does not block the processing of
  24     other requests to the smbd process.</para>
  25
  26     <para>Legacy Windows applications (such as the Windows 98 explorer
  27     shell) seemed to confuse writing buffer contents to the operating
  28     system with synchronously writing outstanding data onto stable storage
  29     on disk. Changing this parameter to <constant>no</constant> means that
  30     <citerefentry><refentrytitle>smbd</refentrytitle>
  31     <manvolnum>8</manvolnum></citerefentry> will ignore the Windows
  32     applications request to synchronize unwritten data onto disk. Only
  33     consider changing this if smbd is serving obsolete SMB1 Windows clients
  34     prior to Windows XP (Windows 98 and below). There should be no need to
  35     change this setting for normal operations.</para>
  36 </description>
  37
  38 <related>sync always</related>
  39 <value type="default">yes</value>
  40 </samba:parameter>