From f88faa0105fdf47eccfa3212870ac3066ff8113c Mon Sep 17 00:00:00 2001 From: John Terpstra Date: Sat, 22 Oct 2005 00:04:38 +0000 Subject: Fixes and reformatting from Bug #3190, plus a clean-up. (This used to be commit 8250e36fe34394938df16533f77869b93d3be761) --- docs/smbdotconf/misc/dfreecommand.xml | 34 +++++++++++++++++++--------------- 1 file changed, 19 insertions(+), 15 deletions(-) (limited to 'docs/smbdotconf/misc') diff --git a/docs/smbdotconf/misc/dfreecommand.xml b/docs/smbdotconf/misc/dfreecommand.xml index be5f00aabd..546cead306 100644 --- a/docs/smbdotconf/misc/dfreecommand.xml +++ b/docs/smbdotconf/misc/dfreecommand.xml @@ -5,51 +5,55 @@ xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"> - The dfree command setting + + The dfree command 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. + Ignore" at the end of each directory listing. + - This setting allows the replacement of the internal routines to + + 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 function. + - In Samba version 3.0.21 this parameter has been changed to be + + 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 + + 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 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. + blocksize is 1024 bytes. + - Note: Your script should NOT be setuid or - setgid and should be owned by (and writeable only by) root! + + Note: Your script should NOT be setuid or + setgid and should be owned by (and writeable only by) root! + Where the script dfree (which must be made executable) could be: #!/bin/sh df $1 | tail -1 | awk '{print $2" "$4}' - - - or perhaps (on Sys V based systems): + or perhaps (on Sys V based systems): #!/bin/sh /usr/bin/df -k $1 | tail -1 | awk '{print $3" "$5}' - - - Note that you may have to replace the command names with full path names on some systems. -- cgit