4c03861cf9caf718be9c19a3a71937dd05e27176
[tprouty/samba.git] / docs / smbdotconf / misc / dfreecachetime.xml
1 <samba:parameter name="dfree cache time"
2                  context="S"
3                          type="integer"
4                  advanced="1" developer="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7
8         <para>The <parameter moreinfo="none">dfree cache time</parameter>
9         should only be used on systems where a problem occurs with the
10         internal disk space calculations. This has been known to happen
11         with Ultrix, but may occur with other operating systems. The
12         symptom that was seen was an error of &quot;Abort Retry
13         Ignore&quot; at the end of each directory listing.</para>
14
15         <para>This is a new parameter introduced in Samba version 3.0.21.
16         It specifies in seconds the time that smbd will cache the output
17         of a disk free query. If set to zero (the default) no caching is
18         done. This allows a heavily loaded server to prevent rapid spawning
19         of <smbconfoption name="dfree command"/> scripts increasing the load.
20         </para>
21
22 </description>
23 <value type="default"><comment>By default this parameter is zero, meaning no caching
24                 will be done.</comment></value>
25 <value type="example">dfree cache time = 60</value>
26 </samba:parameter>