###   #  #  ###
#  #  # #    #
#  #  ###    #
###   #  #  ###    Version 1.9, by Philippe Duby, December 5, 1993




I / Purpose of DKI
==================

   DKI (for DisK Information) was initially designed to give a clear
view of your drives free disk space. A good place for it is within
AUTOEXEC.BAT file.

   It was then completed by a more sophisticated analyse of the disk units,
detailling the type (hard disk, network , ...) with technical information 
if available (details about partitions, cd-rom tracks, ...) and
physical information (for IDE, SCSI, CDROM disks).

   Finally, it was extended to recursive file and directory management :
you can count, find and delete files and directories.

   To get a summary of it's possibilities, type DKI /?.

   This software is distributed as shareware. This means that you can use 
it and test it for 30 days, but you have to register if you are using
it regularly. The registration fee is only US$ 10, so it's cheap for you
but it will encourage me for the next DKI ... (see chapter VII).



II / Technical details
======================

1) Identified programs
----------------------

- Operating systems : DOS, DR-DOS, Windows, DesqView.
- Disk compression : Stacker, Superstor, Double Disque, DoubleSpace.
- Networks : Novell Netware Lite, 2.2, 3.11, PairWare, PC LAN,
  LanSmart, Lan Manager, Lantastic, Workgroups, PC-TCP.
- Disk-cache software : SmartDrive 4+, Pc-cache 8+,
  Norton Cache 5, 6 et 7 (Ncache2).


2) Identified disk units
------------------------

   Floppy, Hard disk, ram-disk, compressed disk, SCSI syquest, CDROM,
network, remote units (DRIVEMAP, INTERLINK), substitued units.


3) Collected physical data
--------------------------

   IDE disk's name, partitions, SCSI units (via ASPI), CDROM tracks.




III / Use examples
===================

1) Global units state
---------------------

=> DKI

   All units state.

=> DKI C: D:

   State of specified units.



2) Technical information
------------------------

=> DKI /p

Note : if you have more than 25 lines of information, try :

=> DKI /pm

Note : DKI can give you details even about non formated IDE disks, or IDE
disks with a format different than DOS. It can handle 2 controllers.



3) Full information
-------------------

=> DKI /v    (or /vm)

Note : in this mode, DKI counts all your files and directories, and
this operation may take a long time. Just press 'Esc to abort it.



4) Information about disks, directories
---------------------------------------

=> DKI c:\.
   DKI \windows


Note 1 : you can mix commands :

   DKI c: d:
   DKI c:\dos c:\windows d:

Note 2 :  if you just want to study your PATH directories :

   DKI /e



5) Summary by directories
-------------------------

=> DKI \windows /0

   Lists all the sub-directories from \windows, detailing the number of
   files inside, and the size occupied by the directory on the disk.

=> DKI C:\ /1

   Lists all the first-level directories of drive C:

=> DKI d:\*.gif /1 (ou 2 ou 3)

   Lists all the directories of level 1, 2 or 3, containing .GIF files.

Note : you can work on all your drives with a single command :

=> DKI $:*.exe /1

   Lists the directories containing programs for all your drives.



6) Files information
--------------------

=> DKI c:\dos\*.exe

   Lists all the programs inside C:\DOS, specifying their date and size.

=> DKI c:\windows\*.dll /0

   Lists all Windows's DLL, and displays their total size by directory.



7) Deleting a directory or a set of files
-----------------------------------------

=> DKI c:\windows /d

   Deletes completely a 'thing' called Windows !

=> DKI $:*.swp /d

   Deletes all the files with extension SWP of all your drives.

Note : if DKI encounters a read-only file, it ask you for confirmation
   before deleting it..

Note 2 : you can create a DOSKEY macro : DOSKEY XDEL = DKI $* /D.




IV / List of all DKI's commands
================================

/0 : lists all the directories scanned during a file search.
/1,2: same as above, but for directories before level 1 or 2

/a : displays with ASCII 7 bits filter and no color, to allow
     for example the storing into a BBS message.

/d : Delete mode, to delete recusively directories and files specified
     Be careful with this command, because the deletion is quite fast,
     so you have no time to have regrets after it is started !

