home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / dskstruc / showf241.arj / SHOWFAT.DOC next >
Text File  |  1991-01-02  |  8KB  |  176 lines
  1.      SHOWFAT Version 2.41 - Copyright 1987,1988,1990 D.J. Murdoch
  2.  
  3.      This program is shareware.  See the license discussion below.
  4.  
  5.           SHOWFAT graphically displays the physical layout of the
  6.      files on your disk.  I use it for several things.  First and
  7.      foremost, it's a tool that lets me look at my disk and satisfy my
  8.      curiosity about what's going on in there.  It's easy to see when
  9.      the disk is getting badly fragmented and needs to be run through an
  10.      optimizer; it's also handy in a multitasker like Desqview, to watch
  11.      the results of programs that are writing long output files but
  12.      haven't closed them; it's sometimes helpful when automatic unerase
  13.      utilities can't successfully retrieve a lost file. Version 2.41
  14.      does a CHKDSK-style integrity check on the disk, and reports errors
  15.      in a slightly more friendly format.
  16.  
  17.      Unless it needs to use a disk for virtual memory (in which case it
  18.      uses the disk it was started from), SHOWFAT never writes to disk.
  19.      It should be a perfectly safe and non-destructive way to explore
  20.      what's there.
  21.  
  22.      Run it by typing "SHOWFAT drive".  Once running, use the arrow keys
  23.      to move the pointer around and get information about any cluster on
  24.      the disk.  Symbols used include:
  25.  
  26.                        ∩ - file complete in 1 cluster
  27.                      ┌─┐ - multi-cluster contiguous file
  28.                 (arrows) - indicate fragmented files
  29.                        σ - start of erased file
  30.                        ∙ - cluster not in use
  31.                        B - bad cluster
  32.  
  33.           The top line gives the cluster number, the first sector number
  34.      and, if the cluster is in use, the path to the owner.
  35.  
  36.           The arrow keys (and Home, End, PgUp, and PgDn) cause physical
  37.      moves when used plain.  When shifted or Alt'd, or when the
  38.      corresponding number key is pressed, logical moves according to the
  39.      directory structure are made:
  40.  
  41.              Shifted Key     Number      Action
  42.  
  43.                 Left           4         Previous cluster in file
  44.                 Right          6         Next cluster in file
  45.                 Up             8         Previous file in directory
  46.                 Down           2         Next file in directory
  47.                 Home           7         First cluster in file
  48.                 End            1         Last cluster in file
  49.                 PgUp           9         Parent directory
  50.                 PgDn           3         First file in subdirectory
  51.  
  52.           The following keys are used for commands:
  53.  
  54.       A - Toggle Ascii window.  This window shows the contents of the
  55.           current cluster on the disk.  The offset (in bytes, printed in
  56.           decimal) from the start of the file to the start of this cluster
  57.           shown.  Note that the windows are "tiled", not "layered", so none
  58.           of the FAT window will be hidden.
  59.  
  60.       Tab - Toggle cursor window.  If you have the Ascii or Hex window
  61.           open, this toggles between having the cursor move in units of
  62.           clusters in the FAT window and moving in units of bytes in the
  63.           data window.
  64.  
  65.       D - Change Drive.  Starts over on a new drive.  Also used if you want
  66.           to switch floppy disks in the same drive.
  67.  
  68.       F - Find file.  You'll be prompted to enter a filename, and the
  69.           cursor will be moved to the start of that file.  Don't use a
  70.           drive designator (e.g. A:), since only files on the currently
  71.           displayed drive are going to be shown.  You can skip the path,
  72.           and SHOWFAT will find the file in its version of the "current
  73.           directory", which varies slightly from DOS's.  If no filename is
  74.           displayed at the top of the screen (because your cursor is on a
  75.           cluster that's not in any file)  then it'll use DOS's current
  76.           directory.  If it's pointing at a file or an empty subdirectory,
  77.           it'll use the parent directory.  If it's pointing at any other
  78.           subdirectory, that's the current directory.  (It's easier to use
  79.           than to describe.)
  80.  
  81.       H - Toggle Hex window.  This window shows the contents of the current
  82.           cluster in hex bytes.  Again, the offset is shown.
  83.  
  84.       N - Go to start of next file fragment
  85.  
  86.       P - Go to start of previous file fragment
  87.  
  88.       <Space> - Go forward to next free cluster
  89.  
  90.       <Bksp>  - Go backward to previous free cluster
  91.  
  92.  
  93.      ESC - Exit the program.
  94.  
  95.  
  96.      CHANGING COLOURS:
  97.  
  98.      If you don't like my choice of colour scheme, you'll have to
  99.      patch the executable to change it.  Here are the relevant
  100.      declarations from the source:
  101.  
  102.       patch_pointer : string[26] = 'Patch colour bytes here ->';
  103.       Standard: byte = Green;
  104.       Reverse : byte = 112;
  105.       Bright  : byte = Yellow;
  106.  
  107.      Search for the patch_pointer contents, and modify the next three
  108.      bytes to your heart's content.
  109.  
  110.      HARDWARE REQUIRED:
  111.  
  112.        IBM compatible computer with DOS 2+
  113.  
  114.        Enough memory:
  115.              about 70K bytes for the program
  116.              about 7 bytes per cluster
  117.              about 23 bytes per file, subdirectory, or erased file
  118.  
  119.        Note:  Showfat will use EMS memory if available, and if things are really
  120.              tight, will also attempt to swap all but 1 byte/cluster to disk
  121.              into files called SHOWFAT.$$?.  If it can't create the swap file,
  122.              it will abort.
  123.  
  124.      REVISIONS:
  125.  
  126.      2.41 (December 24, 1990) - Fixed bugs with disk read errors, full
  127.              directories, 12 bit FATs, non-standard boot sectors,
  128.              unusual sector sizes.  Added CHKDSK-style integrity checks.
  129.              Thanks to T. Salmi for his tests!
  130.  
  131.      2.36 (November 1, 1990) - Improved speed and memory use, cleaned
  132.              it up, and fixed lots of bugs with large disks.
  133.  
  134.      2.23 (May 9, 1990) - Extended DOS 4 support to pseudo-4 versions:
  135.              Compaq 3.31 and Zenith 3.30 Plus
  136.  
  137.      2.20 (April 2, 1990) - Minor revision.  Added DOS 4 support.
  138.  
  139.      2.10 (April 29, 1988) - Major revision.  Translated 2.01 from v. 3 of
  140.              Turbo Pascal to v. 4 and fixed bugs (using TDebug - great
  141.              program!), added F and D commands and generally cleaned
  142.              house.  Dropped DISKMON, since it was too slow.
  143.  
  144.      2.01 (not released) - Major revision to add Ascii and Hex windows.
  145.              Full of bugs.
  146.  
  147.      1.11 (October 20, 1987) - Bug fix for non-standard cluster size
  148.              Minor changes to documentation
  149.  
  150.      1.10 (October 17, 1987) - Added support for DISKMON
  151.  
  152.      1.05 (March 27, 1987) - Overflow in memory check fixed
  153.              Documentation expanded
  154.  
  155.      MONEY:
  156.  
  157.      The screen handling procedures in SHOWFAT are slightly modified
  158.      versions of the excellent BOOSTERS routines by George F. Smith.
  159.      Low level disk handling and memory management is done by routines
  160.      from the Object Professional library by TurboPower software.  The
  161.      rest is written by me.  You may use the program for free for a
  162.      month, but a registration fee of $20 (Canadian or U.S.) is
  163.      required if you continue to use it after that.  Users who pay the
  164.      registration fee will receive one free update on disk; please
  165.      state which version you're using.  I'm also willing to give free
  166.      registrations to people who help me fix bugs in it, and I give
  167.      discounts for non-profit or educational organizations.
  168.  
  169.      Suggestions for improvements would also be welcome.  Messages can
  170.      be sent to me (DJ MURDOCH) via Fidomail, at node 1:221/177.40 of
  171.      Fidonet, or on Compuserve, at address 71631,122.
  172.  
  173.                              D.J. Murdoch
  174.                              79 John St. W.
  175.                              Waterloo, Ontario
  176.                              Canada N2L 1B7