home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsf / fsck / elim_help < prev    next >
Text File  |  1995-02-05  |  4KB  |  103 lines
  1. eliminate (1.11) - file eliminator!
  2.  
  3. NOTE: this program is SHAREWARE. Read the !SHAREWARE file for more info.
  4.  
  5. eliminate is a disc utility that eliminates a file from the directory but not
  6. from the disc map. This means that the disc space used by the file is lost
  7. (you should recover it using fsck). eliminate can effectively be useful only
  8. to remove the files that cannot be deleted in the usual way by RISC OS (for
  9. example a broken directory). 
  10.  
  11.  
  12. Usage
  13. -----
  14.  
  15. eliminate filename
  16.  
  17.  
  18. Why you could need eliminate
  19. ----------------------------
  20.  
  21. eliminate is one of the programs that you generally don't need to use but that
  22. sometimes can be very helpful. I think that the only use of eliminate is to
  23. delete a broken directory or a non-mapped file that cannot be removed by RISC
  24. OS. After the file or directory has been removed you should run fsck so that
  25. the disc space that was used by it will be relinked in a file. You can
  26. finally remove that file and gain some free space (and finally have a good
  27. map, too!). Generally, all the files that were stored in a broken directory
  28. will be relinked by fsck too but you will not be able to have their original
  29. names and informations back. Anyway, new versions of fsck (from 1.20 onward)
  30. should be able to restore all the subdirectories and their content.
  31. While fsck scans the directory tree, it will tell if there is some file to
  32. eliminate.
  33.  
  34. If you find another use for eliminate I will be really pleased to hear from
  35. you.
  36.  
  37.  
  38. Disclaimer
  39. ----------
  40.  
  41. eliminate is a very dangerous program (since it removes files, corrupts the
  42. map and, obviously, writes to your disc). If you remove an important file and
  43. (for some obscure reason) fsck will not recover its content, I am sorry for
  44. you but I can't do nothing more since you are the only responsible for what
  45. you made!
  46. Actually eliminate is less dangerous than a common 'delete' because if you
  47. eliminate a files, the informations to retrieve it are still stored in the
  48. map and fsck should be able to give you the file back (but you will never
  49. recover its original name); on the other hand a delete will not 'corrupt'
  50. the map while eliminate will make it inconsistent.
  51.  
  52. Summing up: it's not wise to play with eliminate if you have no real reasons
  53. to use it.
  54.  
  55.  
  56. History
  57. -------
  58.  
  59. 1.00   First working version. Tried only on floppies...
  60. 1.01   Some test was done on HardDiscs (all successful). Updated to match
  61.        the changes in the common sources with fsck.
  62. 1.02   Auto-dismount the disc after the file has been eliminated.
  63. 1.10   Completely rewritten in order to keep it up-to-date with the new 
  64.        versions of fsck. This caused a big size reduction (since most of
  65.        the code included in the old one was used only by fsck!). Some more
  66.        check and meaningful messages added.
  67. 1.11   Nothing really new, just linked with a more stable library (see fsck).
  68.  
  69.  
  70. Thanks go to:
  71. -------------
  72.  
  73. - Keith Bailey who was the first who tried eliminate (successfully!) on
  74.   his HardDisc.
  75. - the person who spread on Internet a document describing the E Format
  76.   structure.
  77. - Mohsen Alshayef for his !ArcTools, a very useful utility that allowed
  78.   me to search in the ROM FileCore module for some code...
  79.  
  80.  
  81. Conditions of use
  82. -----------------
  83.  
  84. eliminate can only be distributed with the complete fsck suite.
  85. Read the !SHAREWARE file for the conditions of use and distribution of the
  86. whole package.
  87.  
  88.  
  89. I can be contacted at the following address:
  90.  
  91. Sergio Monesi
  92. Via Trento e Trieste 30
  93. 20046 Biassono (MI)
  94. Italy
  95.  
  96. E-mail address:
  97. pel0015@cdc8g5.cdc.polimi.it
  98. If you don't receive a reply (or if the message is bounced) I can also be
  99. contacted at:
  100. sergio@phantom.com
  101. or:
  102. sergio@g386bsd.first.gmd.de
  103.