sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2025-01-07 17:18:11 +03:00
Code

Change dfree command to be a share level parameter.

Browse Source 
Add docs for dfree cache time.
Jeremy.
(This used to be commit 16a4f358db)
This commit is contained in:
Jeremy Allison 2005-10-19 21:06:01 +00:00 committed by Gerald W. Carter
parent b09481cea8
commit 7f17d20313
2 changed files with 36 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/smbdotconf/misc/dfreecachetime.xml Normal file
View File

@ -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>

11
docs/smbdotconf/misc/dfreecommand.xml
View File

@ -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