home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / ENTERPRS / CPM / UTILS / S / UNDELETE.LBR / UNDELETE.DZC / UNDELETE.DOC
Text File  |  2000-06-30  |  5KB  |  105 lines
  1.                                  UNDELETE.COM
  2.                          A SMART FILE UNDELETE UTILITY
  3.                                By Guy Cousineau
  4.                                   1989-08-27
  5.  
  6. UNERA.COM was a welcome addition to the CP/M public domain and was very useful 
  7. in recovering accidentally deleted files.  It had, however, a few drawbacks in 
  8. that it allowed unerasing files which would duplicate entries already in the 
  9. current DU and unerased files which overlapped the same allocation blocks as 
  10. other active files.
  11.  
  12. Hence the creation of UNDELETE.COM.  This utility works in the following 
  13. fashion:
  14.  
  15. 1    find all deleted files
  16. 2    mask out files with no EXTENT 0 (incomplete)
  17. 3    mask out files with allocation overlaps
  18. 4    mask out files with the same name as active files (slow part)
  19. 5    prompt for tagging of files to recover
  20. 6    undelete the tagged files
  21.  
  22. SYNTAX:    UNDELETE [d:]
  23.  
  24.                              DETAILED EXPLANATIONS
  25.  
  26. 1
  27. If no drive is specified the current drive is used.  The program LOGS IN the 
  28. selected drive and finds the directory size.  Each directory record is read and 
  29. scanned for deleted files, building table entries in RAM for each found file.  
  30.  
  31. 2
  32. Print first report skipping all entries corresponding to further extents of a 
  33. file.  This fashion of reporting effectively masks out large files for which 
  34. extent 0 has been overwritten but other extents still exist in the directory.
  35.  
  36. 3
  37. The table is re-scanned and each allocation block checked against a copy of the 
  38. allocation vector.  If there is overlap, the file flag is set to disable 
  39. recovery.  If the allocation is unused, it is set to used to prevent recovery 
  40. of other files which may use the same allocation.  A second report is then 
  41. printed.
  42.  
  43. 4
  44. Check the current drive/user for matches of the deleted files remaining in the 
  45. table.  These files may be undeleted later if the corresponding active file is 
  46. renamed.  A third report is then printed showing only the files which are safe 
  47. to undelete.
  48.  
  49. 5
  50. Print the files out one by one and ask the user to tag them with a 'u' or a 
  51. 'U' for UNDELETE.  After the files are tagged, the user is asked for 
  52. confirmation:  a 'u' proceeds and a CONTROL-C aborts.
  53.  
  54. At every stage of the analysis, a printout is given of the FILES FOUND SO FAR.  
  55. This way, you can see those files you want to recover but might be unable to 
  56. because of internal conflicts.  If at any time, the number of recoverable files 
  57. becomes 0, the program aborts.  To manually abort the undelete process, press 
  58. CONTROL-C at any prompt.
  59.  
  60.                               USE CONSIDERATION
  61.  
  62. Although this utility is smarter than UNERA.COM it can fail if a file with 
  63. more than one directory entry is missing its second entry.  Under normal 
  64. directory operations, this is an impossible situation since directory entries 
  65. are filled in from the start of the directory.  Thus if extent 1 is missing 
  66. then extent 0 must be missing as well.
  67.  
  68. The ALLOCATION overlap can also fail if a sort-and-pack program was used to 
  69. re-order the directory entries.  Under normal operations, it is impossible for 
  70. the second of 2 deleted files (using the same allocation blocks) to be the 
  71. UNDELETEABLE one.  With SAP, there is no way of accurately determining which 
  72. file can be undeleted.
  73.  
  74. If there are 2 copies of the same deleted file, they will show up as 2 entries 
  75. in the TAG menu.  To recover both and check which is the most current, start 
  76. by tagging only one version and rename it to another UNUSED name.  Run 
  77. UNDELETE again and tag the second version.  Check them both out and delete the 
  78. one you don't want to keep.
  79.  
  80. Although UNDELETE is smarter than UNERA, you should verify all recovered files 
  81. before using.  Particularly in the case of .COM files, it is wise to tread 
  82. safely with back-up disks when testing the recovered file.
  83.  
  84. Since UNDELETE recovers files to the current user area, you should select the 
  85. user number which is appropriate to the recovery attempt.  Hey, you can even 
  86. use UNDELETE to move a file from one user to the next by deleteing it from one 
  87. area, logging into another user, and undeleteing it.
  88.  
  89. The utility has been tested on a CP/M 2.2 system and should behave correctly 
  90. on any Z-80 CP/M 2.x.  It has been tested with 1,2, and 4 K allocation blocks 
  91. on media with 1 and 2 byte allocations.  Although it has performed with no 
  92. problems on these media, it is not guaranteed to work in non-standard 
  93. environments.  Since I have not been able to test it on CP/M 3.x or CP/M plus, 
  94. the operation on those systems has been disabled.  The utility will only run on 
  95. a BDOS which reports a "2?" HEX when asked for version.  See the notes near the 
  96. end of the first page to disable check for CP/M 2.x
  97.  
  98.  
  99. Use the program in good health, please send bug reports to:
  100.  
  101. Guy Cousineau
  102. 1059 Hindley Street
  103. OTTAWA Canada
  104. K2B 5L9
  105.