summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/smbdotconf/misc/dfreecachetime.xml27
-rw-r--r--docs/smbdotconf/misc/dfreecommand.xml11
2 files changed, 36 insertions, 2 deletions
diff --git a/docs/smbdotconf/misc/dfreecachetime.xml b/docs/smbdotconf/misc/dfreecachetime.xml
new file mode 100644
index 0000000000..96088bb30e
--- /dev/null
+++ b/docs/smbdotconf/misc/dfreecachetime.xml
@@ -0,0 +1,27 @@
+<samba:parameter name="dfree cache time"
+ context="S"
+ type="integer"
+ advanced="1" developer="1"
+ xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+
+ <para>The <parameter moreinfo="none">dfree cache time</parameter>
+ should only be used on systems where a problem occurs with the
+ internal disk space calculations. This has been known to happen
+ with Ultrix, but may occur with other operating systems. The
+ symptom that was seen was an error of &quot;Abort Retry
+ Ignore&quot; at the end of each directory listing.</para>
+
+ <para>This is a new parameter introduced in Samba version 3.0.21.
+ It specifies in seconds the time that smbd will cache the output
+ of a disk free query. If set to zero (the default) no caching is
+ done. This allows a heavily loaded server to prevent rapid spawning
+ of <smbconfoption name="dfree command"/>dfree command scripts
+ increasing the load.
+ </para>
+
+</description>
+<value type="default"><comment>By default this parameter is zero, meaning no caching
+ will be done.</comment></value>
+<value type="example">dfree cache time = 60</value>
+</samba:parameter>
diff --git a/docs/smbdotconf/misc/dfreecommand.xml b/docs/smbdotconf/misc/dfreecommand.xml
index 4a9de5c84d..be5f00aabd 100644
--- a/docs/smbdotconf/misc/dfreecommand.xml
+++ b/docs/smbdotconf/misc/dfreecommand.xml
@@ -1,5 +1,5 @@
<samba:parameter name="dfree command"
- context="G"
+ context="S"
type="string"
advanced="1" developer="1"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
@@ -11,12 +11,19 @@
with Ultrix, but may occur with other operating systems. The
symptom that was seen was an error of &quot;Abort Retry
Ignore&quot; at the end of each directory listing.</para>
-
+
<para>This setting allows the replacement of the internal routines to
calculate the total disk space and amount available with an external
routine. The example below gives a possible script that might fulfill
this function.</para>
+ <para>In Samba version 3.0.21 this parameter has been changed to be
+ a per-share parameter, and in addition the parameter
+ <smbconfoption name="dfree cache time"/>dfree cache time was added
+ to allow the output of this script to be cached for systems under
+ heavy load.
+ </para>
+
<para>The external program will be passed a single parameter indicating
a directory in the filesystem being queried. This will typically consist
of the string <filename moreinfo="none">./</filename>. The script should return two