

   README for DFEMX.ZIP
   ====================

   The Zipfile should contain the following files:
   DF.EXE	the program compiled with gcc/emx-0.8g
   DF.CC	the source code
   MAKEFILE	a makefile for dmake
   README.TXT	this text

   This is the nth OS/2 port of the well known Unix utility df.

   I wrote a new version because the OS/2 computers in our institute
   are networked with TCP/IP 1.2.1, Lan Manager and Lan Server.
   Existing versions of DF either do not work at all with NFS, LAN or
   CDROM drives or do so only with great difficulties or when they do
   come up with nonsense when calculating the available disk space on
   drives > 2GigaBytes.

   The current version of DF can (hopefully) deal with FAT and HPFS
   partitions, CDROMs, LAN and NFS drives up to a size of 4 Terabytes.
   All drive letters from C to Z are checked if they are connected to
   a file system driver. If they are connected the program
   displays how they are mounted. In addition the used file system
   driver (FAT,HPFS,CDROM,LAN,NFS) is shown as well as the name of
   mounted services in case of LAN and NFS drives. Unused drive letters
   are skipped. The program has been testet with TCP/IP 1.2.1 and
   LanManager 2.1.  For three months I have now been waiting (in vain)
   for Lan Server 3.0 but DF should work with it as well. The output
   for CDROM drives is not yet tested. I would be grateful for any
   reports.

   The output of the program looks as follows (on my computer):

   Filesystem          1024-blocks       Used  Available  Capacity  Mounted on
   local                    121728     108147      13581       88%  C:(HPFS)
   syli30:/                 435736     248121     187615       56%  D:(NFS)
   sylisv:/sylisv_disk1     649920     458615     191305       70%  E:(NFS)
   sylisv:/sylisv_disk2     649920     587880      62040       90%  F:(NFS)
   sylisv:/sylisv_disk3    1310802    1172847     137955       89%  G:(NFS)
   \\SYLISV\ESSER            10155       7166       2989       70%  Z:(LAN)

   
   In the first column, the service name is displayed for LAN and NFS
   drives; local drives are flagged 'local'. The following 3 columns
   contain the total, used and free capacity in kBytes. The following
   column shows the disk percentage used and the last column shows the
   drive letter and the name of the file system driver for this drive.

   The program was developed in C++ with emx-0.8g. The sources are
   included.  The screen output is certainly not yet optimal,
   particularly with long service names. If you do not like it you may
   accomodate the sources to your taste. There are no command line options
   as in the Unix original.  Due to its shortness the program is hardly
   commented. This is not that much a disadvantage as comments are only
   required for the three operating system calls. These can be looked up
   in the programmers toolkit documentation. The exe-file is about 60 
   kByte. This is mainly due to the overhead when using C++ and linking
   with lgpp. It is no problem to convert the program to plain C, the 
   size of the exe-file will then be around 30 kByte. If you use C and 
   do not link the exe-file statically but use -Zomf -Zmtd you can reduce 
   the size to approx 5 kByte.

   The emx-runtime DLLs are required for the program. These can be
   downloaded from ftp.cdrom.com:/pub/os2/2_x/unix/gnu/emx08g/emxrt.zip.

   The program as well as the sources are public domain, in the sense of 
   the GNU Copyleft (i don't want to blow up the zipfile with all the files
   that must be included with a program that is subject to the GNU Copy-
   left).

   NO WARRANTY: You use this program at your own risk.

   The author: Bernd Esser, Physikalisches Institut der Universit"at Bonn,
               Germany,
               esser@pib1.physik.uni-bonn.de
