From 7f17d203139ec1fbd54aefbf3f013827c15d1e31 Mon Sep 17 00:00:00 2001 From: Jeremy Allison Date: Wed, 19 Oct 2005 21:06:01 +0000 Subject: [PATCH] Change dfree command to be a share level parameter. Add docs for dfree cache time. Jeremy. (This used to be commit 16a4f358dbb9a6a12d6c4727612e88dcb14de921) --- docs/smbdotconf/misc/dfreecachetime.xml | 27 +++++++++++++++++++++++++++ docs/smbdotconf/misc/dfreecommand.xml | 11 +++++++++-- 2 files changed, 36 insertions(+), 2 deletions(-) create mode 100644 docs/smbdotconf/misc/dfreecachetime.xml diff --git a/docs/smbdotconf/misc/dfreecachetime.xml b/docs/smbdotconf/misc/dfreecachetime.xml new file mode 100644 index 00000000000..96088bb30eb --- /dev/null +++ b/docs/smbdotconf/misc/dfreecachetime.xml @@ -0,0 +1,27 @@ + + + + The dfree cache time + 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. + + 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 dfree command scripts + increasing the load. + + + +By default this parameter is zero, meaning no caching + will be done. +dfree cache time = 60 + diff --git a/docs/smbdotconf/misc/dfreecommand.xml b/docs/smbdotconf/misc/dfreecommand.xml index 4a9de5c84d9..be5f00aabd1 100644 --- a/docs/smbdotconf/misc/dfreecommand.xml +++ b/docs/smbdotconf/misc/dfreecommand.xml @@ -1,5 +1,5 @@ @@ -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. - + 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. + In Samba version 3.0.21 this parameter has been changed to be + a per-share parameter, and in addition the parameter + dfree cache time was added + to allow the output of this script to be cached for systems under + heavy load. + + The external program will be passed a single parameter indicating a directory in the filesystem being queried. This will typically consist of the string ./. The script should return two -- 2.11.4.GIT