home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 085.lha / sec.doc < prev    next >
Text File  |  1986-11-20  |  8KB  |  162 lines
  1. ***************************************************************************
  2. *                            SECTORAMA V1.1                               *
  3. *                          Disk Sector Utility                            *
  4. *                      By Talin a.k.a. David Joiner                       *
  5. *                                                                         *
  6. *  IMPORTANT NOTE: This program is freely copyable and distributable,     *
  7. *  courtesy of David Joiner and MicroIllusions. It is NOT Public Domain.  *
  8. *  All copyrights are reserved by the author. You may give copies of this *
  9. *  program to anyone you wish but you may not sell it.                    *
  10. *                                                                         *
  11. ***************************************************************************
  12.     This program is designed to help Amiga users recover lost or damaged
  13. data from floppy or hard drives, or to repair a damaged volume.
  14.  
  15.               ***** The Obligatory Gratitude Clause *****
  16.  
  17.     If you like this program and find it useful and worthwhile, you
  18. can do one of several things.
  19.     1) You can do absolutely nothing. That's OK.
  20.     2) If you are a developer, you can send be something you have done or
  21. are working on. I would like that very much.
  22.     3) If you are not a developer, but have lots of neat public domain
  23. software, you could send me something neat. Don't send me anything pirated
  24. or I'll just erase it.
  25.     4) If all else fails send me a thank-you note or other comments.
  26.  
  27.     My Address is:
  28.         David Joiner
  29.         17428 Chatsworth
  30.         Granada Hills, CA 91344
  31.  
  32.     Don't send me any money. I don't have time to run a business, and it's
  33. really not worth the effort. I make enough money writing other kinds of
  34. software (games, creative tools) and we just aren't set up to market
  35. any kind of programming utilities (different kind of tech support, etc).
  36.  
  37.     The reason this program was written is because I had six hard-drive
  38. failures over the course of four months (three different units, two
  39. different manufacturers) and several times got myself into situations where
  40. I just HAD to recover a file from a completely scrambled disk. Since none
  41. of the then-current sector editors would work with hard drives, SECTORAMA
  42. was born.
  43.     Note that this is not a cracking program. I don't even know how to
  44. write one of those (disk interfacing was never one of my areas of interest,
  45. I'm basically a graphics and user-interface type).
  46.  
  47. One other note: Sectorama requires the font TOPAZ-11. Make sure this is
  48. in your current fonts directory or the program won't work.
  49.  
  50. ***************************************************************************
  51. * Version 1.1 Changes                                                     *
  52. ***************************************************************************
  53.  
  54. Bugs Fixed:
  55.     1. All Updates were writing to lowest partition, regardless of what
  56. partition you were editing. This really munged one of my files, and I hope
  57. no one else has suffered the same fate. BAD, BAD David! It's fixed now.
  58.     2. Blocks with keys higher that 7FFF hex weren't being read in.
  59.     3. Open save file was attached to wrong menu item.
  60.  
  61. New Features (Because I have had yet another crash and needed them)
  62.     1. The "Repair Directory" menu item will re-build the hash table
  63. in a directory block by searching through the entire disk for blocks that
  64. 'claim' to be children of that directory. The revised block is not written
  65. to the disk, nor is a new checksum computed. To write the disk, use the
  66. 'K' (checksum) and 'U' (update) commands. You can also hand-edit the block
  67. before writing out.
  68.     2. The Compute Hash Function menu item now has a Menu Key Equivalent
  69. (Amiga-H).
  70.     3. There is a "Write all" menu option which writes all the data from the
  71. current block to the save file, then goes to the next data block and does
  72. the same, etc., until the chain ends.
  73.  
  74. ***************************************************************************
  75. * Version 1.0 Instructions                                                *
  76. ***************************************************************************
  77.  
  78. How to use Sectorama:
  79.  
  80. from the CLI, type:
  81.  
  82.         Sec <device>
  83.  
  84.     Where <device> is df0:, df1:, dh0:, hd0:, or whatever. SECTORAMA
  85. in it's current form should work with virtually any AmigaDOS device that
  86. has a block size of 512 bytes.
  87.     The program will open up a high-res interlaced screen and displays
  88. what it thinks is the root block for that device. You will notice that
  89. one of the longwords in the block is highlighted. The highlighting can
  90. be moved around with the mouse or arrow keys, allowing you to select any
  91. of the longwords in the block.
  92.     Other information about the current block is displayed around the
  93. various parts of the screen, including block number, file name (if
  94. applicable), track/cylinder number, driver name, unit number, etc.
  95. Not all of these fields are editable in the current version, and some
  96. never will be.
  97.     At the bottom of the page shows 10 numbers labeled 'History'. This
  98. is a list of the last 10 sectors you looked at. In future versions, you
  99. will be able to click on one of these and go to that sector, but this
  100. feature is not implemented yet.
  101.     At the top right is a list of keyboard commands you can enter:
  102.  
  103.         J) Jump - read in the sector number indicated by the contents of
  104. the currently selected longword.
  105.         R) Root - go to the root block.
  106.         P) Parent - go to this sector's parent, if possible.
  107.         C) Chain - go to the next sector on the hash chain, if possible
  108.         X) Extention - go to this block's extention block, if possible.
  109.         H) Header - go to the Header of this data block.
  110.         D) Data - Go to the next data block (if you are at the header block
  111.             of a file, it goes to the first data block).
  112.         L) Show the results of the last sector search (see below)
  113.         E) Edit, in hex, the contents of the sector. you may type values
  114.             in directly. ESCAPE key returns to normal mode.
  115.         A) ASCII Edit, same as Edit, but in ASCII rather than hex.
  116.         K) Compute new checksum for this block.
  117.         U) Update - write this block back to the disk. (note: must be
  118.             a CAPITAL 'U').
  119.         W) Write the data portion of this block to the save file (see below)
  120.  
  121.     Sector Search - 
  122.         The Sector search pull-down menu allows you to search the entire
  123. volume, sector by sector, looking for certain criteria. The criteria can
  124. be:
  125.         1) Filename with wildcards.
  126.         2) Parent block.
  127.         3) Header block.
  128.  
  129.     Thus, you can search for all files that fit the pattern "*.c", or
  130. all files that have a parent of 409. This is useful for finding sectors
  131. that have become 'de-linked' from the AmigaDOS filing system.
  132.  
  133.     The output of the search looks just like a regular sector filled with
  134. sector keys - you can use the JUMP command to go to any of those keys.
  135. The result of the search is not destroyed by this action and can be
  136. brought up later using the option 'Last Search'.
  137.  
  138.     Save File -
  139.         You can open a save file on another disk and save the DATA PORTION
  140. of any sector onto it. Each write is appended onto the last, thus if your
  141. file is TOTALLY trashed, you can at least get parts of it back (the parts
  142. you can find).
  143.     Use the 'Open' pull down menu to open the file and the 'Close' to
  144. close it. The 'W' key writes the current sector to the save file.
  145.     I have not tested this function, so be careful with it.
  146.  
  147.     Verify and Repair -
  148.         These functions aren't finished yet. Eventually they will perform
  149. DiskDoctor-like functions, except under close user control.
  150.  
  151.     Compute Hash Function -
  152.         This pull-down menu allows you to type a file or directory name,
  153. and it will set the position of the highlighted region based on the
  154. hash value of that name. Then, all you need do is hit 'J' (Jump) to go
  155. to the hash chain containing that block, and hit 'C' (Chain) until you
  156. get to the entry you want.
  157.  
  158.     Good Luck!
  159.                   ____
  160.                    /__ /-
  161.                   //-////\/
  162.