            FTPpie - Shows the disk usage on a remote FTP server

PURPOSE

FTPpie shows the amount of disk space used on an FTP server.  Typically you
would use when your ISP limits the amount of Web space you are allowed to 
consume, and you need to check just where your quota has gone!

Use the File, Open menu to enter your server details and see where your 
maximum space is being consumed.  You can navigate the directory structure
on the FTP server by double-clicking on the piechart segments, or on the 
folder list, or by using the Up button.  

Note that your Web pages may not be stored in the root directory of the
ISP's server.  For example, with a ZEUS Web server the files are in a folder
called /htdocs/.  You should enter this value in the Directory box.

The units for display can be set with the Options, Units menu to bytes, 
Kilobytes, Megabytes or just a count of files in the selected part of the 
tree.  If you wish to Cancel the scan (which can take a long time!), please
be patient after pressing the Cancel button.

You can enter a value for the space you are allowed to occupy on the 
server.  Typically, your ISP will limit the about of Web storage you can 
have to 10MB, 25MB or whatever.  If you have space free, it will be shown
as a positive number, but if you are overdrawn, the free space is shown as 
a negative value in grey!

If you know the cluster size of the operating system that your ISP uses to
store your Web pages, you can get a more accurate space estimate by setting
the cluster size from the Options, Cluster size menu.  Typically this will
be 4096 (Windows server) or 8192 (UNIX server).  The program approximates
the effect of cluster size by adding half the cluster size to each file 
found, so your results may not agree byte-for-byte with your ISP.

The program will remember the server name etc. with a registry key that 
depends on the program's executable name.  This allows you to remember 
multiple servers by having multiple copies of the (relatively small) .exe
file, i.e. FTPpie.exe, FTPpieA.exe and so forth.


INSTALLATION AND USAGE

Extract FTPpie.exe from the zip file to a suitable folder and run FTPpie.exe.


REGISTRATION

Use of this program for any commercial or for-profit purposes requires
registration.  If you like this program, and wish to say "Thank you", or if 
you want technical support, please register my Network Tools at:

  http://www.satsignal.net  =>  Software, Register, Network Tools


ANALYSING "Missing DLL" MESSAGES

If Windows reports a missing library, you can find which is missing from the
error message reported by Windows:

  WSOCK32.DLL - Windows sockets library is missing


NOTES

The program is written for Borland's Delphi 4.03.  You do not need access to 
Delphi to run FTPpie.  The program has been developed on Windows 2000 and 
XP, and should run on Windows NT 4, 95, 98, ME, XP and 2000.

The program has been tested against both Microsoft and UNIX FTP servers.


RELEASE INFORMATION

V1.0.0  2000 Oct 15  First version
V1.1.0  2001 Jan 06  Add allowed space option
                     Save password if user accepts the security risk
V1.2.0  2001 Apr 23  Add View, Refresh option (F5 shortcut)
                     Show hour-glass while scanning
                     Add proxy option
V1.3.0  2001 Jul 16  Remove small resource leak
                     Correct repeated scans
                     Build without Delphi runtime requirement
V1.3.2  2001 Jul 18  Clarify allowed-space entry
V1.3.4  2001 Aug 30  Don't show free space when quota exceeded
V1.3.6  2002 Feb 23  Handle files with spaces in their names
V1.3.8  2002 Apr 25  Allow the cluster size to be entered
                     Approximated by adding half the cluster size to each object
V1.4.0  2003 Mar 26  Approximate folder space occupied as well
                     Trap potential error with UNIX servers
                     Don't require the Borland VCL40 run-time library


PROGRAM STATUS AND DISTRIBUTION

This program is copyrighted software from David J Taylor, Edinburgh and 
is provided "as is", without any support.  Whilst I cannot answer queries 
relating to the use of this program, I would value any comments or 
suggestions for improvements you may have.


SUPPORT GROUP

There is a self-help mailing list where other users of the software may be 
contacted, and I recommend that you join this list.

  http://groups.yahoo.com/group/DavidTaylorsSoftware 


ACKNOWLEDGEMENTS

TVersionInfoResource is from Brad Stowers
  http://www.pobox.com/~bstowers/delphi/
  Copyright bstowers@pobox.com (CompuServe 72733,3374)


CONTACTING THE AUTHOR

Web site:  www.satsignal.net
E-mail:    davidtaylor@writeme.com
2003 Mar 26
