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