home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / MAPDISK3.ZIP / MAPDISK.DOC next >
Text File  |  1988-10-02  |  7KB  |  153 lines
  1.  
  2.     MAPDISK     Release 3.00    by  M. T. Callahan
  3.  
  4.     Copyright (c) 1987, 1988  --  All rights reserved
  5.  
  6.     Purpose   This program maps all allocated, and unallocated, extents
  7.               for a disk (either floppy or hard).  The resulting report
  8.               shows ownership of each extent and its starting and ending
  9.               position on the disk.  The report is written to a user
  10.               specified file.
  11.  
  12.     Command format
  13.  
  14.               MAPDSK3x d: [<filespec>] [/F nnnn] [/L nnnn] [/E nnnn]
  15.  
  16.                    where x   is D for the DOS version
  17.                              and O for the OS/2 version
  18.                          d:  is the drive to be mapped; there is no
  19.                              default for drive
  20.  
  21.                          <filespec>    is a file specification for the
  22.                              output report; default is MAPDSK_d, where
  23.                              d is the drive being mapped.  When specified
  24.                              this MUST be the second parameter.
  25.  
  26.                          /F nnnn  used to override the default maximum
  27.                              for the number of files that may be processed.
  28.                              Default is 5000.
  29.  
  30.                          /E nnnn  used to override the default maximum
  31.                              for the number of disk extents that may be
  32.                              processed.  Default is 8192.
  33.  
  34.                          /L nnnn  used to override the default maximum
  35.                              for the number of file/extent connections
  36.                              that may be processed.  Default is 10000.
  37.  
  38.     Remarks
  39.               Although a number of other programs have the capability
  40.               of mapping a disk, few, if any, show detail down to the
  41.               single cluster level.
  42.  
  43.               This release consists of two (2) programs, and this
  44.               documentation file.  MAPDSK3D.EXE is intended for use
  45.               in the PC-DOS environment, and MAPDSK3O.EXE is intended
  46.               for use in the OS/2 (protected mode) environment.
  47.  
  48.               This program is intended to be run on an IBM (or very near
  49.               clone) PC. To date it has been tested on the IBM XT, AT,
  50.               and PS/2 model 60.  It has been tested using both PC-DOS
  51.               2.x and 3.x operating systems, and the OS/2 1.0 operating
  52.               system.
  53.  
  54.               The DOS version of this program uses INT 25 to do absolute
  55.               sector READS.  As a result it will not work in the OS/2
  56.               compatability box, however, since a protected mode OS/2
  57.               version of the program is included, this should not be
  58.               a problem.
  59.  
  60.               Both programs are capable of mapping both floppy disks
  61.               and hard disks equally well, however, they are most useful
  62.               for mapping hard disks.
  63.  
  64.               At this time, neither program supports single disk partitions
  65.               of more than 32 Megs.  I will release a version that can
  66.               handle DOS 4.0's large disk partitions as soon as possible.
  67.               Since these programs obtain all of their disk information
  68.               from the boot record, they will not work on versions of DOS
  69.               or OS/2 that use non-standard boot records.
  70.  
  71.  
  72.               Memory Requirements:
  73.  
  74.                    45K + D + F + E + L + O
  75.  
  76.                         where:
  77.                              D    is Directory buffers
  78.                                   -  must be large enough to hold all
  79.                                      directories in longest path
  80.  
  81.                                   -  each 512 directory entries requires
  82.                                      16K of memory
  83.  
  84.                                   -  minimum directory size is one
  85.                                      cluster
  86.  
  87.                              F    is 29K per 1000 files
  88.  
  89.                              E    is 12K per 1000 extents
  90.  
  91.                              L    is 10K per 1000 file/extent connections
  92.  
  93.                              O    the OS/2 version is about 2K larger
  94.                                   and will need additional space for the
  95.                                   API functions used
  96.  
  97.  
  98.               Disk statistics for files and directories will differ from
  99.               those returned by CHKDSK in the following ways:
  100.  
  101.                    -  MAPDISK does not consider the Volume id to be a
  102.                       file since it only uses a directory entry and not
  103.                       an extent
  104.                    -  The number of directories reported by MAPDISK will
  105.                       usually be one more than CHKDSK since MAPDISK
  106.                       reports the root directory as a directory, CHKDSK
  107.                       ignores it
  108.                    -  MAPDISK reports all files (SYSTEM, HIDDEN, etc)
  109.                       in one category, CHKDSK differentiates between
  110.                       Hidden and non-Hidden files.
  111.  
  112.  
  113.     Disclaimer
  114.               This program is supplied AS IS. The author does not
  115.               warranty that the program will work as designed on your
  116.               particular system.  The author will not be liable for any
  117.               damages of any kind sustained though the use of this
  118.               program on your system.  Your use of this program
  119.               constitues acceptance of these terms.
  120.  
  121.               This program is intended for the user's personal use.
  122.  
  123.               You may make copies of the program and documentation
  124.               for yourself and others, provided no fee is charged.
  125.               An exception is made for PC USER'S GROUPS which may
  126.               charge a small amount (not to exceed $6) for handling
  127.               and copying.
  128.  
  129.               Although, the author does allow the user to copy this
  130.               program and documentation to pass on to others.  It is
  131.               hoped, that if the user does find this program usefull,
  132.               the user will be willing to send the author $10 for the
  133.               program to help will future development of this product.
  134.  
  135.  
  136.               Comments and suggestions are always welcome.
  137.  
  138.                        M. T. Callahan
  139.                        1565 Holly Ave
  140.                        Rohnert Park, Ca 94928
  141.  
  142.  
  143.  
  144.     Version History
  145.         1.0   1 Oct 1987  -  Internal version - proof of concepts
  146.         2.0  20 Dec 1987  -  First version released to users
  147.         3.0  30 Sep 1988  -  Corrected minor bug that caused program to loop
  148.                           -  Recoded a number of alogrithms in effort to
  149.                              speed-up processing
  150.                           -  OS/2 protected mode version added
  151.                           -  Added cmd line switches: /F, /E, /L
  152.                           -  Detects more disk and FAT problems than 2.0
  153.