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