diff options
| author | Jeremy Allison <jra@samba.org> | 2005-10-19 21:06:01 +0000 |
|---|---|---|
| committer | Gerald W. Carter <jerry@samba.org> | 2008-04-23 08:47:10 -0500 |
| commit | 7f17d203139ec1fbd54aefbf3f013827c15d1e31 (patch) | |
| tree | 2437683d08f40d185db201c41c8c80e71dfe3b06 /docs/smbdotconf | |
| parent | b09481cea876fbe813f1fad620b1ce0f69ef28bb (diff) | |
| download | samba-7f17d203139ec1fbd54aefbf3f013827c15d1e31.tar.gz samba-7f17d203139ec1fbd54aefbf3f013827c15d1e31.tar.bz2 samba-7f17d203139ec1fbd54aefbf3f013827c15d1e31.zip | |
Change dfree command to be a share level parameter.
Add docs for dfree cache time.
Jeremy.
(This used to be commit 16a4f358dbb9a6a12d6c4727612e88dcb14de921)
Diffstat (limited to 'docs/smbdotconf')
| -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 |