home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / HARDDISK / HDTEST1.ZIP / HDTESTSH.EXE / FIXFAT.DOC < prev    next >
Encoding:
Text File  |  1989-11-10  |  6.7 KB  |  126 lines

  1.           
  2.           Documentation for FIXFAT                Copyright 1989, P. R. Fletcher
  3.           _________________________              _______________________________
  4.           
  5.           
  6.                                        INTRODUCTION
  7.                                        ____________
  8.  
  9.           FIXFAT is part of the HDTEST package, and is currently only
  10.           distributed with that software. The program and documentation may only
  11.           be used or copied as part of the HDTEST package. The program allows
  12.           DOS's two on-disk copies of the FAT to be made to correspond, when
  13.           they have got "out of sync". This is required for HDCHEK and HDTEST to
  14.           run. FIXFAT is only intended to be used when something has happened to
  15.           corrupt or alter one copy of the FAT (usually because the second copy
  16.                            ___                                                 
  17.           was only partially updated when a disk write was immediately followed
  18.           by a reboot or use of the "big red switch"). The program cannot repair
  19.           the FAT if both copies have become corrupted, nor is it intended to be
  20.           a replacement for CHKDSK or the more complex disk repair utilities
  21.           that are supplied with (e.g.) the Norton and Mace Utilities (TM).
  22.           Users who have, and are comfortable with, the latter utilities will
  23.           probably find FIXFAT superfluous. It is intended to provide a simple,
  24.           limited, but fairly safe way for less experienced users to correct
  25.           minor FAT problems prior to running HDTEST.
  26.  
  27.           FIXFAT is Copyright by Peter R. Fletcher, 1989. All rights are
  28.           reserved. It was largely written in C, compiled with the Microsoft C
  29.           compiler (V5.1). A few low-level functions were written in assembly
  30.           language and assembled with the Microsoft MASM assembler (V5.1). The
  31.           program was linked with code from the Microsoft C function libraries
  32.           by means of the Microsoft LINK linker (V4.06). It consequently
  33.           contains material that is Copyright by Microsoft Corp, 1985-1988. This
  34.           material is used under the terms of a license from Microsoft Corp.
  35.  
  36.  
  37.                                      USING THE PROGRAM
  38.                                      _________________
  39.  
  40.           You should generally run CHKDSK before running FIXFAT, unless you have
  41.                                           ______                                
  42.           some good reason to believe that the primary copy (and only the
  43.                                                             _____________
  44.           primary copy of the FAT on your disk (FAT 1) has been corrupted. If
  45.           ____________                                                       
  46.           CHKDSK reports any problems other than "orphan clusters", you should,
  47.           if possible, also back up any irreplaceable files on the disk before
  48.           either using CHKDSK with its /F option or running FIXFAT. If both your
  49.           FATs have been damaged (e.g. by a defective program writing junk to
  50.           the FAT area), neither CHKDSK nor FIXFAT will be able to help you, and
  51.           your only hope is to use a disk repair utility such as those provided
  52.           with the Mace or Norton Utilities (TM).
  53.  
  54.           The command line syntax for FIXFAT is:
  55.  
  56.                         FIXFAT dev[:]
  57.  
  58.           "dev" is the single letter DOS device identifier for the device whose
  59.           FAT is to be fixed - the colon is optional. FIXFAT will first read and
  60.           compare the two copies of the FAT on the target disk. If they are
  61.           identical, this fact will be reported and the program will terminate.
  62.           If there are any discrepancies between the two copies of the FAT, the
  63.           program will examine them individually for evidence of corruption. If
  64.           FAT 1 appears valid, you will be prompted for permission to overwrite
  65.           FAT 2 with a copy of FAT 1. If FAT 1 appears invalid but FAT 2 appears
  66.                                                        __                       
  67.           valid, you will similarly be prompted for permission to overwrite FAT
  68.           1 with a copy of FAT 2. If neither FAT appears valid, this will be
  69.           reported and the program will terminate. In determining whether a copy
  70.            
  71.           Documentation for FIXFAT                Copyright 1989, P. R. Fletcher
  72.           _________________________              _______________________________
  73.           
  74.           
  75.           of the FAT is valid, FIXFAT makes similar checks to those performed by
  76.           CHKDSK, except that "orphan clusters" (chains of clusters with no
  77.           corresponding directory entries) are not flagged as problems. The
  78.           occasional appearance of orphan clusters was rather common under
  79.           versions of DOS prior to 3.0, usually following a program abort, and
  80.           these are still not (usually) evidence of major trouble.
  81.  
  82.  
  83.                                LIMITATIONS AND RESTRICTIONS
  84.                                ____________________________
  85.  
  86.           FIXFAT uses the DOS disk interrupts (INT 25 and 26) to access the disk
  87.           - the program will not run on hardware/software combinations that do
  88.           not support the use of these interrupts (this is almost never a
  89.           problem). The program will, however, not run in the DOS compatibility
  90.                                                ___                             
  91.           box under OS/2. FIXFAT requires an amount of free memory (over and
  92.           above that which it uses for its own code) that is equal to at least
  93.           four times the size of the FAT on the target device. For most devices,
  94.           512 kB should be more than enough, but a device whose size pushes DOS
  95.           4.0's limits may be more than the program can handle.
  96.  
  97.  
  98.                                   ADDITIONAL INFORMATION
  99.                                   ______________________
  100.  
  101.           Like all well-behaved programs (!), FIXFAT signals successful
  102.           completion by returning to DOS with the ERRORLEVEL variable set to
  103.           zero. Different small positive values are returned for various errors.
  104.  
  105.           Comments, suggestions, etc. may be addressed to the author at:
  106.  
  107.                    1515 West Montgomery Avenue
  108.                    Rosemont
  109.                    PA 19010
  110.                    U.S.A.
  111.  
  112.           Please enclose a s.a.e. if you would like to receive a reply to a
  113.           question or a response to a comment.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.           
  136.           
  137.                                           Page 2 
  138.