/g : dbuGing information (for me).

/e : scans the directories of the DOS PATH variable.

/i : makes DKI's installation easier, by looking for an appropriate 
     location where to copy DKI, and by updating your AUTOEXEC.BAT file
     to add DKI and an XDEL macro.

/m : switches to Maxline mode (50 lines).

/p : Physical information.

/v : Verbose mode.

/* : Full-information mode.


Note : if you want to print DKI results, you have to redirect the
standard output on a file, and then print this file
Example : DKI /p > DKI.TXT    then COPY DKI.TXT PRN




V / Display description
========================

DKI 1.83 by Philippe Duby (c)93
Running under DOS 5, Stacker 3, Netware 3.11, SmartDrive 4.1
                                             
                         Release of elements 
                        identified by DKI  


 Drive information 

                                      Used  Free    Total
C: Hard disk 1 𱱱------   19 +   8 =  28 Mb  C:\
D: Stacker 1.5 𱱱-  351 +  23 = 375 Mb  D:\PDEV
E: Hard disk 1 𱱱  286 +  12 = 299 Mb  E:\TMP
F: Syquest     𱱱---------   41 +  44 =  85 Mb  F:\
G: Subst D:    𱱱-   20    /    375 Mb  D:\SBPRO
L: Netware   1 𱱱---  209 +  46 = 255 Mb* DEV\VOL1:\
: Total-Host  𱱱--  623 +  90 = 713 Mb  Phys= 327, Net=255
                                                     
Unit                                                   Current
type                                                  directory
                  bar display of                 
Unit n        disk space                    total size
                                              
                      occcupied space        free space

Notes :
1) In case of Stacker drive, the compression rate is displayed (1.5), and
   the total disk size is the real size (and not the theorical which is
   usually the normal size multiplied by 2).

2) For substitued drives, the size occupied by the real drive is displayed
   in grey color.
   
3) At the end of the total line, Phys indicates the real physical size,
   and Net the real size accessible by network.

4) Total-host means the total size minus the size occupied by all the host
   files containing a compressed disk.



 File & directory information 

              Files  Dir          Used   %          Free   %         Total
C:\*.*          656   10    20,652,032  70     8,730,624  29    29,384,704
D:\*.*        7,932  283   369,008,640  93    24,436,736   6   393,445,376
E:\*.*          380   15   300,474,368  95    13,262,848   4   313,876,480
E:\*.*          184   20    42,843,521  48    45,953,412  52    88,313,841
G:\*.*          259   13    21,372,928   5    24,436,736   6   393,445,376
L:\*.*        1,927  100   219,783,431  82    48,648,192  18   268,431,360
:\          11,154  421   910,059,520  69    95,078,400  31 1,005,137,920
                                                                     
Analysed   Nb of                                                     
files      Files           Space used by        Free space      Total size
               Directories     the files

 Physical information 

                Cyl.Hd.ST    Total  Description
Floppy 1     :   80. 2.18  1.44 Mb 
Floppy 2     :   80. 2.15  1.20 Mb 
Hard disk 1  :  700.16.60   328 Mb 
 Part    1.1 :   60.  .      28 Mb  DOS 16 bits (Active) (  9%)
 Part    2.1 :  639.  .     299 Mb  DOS Extended ( 91%)
IDE disk     :  700.16.60   328 Mb  T 6D8C X 0
SCSI Host 1  :                      T7   ADAPTEC AHA-1520 (ASW-1210 Ver 3.1)
 Disk        :   85.64.32    85 Mb  T3L0 SyQuest SQ5110   (SCSI-1)
Net volume   :              344 Mb  DEV\VOL1 (100%)
CD-ROM       :   77'34''    682 Mb  ARTSHOW91B (status = 07B6)
 Track  1    :   68'42''    604 Mb  Data
 Track  2    :    2'05''     18 Mb  2 Audio channels
                                 
Physical name                     
  Nb of cylinders                  Description
  or minutes                
         Nb of heads         Total size
         or secondes    
Nb of sectors by tracks


Total mem    :    8 Mb
Total disk   :  412 Mb
Total net    :  344 Mb
Total cdrom  :  682 Mb

Cache stats  : 2048 Kb for Dos,  2048 Kb for Windows, Success ratio = 73%
                                                             
              Data found in the cache /Total of cache access 


Notes :
1) For Novell Netware, the total size may be greater than the size
   reported by DOS (because Novell can handle big clusters).
2) The partition are described by 2 numbers : the partition table number,
   and the entry number in this table.




VI / Historic
=============

1.00 (11/92)
------------
- 1st version, which displays free disk space of all drives.
- Name : DFREE (Disk FREE space).

1.01 (01/93)
------------
- Correction of various bugs.

1.02 (02/93)
------------
- Various improvements.

1.03 (02/93)
------------
- Can collect information about files and directories.
- New name, adapted to the new functionalities : DDSIZE.

1.04 (03/93)
------------
- Verbose mode added.

1.05 (03/93)
------------
- Can delete files and directories.

1.06 (04/93)
------------
- Improvements ...
- New name, simplier : DKI
- Cration of a documentation.

1.07 (04/93)
------------
- 7 bits display mode.
- Cration of the pseudo-unit $, corresponding to 'all units'.
- IDE disk identification.
- Partitions informations.
- Rounding routines to display Kb and Mb.
- SCSI access via ASPI interface.

1.08 (07/93)
------------
- Analyse of CDROM disks.
- Details about cache software.

1.81 (08/93)
------------
- Version 1.80 = 1.08
- Correction of some bugs ...

1.82 (09/93)
------------
- If the command line contains files reference (*.C, WIN*.*, ...),
  DKI displays informations on them (directory, date, size),
  to allow file search.
- Display the number of directories scanned during a search.
- handle international attributes (sparator for thousand,
  order of date, help text (/?) in english).
- New documentation.
- Installation module.
- Better management for SCSI disks via ASPI .
- Improvement of deletion routines.
- New routines for IDE detection (functions as IDEID).

1.9 (11/93)
------------
- Identify IDE/ESDI units installed on a secondary controller.
- English documentation for shareware version.


Projects (??/93)
---------------
- Version 2.0 for Dos and  Windows.



Thanks
------

- Analyse, ideas, advices, help : Jean-Daniel Pauget.

- Technical advices :
* Ralph Brown (Interrupt List)
* Henry-Pascal Eldin (LanSmart)
* Doug Merrett (IDE disks)
* Bruno Sirletti, Michel Cerdini (SCSI disks)

- Betatesters : Lionel Drevon, Bruno Lassausaie, Georges
  Bourne (sysop of GEORGE'S HOME), Franois Heizmann (LL),
  Pascal Valette (sysop of LE LIEN), Henry-Pascal Eldin (LL),
  Cyril MORISSE (sysop of LOKI), Patrick Kuchard, Harold Ovsec (GH),
  Alain Gazet, Ivan Clement (GH), Vincent Mallet (Sysop of ZYLLIUS),
  Philippe Debray (ZY), Jean-Louis Matrat (ZY), Dominique
  Klein (ZY), Pascal Richard (GH), Serge Chenavard (GH),
  Luc Blateau (GH), ...





VII / Contacts
==============

If you want to register, send me a note of 10$ (or the equivalent in your
country money) to the following address. Registering will bring you access
to the latest version, and possibly explanations about how works DKI if 
you are interested in.

If you want to help me to improve this program, you can send me the results
of your tests (by creating a report file with DKI /G >DKI.TXT),
your remarks and suggestion, and any information (documentation, listings,
...) that you could have about peripherals detection and so on ...


Thanks a lot in advance !

Address :
---------

Philippe Duby
7 rue Jules Valls
69100 VILLEURBANNE
France


COMPUSERVE      : 73551,1561

INTERNET        : jdpauget@zen.gatelink.fr.net

FIDONET address : 2:323/4 (George's Home)


You can also reach me on the following BBS :

- GEORGE'S HOME : (33) 78.21.96.65 
(busy between 2h30 - 6h30 local time)
DKI is available under the magic name DKI.

- LE LIEN       : (33) 72.08.98.79
- ZYLLIUS       : (33) 93.32.07.20
