docs/smbdotconf/tuning/changenotifytimeout.xml

   1 <samba:parameter name="change notify timeout"
   2         type="integer"
   3                  context="S"
   4                  developer="1"
   5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   6 <description>
   7     <para>This SMB allows a client to tell a server to
   8     &quot;watch&quot; a particular directory for any changes and only reply to
   9     the SMB request when a change has occurred. Such constant scanning of
  10     a directory is expensive under UNIX, hence an <citerefentry><refentrytitle>smbd</refentrytitle>
  11     <manvolnum>8</manvolnum></citerefentry> daemon only performs such a scan
  12     on each requested directory once every <parameter moreinfo="none">change notify
  13     timeout</parameter> seconds. Note that in 3.0.23 this has been changed to a
  14     per-share parameter and setting this to zero prevents any change notify directory
  15     scans completely on a share. This is to allow this paramter to be set to zero on
  16     shares configured for very large directories, where a Windows client will re-scan
  17     the entire directory after every delete operation (when deleting many files) due to
  18     the change notify triggering. This is an extremely expensive operation on some
  19     systems.</para>
  20 </description>
  21
  22 <value type="default">60</value>
  23 <value type="example">300<comment>Would change the scan time to every 5 minutes.</comment></value>
  24 </samba:parameter>