svn commit: samba-docs r843 - in trunk/smbdotconf/misc: .

jra at samba.org jra at samba.org
Wed Oct 19 21:06:01 GMT 2005


Author: jra
Date: 2005-10-19 21:06:01 +0000 (Wed, 19 Oct 2005)
New Revision: 843

WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba-docs&rev=843

Log:
Change dfree command to be a share level parameter.
Add docs for dfree cache time.
Jeremy.

Added:
   trunk/smbdotconf/misc/dfreecachetime.xml
Modified:
   trunk/smbdotconf/misc/dfreecommand.xml


Changeset:
Added: trunk/smbdotconf/misc/dfreecachetime.xml
===================================================================
--- trunk/smbdotconf/misc/dfreecachetime.xml	2005-10-19 20:11:44 UTC (rev 842)
+++ trunk/smbdotconf/misc/dfreecachetime.xml	2005-10-19 21:06:01 UTC (rev 843)
@@ -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>

Modified: trunk/smbdotconf/misc/dfreecommand.xml
===================================================================
--- trunk/smbdotconf/misc/dfreecommand.xml	2005-10-19 20:11:44 UTC (rev 842)
+++ trunk/smbdotconf/misc/dfreecommand.xml	2005-10-19 21:06:01 UTC (rev 843)
@@ -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 



More information about the samba-cvs mailing list