home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / hpfsdt2.zip / readme.txt < prev   
Text File  |  1999-10-16  |  4KB  |  93 lines
  1. HPFSDT.EXE is a program that will toggle the status of an HPFS partition
  2. between "dirty" and "clean".
  3.  
  4. It does this by toggling the first bit of the partition status byte, in the 
  5. HPFS SpareBlock; which is logical byte 8 of logical sector 17.
  6.  
  7. To use this program, you must be using OS/2 version 2.0 or later.  It has
  8. only been tested on OS/2 Warp v4, but does not use any functionality beyond
  9. what's present in OS/2 2.0 (as far as I know).  It will run from a floppy 
  10. boot of OS/2, at least one using the disks created by the "Create Utility 
  11. Disks" program in OS/2.  Make sure that the floppy drive is either in the 
  12. libpath, or the current working drive, as there are some OS/2 DLL's 
  13. required.
  14.  
  15. Why would you use this program?  There are two legitimate reasons that I
  16. can think of:
  17.  
  18. 1)  You are developing something that's crashing your computer often, and
  19.     are tired of waiting for CHKDSK to complete each time you start up.
  20.  
  21. 2)  You are experiencing problems where CHKDSK is unable to complete on a
  22.     drive, and you'd like to try getting your data off before reformatting
  23.     and discovering whether or not the drive is shot (this is the exact
  24.     reason I needed this program myself, causing its creation).
  25.  
  26. It's certainly possible to do what this program does with a sector editor.  
  27. GammaTech's GTDISK program also has an option to toggle the dirty flag on a 
  28. drive.  The former requires knowledge of which byte on which sector to 
  29. modify, and the latter requires the purchase of a commercial software 
  30. package (the GammaTech Utilities 3.0, which is worth buying).
  31.  
  32. This is merely a free and simple alternative, which I wrote because my copy 
  33. of the GammaTech Utilities was located on a drive I couldn't access without 
  34. toggling the dirty bit (see reason number two above).  I'm releasing it 
  35. because I'm quite sure others would find it useful.
  36.  
  37. Usage:
  38.  
  39. hpfsdt.exe <drive letter>
  40.  
  41. <drive letter> - drive letter of the HPFS drive to toggle the dirty bit on
  42.  
  43. Upon running the program, you'll either get an indication of how the dirty 
  44. bit was toggled, or an error message indicating what failed.  The computer 
  45. must be rebooted before OS/2 will read a drive that was booted with the 
  46. dirty flag on.
  47.  
  48. Exit Levels:
  49.  
  50. 1  - Drive changed from "dirty" to "clean".
  51. 2  - Drive changed from "clean" to "dirty".
  52. 3  - Wrong number of arguments, usage displayed.
  53. 4  - Invalid drive string provided.
  54. 5  - Valid string, but invalid drive provided.
  55. 6  - Unable to determine file system type.
  56. 7  - Drive provided does not use HPFS.
  57. 8  - Unable to open drive.
  58. 9  - Unable to lock drive.
  59. 10 - Unable to determine sector size.
  60. 11 - Sector size of zero (invalid) returned by DosDevIOCtl().
  61. 12 - Unable to set file pointer.
  62. 13 - Unable to read from drive.
  63. 14 - Unable to write to drive.
  64. 15 - Memory allocation failure.
  65.  
  66. WARNING:  An improperly stopped HPFS drive often does have minor problems 
  67. that require repair by CHKDSK.  You should not use this program without a 
  68. good reason, as you could potentially aggravate file system problems.  If 
  69. the boot sector of the drive is corrupted, and reports an incorrect sector 
  70. size, the results of running this program are unpredictable.
  71.  
  72. DISCLAIMER:  This program directly modifies your hard drive, and there are 
  73. opportunities for drive corruption to cause incorrect program behavior.  
  74. The author is in no way responsible for any damage whatsoever that the 
  75. program may do.
  76.  
  77. USAGE & DISTRIBUTION:  This program may be used and distributed freely.  No
  78. fee can be charged for this program by anyone.  This does not include the
  79. cost of distribution and media for collections of freeware. All
  80. distributions must include the following files:
  81.  
  82.     1) hpfsdt.exe  - the executable program
  83.     2) hpfsdt.c    - the program source
  84.     3) readme.txt  - the documentation (this file)
  85.     4) file_id.diz - the program description for file listings
  86.     5) comment.arc - the archive comment text
  87.  
  88. The files may be rearchived, but the contents of comment.arc must be
  89. displayed upon extraction.
  90.  
  91. CONTACT:  If you have a comment, question,  or suggestion; address it to 
  92. Mike Ruskai <thannymeister@yahoo.com>.
  93.