diff options
Diffstat (limited to 'docs/smbdotconf/misc')
| -rw-r--r-- | docs/smbdotconf/misc/dfreecachetime.xml | 27 | ||||
| -rw-r--r-- | docs/smbdotconf/misc/dfreecommand.xml | 50 |
2 files changed, 37 insertions, 40 deletions
diff --git a/docs/smbdotconf/misc/dfreecachetime.xml b/docs/smbdotconf/misc/dfreecachetime.xml index 4c03861cf9..2a8805e948 100644 --- a/docs/smbdotconf/misc/dfreecachetime.xml +++ b/docs/smbdotconf/misc/dfreecachetime.xml @@ -5,22 +5,23 @@ 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> + 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"/> scripts increasing the load. + </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"/> scripts increasing the load. + <para> + By default this parameter is zero, meaning no caching will be done. </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 7f8dda1a7e..d7fb675f27 100644 --- a/docs/smbdotconf/misc/dfreecommand.xml +++ b/docs/smbdotconf/misc/dfreecommand.xml @@ -6,45 +6,39 @@ <description> <para> - The <parameter moreinfo="none">dfree command</parameter> setting - 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. + The <parameter moreinfo="none">dfree command</parameter> setting 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 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. + 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"/> was added - to allow the output of this script to be cached for systems under - heavy load. + 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"/> 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 - integers in ASCII. The first should be the total disk space in blocks, - and the second should be the number of available blocks. An optional - third return value can give the block size in bytes. The default - blocksize is 1024 bytes. + 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 integers in ASCII. The first should be the total disk space in blocks, and the second should be the number + of available blocks. An optional third return value can give the block size in bytes. The default blocksize is + 1024 bytes. </para> <para> - Note: Your script should <emphasis>NOT</emphasis> be setuid or - setgid and should be owned by (and writeable only by) root! + Note: Your script should <emphasis>NOT</emphasis> be setuid or setgid and should be owned by (and writeable + only by) root! </para> - <para>Where the script dfree (which must be made executable) could be: + <para> + Where the script dfree (which must be made executable) could be: <programlisting format="linespecific"> #!/bin/sh df $1 | tail -1 | awk '{print $2" "$4}' @@ -57,8 +51,10 @@ df $1 | tail -1 | awk '{print $2" "$4}' Note that you may have to replace the command names with full path names on some systems. </para> + <para> + By default internal routines for determining the disk capacity and remaining space will be used. + </para> + </description> -<value type="default"><comment>By default internal routines for - determining the disk capacity and remaining space will be used.</comment></value> <value type="example">/usr/local/samba/bin/dfree</value> </samba:parameter> |