diff options
-rw-r--r-- | docs/smbdotconf/misc/dfreecachetime.xml | 27 | ||||
-rw-r--r-- | docs/smbdotconf/misc/dfreecommand.xml | 11 |
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 "Abort Retry + Ignore" 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 "Abort Retry Ignore" 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 |