SECTORAMA V1.1

TYPED IN BY THE AUTHORS, EDITED BY PARASITE.


    This program is designed to help Amiga users recover lost or damaged
data from floppy or hard drives, or to repair a damaged volume.

   The reason this program was written is because I had six hard-drive
failures over the course of four months (three different units, two
different manufacturers) and several times got myself into situations where
I just HAD to recover a file from a completely scrambled disk. Since none
of the then-current sector editors would work with hard drives, SECTORAMA
was born.

   Note that this is not a cracking program. I don't even know how to
write one of those (disk interfacing was never one of my areas of interest,
I'm basically a graphics and user-interface type).

One other note: Sectorama requires the font TOPAZ-11. Make sure this is
in your current fonts directory or the program won't work.

VERSION 1.1 CHANGES

Bugs Fixed:
   1. All Updates were writing to lowest partition, regardless of what
partition you were editing. This really munged one of my files, and I hope
no one else has suffered the same fate. BAD, BAD David! It's fixed now.
   2. Blocks with keys higher that 7FFF hex weren't being read in.
   3. Open save file was attached to wrong menu item.

New Features (Because I have had yet another crash and needed them)
   1. The "Repair Directory" menu item will re-build the hash table
in a directory block by searching through the entire disk for blocks that
'claim' to be children of that directory. The revised block is not written
to the disk, nor is a new checksum computed. To write the disk, use the
'K' (checksum) and 'U' (update) commands. You can also hand-edit the block
before writing out.
   2. The Compute Hash Function menu item now has a Menu Key Equivalent
(Amiga-H).
   3. There is a "Write all" menu option which writes all the data from the
current block to the save file, then goes to the next data block and does
the same, etc., until the chain ends.

VERSION 1.0 INSTRUCTIONS

How to use Sectorama:

from the CLI, type:

      Sec <device>

   Where <device> is df0:, df1:, dh0:, hd0:, or whatever. SECTORAMA
in it's current form should work with virtually any AmigaDOS device that
has a block size of 512 bytes.
   The program will open up a high-res interlaced screen and displays
what it thinks is the root block for that device. You will notice that
one of the longwords in the block is highlighted. The highlighting can
be moved around with the mouse or arrow keys, allowing you to select any
of the longwords in the block.
   Other information about the current block is displayed around the
various parts of the screen, including block number, file name (if
applicable), track/cylinder number, driver name, unit number, etc.
Not all of these fields are editable in the current version, and some
never will be.
   At the bottom of the page shows 10 numbers labeled 'History'. This
is a list of the last 10 sectors you looked at. In future versions, you
will be able to click on one of these and go to that sector, but this
feature is not implemented yet.
   At the top right is a list of keyboard commands you can enter:

      J) Jump - read in the sector number indicated by the contents of
the currently selected longword.
      R) Root - go to the root block.
      P) Parent - go to this sector's parent, if possible.
      C) Chain - go to the next sector on the hash chain, if possible
      X) Extention - go to this block's extention block, if possible.
      H) Header - go to the Header of this data block.
      D) Data - Go to the next data block (if you are at the header block
         of a file, it goes to the first data block).
      L) Show the results of the last sector search (see below)
      E) Edit, in hex, the contents of the sector. you may type values
         in directly. ESCAPE key returns to normal mode.
      A) ASCII Edit, same as Edit, but in ASCII rather than hex.
      K) Compute new checksum for this block.
      U) Update - write this block back to the disk. (note: must be
         a CAPITAL 'U').
      W) Write the data portion of this block to the save file (see below)

   Sector Search -
      The Sector search pull-down menu allows you to search the entire
volume, sector by sector, looking for certain criteria. The criteria can
be:
      1) Filename with wildcards.
      2) Parent block.
      3) Header block.

   Thus, you can search for all files that fit the pattern "*.c", or
all files that have a parent of 409. This is useful for finding sectors
that have become 'de-linked' from the AmigaDOS filing system.

   The output of the search looks just like a regular sector filled with
sector keys - you can use the JUMP command to go to any of those keys.
The result of the search is not destroyed by this action and can be
brought up later using the option 'Last Search'.

   Save File -
      You can open a save file on another disk and save the DATA PORTION
of any sector onto it. Each write is appended onto the last, thus if your
file is TOTALLY trashed, you can at least get parts of it back (the parts
you can find).
   Use the 'Open' pull down menu to open the file and the 'Close' to
close it. The 'W' key writes the current sector to the save file.
   I have not tested this function, so be careful with it.

   Verify and Repair -
      These functions aren't finished yet. Eventually they will perform
DiskDoctor-like functions, except under close user control.

   Compute Hash Function -
      This pull-down menu allows you to type a file or directory name,
and it will set the position of the highlighted region based on the
hash value of that name. Then, all you need do is hit 'J' (Jump) to go
to the hash chain containing that block, and hit 'C' (Chain) until you
get to the entry you want.