home *** CD-ROM | disk | FTP | other *** search
/ YPA: Your Privacy Assured / YPA.ISO / other_goodies / utilities / dsalv11_32.lha / DiskSalv2 / locale / docs / english / DiskSalv.doc next >
Text File  |  1994-04-10  |  53KB  |  1,189 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.            DDD  III SSSS K  K SSSS   A   L  V   V      222 
  19.            D  D  I  S    K K  S     A A  L  V   V         2
  20.            D  D  I  SSSS KK   SSSS A   A L  V   V        2 
  21.            D  D  I     S K K     S AAAAA L  V   V       2  
  22.            D  D  I     S K  K    S A   A L   V V       2   
  23.            DDD  III SSSS K  K SSSS A   A LLLL V        2222
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                The Original Amiga Disk Salvage Program
  35.  
  36.  
  37.               Recovering your data for over seven years
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                             Cheap Manual 
  49.                                  for 
  50.                               DiskSalv 
  51.  
  52.                               Version 2
  53.                             Revision 11.30
  54.                             April 10, 1994
  55.  
  56.                  Copyright ⌐1992-1994 by Dave Haynie
  57.                          All Rights Reserved 
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. COPYRIGHT 
  70.  
  71.           This  manual  is  Copyright  ⌐1992-1994  by Dave Haynie. All
  72. Rights Reserved.  As part of the DiskSalv2 11.30 release, this  manual
  73. may  be  used  in  electronic or printed form along with the DiskSalv2
  74. program.  It may not be sold in any form, though a reasonable  copying
  75. and  handling  charge is acceptable, as long as the complete DiskSalv2
  76. distribution is included.  
  77.  
  78.  
  79. DISCLAIMER 
  80.  
  81.           The information and the DiskSalv program  are  provided  "as
  82. is" without  warranty  of  any kind, either expressed or implied.  The
  83. entire risk as to the accuracy of the information herein is assumed by 
  84. you.   Dave  Haynie  does  not  warrant,  guarantee,   or   make   any
  85. representations  regarding  the  use of, or the results of the use of,
  86. the information or the  DiskSalv  program  in  terms  of  correctness,
  87. accuracy, reliability,  currentness,  or  otherwise.  In no event will
  88. Dave  Haynie  be  liable  for   direct,   indirect,   incidental,   or
  89. consequential  damages resulting from any defect in the information or
  90. the DiskSalv program even if he has been advised of the possibility of 
  91. such damages.  
  92.  
  93.  
  94. CREDITS 
  95.  
  96.           This manual was prepared with anro, an nroff-like utility by 
  97. Steve Anderson. With all the sophisticated word processors and DTPs  I
  98. have  around,  I couldn't find anything that would simply give me some
  99. formatted ANSI text.  Until everyone has a way to deal with  IFF-FTXT,
  100. ANSI  will  remain  the only printer independent formatted text format
  101. available.  
  102.  
  103.           Amiga, AmigaDOS, Intuition,  KickStart,  and  Workbench  are
  104. trademarks of Commodore-Amiga, Inc.  
  105.  
  106.           The  DiskSalv  program,  its code, this manual, the DiskSalv
  107. icons, and  anything  else  distributed  with  this  package  are  the
  108. original  work  of  Dave  Haynie. Thanks go out to the Commodore-Amiga
  109. Software Engineering group for suggestions on  the  DiskSalv  GUI  and
  110. other Amiga  software  standards.    Countless  others  assisted  with
  111. suggestions, testing, and miscellaneous feedback which has also proved 
  112. invaluable.  
  113.                              -Dave Haynie
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. DiskSalv Version 2 Release 11.30                                Page 3
  134.  
  135. 0. INTRODUCTION 
  136.  
  137.           DiskSalv Version 2 is a disk recovery program for all  Amiga
  138. file  system  devices  that  use any of the 2.04/2.1/3.0 file systems.
  139. DiskSalv will scan (analyze) a bad disk volume for anything  that  can
  140. be recovered, and will restore these items to any AmigaDOS volume.  It 
  141. can   also   attempt   to  fix  a  bad  volume  in  place  under  most
  142. circumstances.   DiskSalv  is  a  complete  redesign  of  the  orignal
  143. DiskSalv  program,  with  a  new  AmigaDOS-2.0-compliant  command-line
  144. interface, new Intuition interface, and tons of new features.  
  145.  
  146.           This is designed to be a fairly  complete,  quickly  written
  147. and minimally  edited  manual  of  DiskSalv Version 2's features.  The
  148. built-in help system works as an adjunct to this, and it works  simply
  149. --  press the HELP key with the mouse positioned over something, and a
  150. short description of that something will pop up in a requester.  
  151.  
  152.           Better documentation will  be  supplied  if  you  order  the
  153. commercial   release,  DiskSalv  Version  3,  which  is  currently  in
  154. development.  This will  eventually  include  a  professional  quality
  155. manual with pictures, better "how to", "why bother", and "theory of it 
  156. all" sections.      This  is  all  explained  in  the  "Licensing  and
  157. Distribution" section.  Additionally, the core  of  that  manual  will
  158. become an AmigaGuide manual.  
  159.  
  160.           The  DiskSalv  3  program offers an improved GUI, additional
  161. modes for backup, disk scrubbing,  undelete-in-place,  and  bad  block
  162. mapping.   The  various salvage and repair functions are being kept as
  163. similar as possible between the two versions.  So any  bugs  in  these
  164. areas or basic improvements will be added to both versions.  
  165.  
  166.  
  167. 1. STARTING UP 
  168.  
  169.           DiskSalv  Version 2 (from here on referred to as "DiskSalv")
  170. is a program designed to "salvage" damaged hard disks.  There are  two
  171. basic    classes   of   salvage   operation,   "Recover-by-Copy"   and
  172. "Fix-in-Place". In the former  case,  DiskSalv  analyzes  a  disk  and
  173. attempts  to restore any files and directories from a damaged AmigaDOS
  174. file system device to a good  one.    In  the  latter  case,  DiskSalv
  175. attempts  to  find faulty disk objects and remove them from the disk's
  176. directory/file hierarchy so that the disk's FileSystem  will  validate
  177. it.  
  178.  
  179.  
  180. 1.1 CLI OPERATION 
  181.  
  182.           In  the  simplest  case, DiskSalv can be used very much like
  183. DiskSalv V1.42, the AmigaDOS "DiskCopy"  program,  or  any  number  of
  184. other CLI-based  programs.    The  user  simply types a command at the
  185. command line, and the program goes to work.  For example,  to  recover
  186. files  from  a  bad disk in DH0: and restore them on a good disk DH1:,
  187. the user will type: 
  188.  
  189.           1> DiskSalv FROM DH0: TO DH1: 
  190.  
  191. Here the "FROM" and "TO" required CLI keywords.  There are quite a few 
  192. more keywords, which control a good portion of  DiskSalv's  operation.
  193. However,  to  access  every feature, it's necessary to use the program
  194. interactively under Intuition. The AmigaDOS template is  displayed  as
  195.      follows: 
  196.  
  197.  
  198.  
  199. Page 4                                DiskSalv Version 2 Release 11.30
  200.  
  201.      DiskSalv Version 2 Copyright (c) 1991-1994 by Dave Haynie
  202.  
  203.      FROM/K, TO/K, MODE/K, FILESYSTEM/K, DEFAULTFS/K, TAGCHAR/K,
  204.      PUBSCREEN/K, MEMCHUNK/N, PATHMAX/N, DISKCACHE/N, LOWMEM/S,
  205.      NOSIZECHECK/S, QUICKSCAN/S, NOWARNING/S, NODATES/S, NONOTES/S,
  206.      NOPROTECT/S, KEEPDOS/S,KILLDOS/S, NODEEPSCAN/S, INTERACTIVE/S,
  207.      REJECTION/N, MAKELINKS/S,S MALLWINDOW/S, BIGBLOCKS/T, LOADDEV/K,
  208.      RETRY/N
  209.  
  210. The meaning  of  these keywords is given below.  Note that any keyword
  211. can also be used as an icon variable (tooltype).  
  212.  
  213.      FROM 
  214.           The "FROM" keyword specifies an  input  device,  the  device
  215.           that will  be operated on.  This must be a DOS device, not a
  216.           subdirectory or assignment, and it must be based on  one  of
  217.           the standard file systems with underlying device driver.  
  218.  
  219.      TO 
  220.           The "TO" keyword specifies an output device, the device that 
  221.           will  receive any recover-by-copy files that DiskSalv finds.
  222.           This may be any AmigaDOS device,  volume,  or  subdirectory.
  223.           If  a  non-existant  subdirectory  is specified, one will be
  224.           generated.  
  225.  
  226.      MODE 
  227.           There are several kinds  of  functions  that  DiskSalv  will
  228.           run.   The  default  is  "Salvage", which causes DiskSalv to
  229.           work just like the  original  DiskSalv.  Other  modes  cause
  230.           other actions: 
  231.  
  232.      SALVAGE 
  233.           This is   the  basic  Recover-by-Copy  function.    DiskSalv
  234.           attempts to restore every  file  it  finds  from  the  input
  235.           device to  the output device.  The user can select the files
  236.           to actually restore.  
  237.  
  238.      UNDELETE 
  239.           This is another Recover-by-Copy function.   It  is  used  on
  240.           undamaged partitions  to  find  deleted files.  The user can
  241.           interactively pick which files are actually restored in this 
  242.           way.  
  243.  
  244.      VALIDATE 
  245.           This is the simplest Fix-In-Place function.  It can repair a 
  246.           device that hasn't been severely damaged.  On most  devices,
  247.           the  scan used in this mode is much faster than other scans,
  248.           but it can slow down on very large volumes.    As  with  all
  249.           Fix-In-Place  functions,  any  file  that must be eliminated
  250.           from disk will be displayed in a  file  list  once  the  fix
  251.           operation has completed.  
  252.  
  253.      REPAIR 
  254.           This is  a  more  advanced Fix-In-Place function.  It does a
  255.           traditional DiskSalv scan, and it can find more  files  than
  256.           the Validate function can.  It can also live with partitions 
  257.           that are more damaged than those Validate will handle.  
  258.  
  259.      UNFORMAT 
  260.           This  function  runs  a  Fix-In-Place  operation designed to
  261.           recover every properly formed directory or file on  a  disk,
  262.           regardless   of   the   current   contents   of  the  disk's
  263.  
  264.  
  265. DiskSalv Version 2 Release 11.30                                Page 5
  266.  
  267.           directories.  This is the mode to choose in the case  of  an
  268.           accidental  Format  being called on a disk (although nothing
  269.           can  be  recovered  if  a  full  format  runs  its  complete
  270.           course).   This  mode  will  resurrect any file that's still
  271.           intact, so it's usable as a  large-scale  Undelete-in-place,
  272.           though   it  offers  no  control  over  what  actually  gets
  273.           undeleted.  
  274.  
  275.      FILESYSTEM 
  276.           This allows the user to specify the file system  to  use  on
  277.           the input  device.    Normally,  DiskSalv  will  determine a
  278.           partition's file system from its root block.   If  for  some
  279.           reason that information is unavailable or wrong, this allows 
  280.           the file system type to be specified by force.  
  281.  
  282.                OFS 
  283.                     Original AmigaDOS FileSystem.  
  284.  
  285.                FFS 
  286.                     1.3-compatible Fast FileSystem.  
  287.  
  288.                OFS Intl.  
  289.                     International  character set aware version of OFS.
  290.                     International  file  systems   treat   diacritical
  291.                     characters  properly  with  respect  to  the  case
  292.                     independence expected in an Amiga file system.  
  293.  
  294.                FFS Intl.  
  295.                     International character set aware version of FFS.  
  296.  
  297.                DC-OFS 
  298.                     Directory  caching  version  of   OFS.   Directory
  299.                     caching  file  systems  keep  a  secondary  packed
  300.                     record of file  data  to  provide  fast  directory
  301.                     listings.  
  302.  
  303.                DC-FFS 
  304.                     Directory caching version of FFS.  
  305.  
  306.                Best-Guess 
  307.                     DiskSalv will pick one of the FileSystems it knows 
  308.                     about,  based  on  an  analysis  of  the disk done
  309.                     during the Scan. This is the standard default file 
  310.                     system (eg, default if  no  alternate  default  is
  311.                     selected).  
  312.  
  313.      DEFAULTFS 
  314.           This  allows  the user to specify the fallback FileSystem to
  315.           use on the input device.  Normally, DiskSalv will  determine
  316.           a  partition's  FileSystem  from its root block, but if that
  317.           root block is damaged, DiskSalv needs this fallback.  
  318.  
  319.      TAGCHAR 
  320.           This allows the user to specify which character to  use  for
  321.           tagging  selected  files  on the Output screen file browser.
  322.           The default is '*'.  
  323.  
  324.      PUBSCREEN 
  325.           This specifies the public screen for DiskSalv  to  start  up
  326.           on.   If  none  is  specified, DiskSalv will start up on the
  327.           Workbench screen (eg, default public screen).  
  328.  
  329.  
  330.  
  331. Page 6                                DiskSalv Version 2 Release 11.30
  332.  
  333.      MEMCHUNK 
  334.           This specifies the memory chunk size for  DiskSalv's  chunky
  335.           allocator to  use.    By default, this is 4K, and can be set
  336.           between 1K and 128K.  
  337.  
  338.      PATHMAX 
  339.           This specifies the maximum length  of  a  file  path.    The
  340.           default value is 512 bytes, and can be set between 256 bytes 
  341.           and 4K.  
  342.  
  343.      DISKCACHE 
  344.           This  specifies the number of blocks to be used for the disk
  345.           cache (which is actually a pre-fetch buffer).   The  default
  346.           size  is  8  blocks, and can be set between 0 (no cache) and
  347.           255 blocks.  
  348.  
  349.      LOWMEM 
  350.           This specifies low-memory mode.  If  DiskSalv  runs  out  of
  351.           memory  on  a system in normal mode, it may be successful in
  352.           low-memory mode.    This  automatically  causes  the  chunky
  353.           allocator, file path buffer, and disk cache to go to minimum 
  354.           sizes.   It  cuts out a number of other internal things that
  355.           generally just affect performance rather than success.  
  356.  
  357.      NOSIZECHECK 
  358.           This inhibits automatic size checking of the output  volume.
  359.           Normally,  DiskSalv watches the size of the output volume to
  360.           have an idea ahead of time that a volume will fill up.  Some 
  361.           devices, such as RAM:,  are  dynamically  sized  and  always
  362.           indicate  full  when  asked,  so  this  parameter  is mainly
  363.           intended for such devices (DiskSalv  actually  invokes  this
  364.           automatically  for  RAM:,  but it would have to be specified
  365.           manually for other such devices).  
  366.  
  367.      QUICKSCAN 
  368.           This specifies a faster disk scanning mode.  The speed of  a
  369.           disk  scan  is  improved  by  cutting  down  on  the  visual
  370.           display.  DiskSalv will still show a "gas-guage"  indicator,
  371.           but it won't list objects as they are encountered.  
  372.  
  373.      NOWARNING 
  374.           DiskSalv will normally attach a warning or error message, as 
  375.           a  FileNote,  to  any file it restores via a Recover-by-Copy
  376.           operation that it considers suspect or  bad.    This  option
  377.           will inhibit such action.  
  378.  
  379.      NODATES 
  380.           This  option  will  inhibit restoration of the original file
  381.           date in Recover-by-Copy operations.  
  382.  
  383.      NONOTES 
  384.           This  option  will  inhibit  restoration  of  the   original
  385.           FileNote in Recover-by-Copy operations (though warning notes 
  386.           will override original notes).  
  387.  
  388.      NOPROTECT 
  389.           This   option  will  inhibit  restoration  of  the  original
  390.           protection codes in Recover-by-Copy operations.  
  391.  
  392.      KEEPDOS 
  393.           The FileSystem (eg, AmigaDOS) is usually locked out from the 
  394.           input device during scan  and  recovery  operations.    This
  395.  
  396.  
  397. DiskSalv Version 2 Release 11.30                                Page 7
  398.  
  399.           option will prevent such a lockout.  Fix-In-Place operations 
  400.           are  not  affected  by  this,  as  they absolutely require a
  401.           FileSystem lockout since they are modifying the input  disk.
  402.           Note  that  allowing  any  writes to the input disk during a
  403.           DiskSalv operation will almost certainly cause  DiskSalv  to
  404.           malfunction.  
  405.  
  406.      KILLDOS 
  407.           This  option forces DiskSalv to do its job without using any
  408.           device  directed  DOS  functions  or  file  system  packets.
  409.           Normally,  DiskSalv uses a handfull of DOS library functions
  410.           on input disks.  This is designed to make DiskSalv safe  for
  411.           use  on  disks  that  crash  AmigaDOS or the particular file
  412.           system in use.  This is a somewhat dangerous  option,  since
  413.           it  prevents  DiskSalv from locking the file system out of a
  414.           device (since that requires a file system packet).  It works 
  415.           best on devices that can't  be  given  to  AmigaDOS  because
  416.           they're too damaged.  Note that DOS is automatically avoided 
  417.           on unmounted devices.  
  418.  
  419.      NODEEPSCAN 
  420.           This  inhibits  extra  low-level  processing from being done
  421.           floppy disks.  Such processing can recover data not normally 
  422.           accessable through the trackdisk.device, but it causes extra 
  423.           memory to be used.  
  424.  
  425.      INTERACTIVE 
  426.           This forces DiskSalv  into  interactive  operation  (eg,  it
  427.           waits for user input).  When run from the CLI, DiskSalv will 
  428.           by  default  do  as  much as it can non-interactively before
  429.           going into interactive mode.  
  430.  
  431.      REJECTION 
  432.           This specifies a filter strength, between  1  and  10,  that
  433.           influences  DiskSalv's  assessment  of whether or not a disk
  434.           block matches a specific block type.  This is generally left 
  435.           at the default, 6.  
  436.  
  437.      MAKELINKS 
  438.           This causes DiskSalv to actually create links on the  output
  439.           volume.   Normally  it  instead  creates a script file which
  440.           will create the links.  
  441.  
  442.      SMALLWINDOW 
  443.           This causes DiskSalv to build  a  minimal  scanning  display
  444.           window, even on large screens.  
  445.  
  446.      BIGBLOCKS 
  447.           This  lets  the  user  specifiy whether support for multiple
  448.           sectors per  block  is  enabled.     On   pre-V39   systems,
  449.           occasionally  DOS  devices  claimed  for some reason to have
  450.           more than one sector per block.  Since real support of  this
  451.           didn't  appear  until  the  V40 FileSystem, which apparently
  452.           needs V39 to run, multiple sector per block support  is  off
  453.           by  default  in  on  a pre-V39 system, on by default for V39
  454.           systems and above.  
  455.  
  456.      LOADDEV 
  457.           This argument takes  the  name  of  a  DOSDrivers-compatible
  458.           device  description  file, which it will load and set as the
  459.           current input device.  
  460.  
  461.  
  462.  
  463. Page 8                                DiskSalv Version 2 Release 11.30
  464.  
  465.      RETRY 
  466.           This argument changes the number of retries a  device  drive
  467.           will run  on  a read failure.  USE THIS OPTION WITH CAUTION!
  468.           This function uses the convention  of  the  trackdisk.device
  469.           for  retry  count, which isn't guaranteed to be supported by
  470.           other device drivers.  In general, the default  retry  count
  471.           is what  you  want to use.  When a device has a large number
  472.           of errors, it can be processed much faster by  setting  this
  473.           parameter  as  low  as zero, if the selected device supports
  474.           this convention.  If not, there's a  chance  it  will  cause
  475.           some  unknown  problem,  so  it's best to use only as a last
  476.           resort.  
  477.  
  478.  
  479. 1.2 WORKBENCH OPERATION 
  480.  
  481.           DiskSalv can be run from the Workbench by double-clicking on 
  482. its Icon. Normally,  this  brings  up  DiskSalv  interactively,  where
  483. options  are  set  via standard 2.0-level Intuition interface objects.
  484. However, any of  the  command-line  parameters  may  be  set  as  Icon
  485. ToolTypes   to   set   DiskSalv  up  for  other-than-standard  default
  486. conditions and other special things.  
  487.  
  488.  
  489. 1.3 THE DISKSALV GUI 
  490.  
  491.           No matter how you enter DiskSalv, you're going  to  wind  up
  492. seeing  some  aspect  of  the  program's GUI. If you run interactively
  493. either from the CLI or from Workbench,  you  will  start  out  in  the
  494. "Input  Window". Here is where various parameters are set that control
  495. how the program will "scan", or learn about, a given input disk.  Once 
  496. all input information is set  up,  the  program  moves  to  the  "Scan
  497. Window",   which   basically   monitors  disk  scan  and  Fix-In-Place
  498. operation, where applicable.  If it's appropriate (files are found  in
  499. a   Recover-by-Copy   mode   or  damaged  files  are  found  during  a
  500. Fix-In-Place operation), the Scan Window will give way to the  "Output
  501. Window". This windows accepts input to select the objects that will be 
  502. restored and the device to restore them to.  
  503.  
  504.           While  DiskSalv's interface is based on Intuition, there are
  505. keyboard equivalents for practically anything you can do from  gadgets
  506. or windows.    The  gadget  shortcuts  are  generally  indicated by an
  507. underlined letter in the text  of  the  particular  gadget,  and  will
  508. change from  language  to language.  For gadgets that cycle or scroll,
  509. the direction of movement will change based on whether the shortcut is 
  510. typed with the shift key pressed.  A few  windows  have  gadgets  with
  511. extra  functions  or  non-text  gadgets  that have keyboard shortcuts.
  512. Those shortcuts are mentioned in the this  manual  in  the  particular
  513. section relating to that gadet.  
  514.  
  515.           Menus also have keyboard shortcuts, which are always invoked 
  516. with the  right Amiga key and a single letter pressed together.  These
  517. are indicated in the menus, in the normal  Intuition  fashion.    Note
  518. that  these,  too,  can  change  according  to the localization of the
  519. program, so the actual values aren't called out here.  
  520.  
  521.  
  522. 2.0 THE INPUT WINDOW 
  523.  
  524.           The Input Window is where a device is selected.  There are a 
  525. series of gadgets and menu items that can control the way things  work
  526. here.  The gadgets are as follows: 
  527.  
  528.  
  529. DiskSalv Version 2 Release 11.30                                Page 9
  530.  
  531.      Device For Scan 
  532.           This  list  gadget  displays  a list of recoverable devices.
  533.           One of these must be selected to run a scan.  These are  all
  534.           listed  by  physical  AmigaDOS  name,  never  by  volume  or
  535.           assigned name.  A disk icon or DOSDrivers icon  can  now  be
  536.           dropped into the DiskSalv window to update this selection.  
  537.  
  538.      FileSystem: 
  539.           This  gadget  is  a  cycle gadget that allows any of the six
  540.           aforementioned file systems to be selected.  When you select 
  541.           a device, this gadget will be set to DiskSalv's  best  guess
  542.           at  that  device's  file  system, or the default if DiskSalv
  543.           can't make a good guess.  Therefore, the  user  is  able  to
  544.           pick  a different one if DiskSalv didn't make a good choice.
  545.           See section 1.1, "FILESYSTEM", for a list  of  these.    The
  546.           "Best-Guess"  option  runs a special statistics tracking and
  547.           analysis routine to determine the most  likely  file  system
  548.           for any given device.  
  549.  
  550.      Mode: 
  551.           This  cycle  gadget  lets  the  user  select  an appropriate
  552.           recovery operation.  Interlocks are  managed  here  to  make
  553.           certain  that  the  specified operation and specified device
  554.           will work together.  See section 1.1, "MODE", for a list  of
  555.           the FileSystem names.  
  556.  
  557.      Set Filter...  
  558.           This  gadget  brings  up  the  "Disk  Scan  Filter  Options"
  559.           window.  This window allows various options  to  be  set  to
  560.           control  partial  scans  of  a  disk, exclusions by AmigaDOS
  561.           pattern name or protection bits, etc.  See section 2.1 for a 
  562.           full explanation of this window.  
  563.  
  564.      Device Info...  
  565.           This  gadget  brings  up  a  "Physical  Device  Information"
  566.           requester  which  gives  partitioning  and  other  low-level
  567.           information on the selected device.  
  568.  
  569.      Scan 
  570.           This gadget starts the disk analysis phase of  the  DiskSalv
  571.           program.   Once  the other phases are complete, the user may
  572.           return  to  the  Input  Window  without  having  to  restart
  573.           DiskSalv.  
  574.  
  575.           There  are  two  menus on the Input Window. One of these can
  576. call up a variety  of  miscellaneous  functions,  the  other  controls
  577. toggling  of a few control options, and the ability to save these back
  578. to the DiskSalv icon.  The mens are as follows: 
  579.  
  580.      Project/About...  
  581.           This item brings up a  requester  with  information  on  the
  582.           version   of   DiskSalv,   its  distribution  license,  some
  583.           Shareware data, and where to write me about DiskSalv.  
  584.  
  585.      Project/Help...  
  586.           This item brings up a requester with a brief explanation  of
  587.           the Input Window.  
  588.  
  589.      Project/Log File...  
  590.           This  item  brings up a file requester for the specification
  591.           of a log file.  This file must be on a device other than the 
  592.           input device.  When a log file is specified,  DiskSalv  will
  593.  
  594.  
  595. Page 10                               DiskSalv Version 2 Release 11.30
  596.  
  597.           write a record of its activity during all phases out to that 
  598.           file.  
  599.  
  600.      Project/Restore...  
  601.           This   item  brings  up  the  "Stream  Restoration  Options"
  602.           requester, which allows the user to specify input and output 
  603.           paths for restoration of a DiskSalv archive  file.    Please
  604.           see  section  3 for information on creating DiskSalv archive
  605.           files.  
  606.  
  607.      Project/Custom...  
  608.           This item brings up the "Custom Window". The  Custom  Window
  609.           is  an advanced option that can be used to search a disk for
  610.           logical  partitions  or  specify  partitions  based  on  the
  611.           low-level components.  
  612.  
  613.      Project/Save Device...  
  614.           This  item saves the currently selected "Device for Scan" as
  615.           a description file for the AmigaDOS Mount command.  
  616.  
  617.      Project/Load Device...  
  618.           This item loads a specified AmigaDOS device description file 
  619.           as a DiskSalv "virtual" device.  The name of the device will 
  620.           be the name of the description file.  
  621.  
  622.      Project/Quit 
  623.           This item closes the DiskSalv  program.    Its  function  is
  624.           identical  to  that of the Close gadget on the DiskSalv main
  625.           window.  
  626.  
  627.      Settings/DOS Lock 
  628.           The FileSystem (eg, AmigaDOS) is usually locked out from the 
  629.           input device during scan  and  recovery  operations.    This
  630.           option toggles  prevention  of such a lockout.  Fix-In-Place
  631.           operations are not affected  by  this,  as  they  absolutely
  632.           require  a  file system lockout since they are modifying the
  633.           input disk.  Note that allowing any writes to the input disk 
  634.           during a DiskSalv  operation  will  almost  certainly  cause
  635.           DiskSalv to malfunction.  
  636.  
  637.      Settings/Low Memory 
  638.           This option  toggles  low-memory mode.  If DiskSalv runs out
  639.           of memory on a system in normal mode, it may  be  successful
  640.           in low-memory  mode.    This automatically causes the chunky
  641.           allocator, file path buffer, and disk cache to go to minimum 
  642.           sizes.  It cuts out a number of other internal  things  that
  643.           generally just affect performance rather than success.  
  644.  
  645.      Settings/Small Window 
  646.           This option  toggles  automatic window sizing.  Normall, the
  647.           DiskSalv scanner will open a large window if  it  finds  the
  648.           current screen  supports  it.    This  will force use of the
  649.           small window for all scans, regardless of the screen size.  
  650.  
  651.      Settings/Quick Scan 
  652.           This option  selects  the  quick  scanning  option  for  the
  653.           scanner.   With  this  set,  the  scanning  process will run
  654.           faster by not displaying any data on the files  encountered.
  655.  
  656.      Settings/Save Settings 
  657.           This  options  saves  various  Input screen variables to the
  658.           DiskSalv tools icon.  
  659.  
  660.  
  661. DiskSalv Version 2 Release 11.30                               Page 11
  662.  
  663. 2.1 THE DISK SCAN FILTER OPTIONS WINDOW 
  664.  
  665.           The  "Disk  Scan  Filter  Options"  window  allows   several
  666. modifiers  to  be  set that affect the scan phase of a Recover-by-Copy
  667. operations.  These modifiers are ignored by  Fix-In-Place  operations,
  668. which must  examine  a disk in its entirety to perform correctly.  The
  669. window has standard "Ok" and "Cancel" gadgets, which  use  and  ignore
  670. the effect  of the current filter options settings, respectively.  The
  671. other gadgets are as follows: 
  672.  
  673.      File Pattern 
  674.           The string gadget takes in an AmigaDOS file pattern.  During 
  675.           the scan of a  disk,  any  file  matching  this  pattern  is
  676.           recorded, while any file not matching is ignored.  This acts 
  677.           on  links as well as files, but not on directories, since at
  678.           the time a directory is scanned, there's no way to  tell  if
  679.           it  will be needed by a child object that's further into the
  680.           disk.  
  681.  
  682.      Disk Scan Range 
  683.           This gadget is composed of two pointers, which can be  moved
  684.           to  modify  the  part  of  the  input  disk that is actually
  685.           scanned.  The start and finishing blocks on  that  disk  are
  686.           indicated next  to  the gadget.  The gadget is hard-wired to
  687.           make certain that  the  start  of  the  disk  is  below  the
  688.           finish.   This  can be moved from the keyboard with left and
  689.           right cursor keys, unshifted or shifted.  
  690.  
  691.      Protection Bits 
  692.           This is a group of gadgets which control  matching  of  each
  693.           file  encountered against the seven defined protection bits.
  694.           A "Don't Care" setting matches  any  level,  a  "Match  Set"
  695.           setting  matches  a  bit  that's logically set, and a "Match
  696.           Clear" setting matches a bit that's logically clear.  
  697.  
  698.  
  699. 2.2 THE CUSTOM WINDOW 
  700.  
  701.           The Custom Window is a fork  off  the  main  DiskSalv  Input
  702. Window that is used for dealing with special device cases.  An unknown 
  703. disk,  a  disk  with  lost  partitioning  information,  or  other such
  704. problems can  be  solved  here.    An  input  device  is  entered  via
  705. exec-level device  name  and  unit  number.    Dropping a disk icon or
  706. DOSDrivers type  file  into  this  window  will  update  these  fields
  707. automatically.   The  user can specify the partitioning information or
  708.  ask DiskSalv to  go  looking  for  partitions.    In  a  search,  the
  709. partition's  logical  name  can  be  specified  as a search target, or
  710. DiskSalv can be instructed to find all partitions on the disk.   There
  711.           are fifteen gadgets here: 
  712.  
  713.      Create 
  714.           The  Create  gadget builds one "virtual device" based on the
  715.           information supplied  here.    This   requires   the   basic
  716.           partitioning  information,  exec device name and unit, and a
  717.           DOS Name which  is  used  in  the  "Device  For  Scan"  list
  718.           gadget.   Any  such virtual device is listed in parentheses,
  719.           and only the "Salvage" operation can be used on them.  
  720.  
  721.      Search 
  722.           This function starts a search on  the  given  disk  for  one
  723.           volume that matches the given pattern.  
  724.  
  725.  
  726.  
  727. Page 12                               DiskSalv Version 2 Release 11.30
  728.  
  729.      Analyze 
  730.           This function starts a scan of the defined range of the disk 
  731.           for any  partitions.   The base block of a partition will be
  732.           used as its name if no root is found.  If a root  is  found,
  733.           its  name  will  be  used  instead  in the "Device For Scan"
  734.           list.  
  735.  
  736.      Cancel 
  737.           Leave this window without performing any kind of scan.  
  738.  
  739.      Device Name: 
  740.           This is the Exec device used to manage  the  disk,  such  as
  741.           "scsi.device".  Be very careful in selecting this properly.  
  742.  
  743.      Name/Pattern: 
  744.           This  is  a  DOS Name for "Created" volumes, or a pattern to
  745.           apply to a search for a specific volume or as a  volume-name
  746.           filter for full analysis.  
  747.  
  748.      Unit: 
  749.           The  unit number for the Exec device names in "Device Name".
  750.           Be very careful in selecting this properly.  
  751.  
  752.      Sectors/Track: 
  753.           This is the number of sectors assigned per disk track.  
  754.  
  755.      Bytes/Sector: 
  756.           This is the basic block size for the  device.    While  most
  757.           things  in the system are set up for 512 byte blocks, larger
  758.           disks may  use  larger  block   sizes.      These   are   in
  759.           powers-of-two, 512 bytes or larger.  
  760.  
  761.      Sectors/Block: 
  762.           This  parameter  allows  for a variable effective block size
  763.           per  partition  while  having   a   consistent   number   of
  764.           bytes/sector throughout a disk.  Block size is Sectors/Block 
  765.           * Bytes/Sector. By default, this is only available under V39 
  766.           or later file systems.  
  767.  
  768.      Low Sector: 
  769.           This  is  the  starting  position  on the input device to be
  770.           searched.  Since we're not searching a logical partition but 
  771.           in fact a physical disk, this number is a direct disk sector 
  772.           number (this specifies the physical block to map to  logical
  773.           block 0 for the Create operation).  
  774.  
  775.      High Sector: 
  776.           This is the last physical block to scan for all operations.  
  777.  
  778.      Flags: 
  779.           These are device-driver specific flags.  
  780.  
  781.      Memory Type: 
  782.           This  cycle  gadget  allows  the user to specify the type of
  783.           memory to use for disk  buffers.    Types  include  DEFAULT,
  784.           CHIP, FAST, and DMA-24.  
  785.  
  786.           There are only two menu items on the single menu attached to 
  787. the Custom Window. The first is the "Project/Help..." item, which pops 
  788. up  a  requester  box  describing the Custom Window. The other item is
  789. "Project/Quit", which will terminate the DiskSalv program.  
  790.  
  791.  
  792.  
  793. DiskSalv Version 2 Release 11.30                               Page 13
  794.  
  795. 3. THE SCAN WINDOW 
  796.  
  797.           The Scan Window is entered once the user selected  the  Scan
  798. gadget  of the Input Window. In normal operation, the Scan window will
  799. have two gadgets, two menu items,  and  four  informational  displays.
  800. The "Stop"  gadget  will  cause the scan to stop where it is.  This is
  801. only available  for  Recover-by-Copy  operations,  since  Fix-In-Place
  802. operations need  to  scan  the  entire  disk.  The other gadget is the
  803. "Pause" gadget, which will freeze the scan where it is until  told  to
  804. go on.  
  805.  
  806.           The two menu items are "Project/Help..." and "Project/Quit". 
  807. The  former will display some information about the Scan Window, while
  808. the latter will cause the DiskSalv program  to  quit,  just  like  the
  809. Close gadget  will.  During Fix-In-Place operations, the Quit function
  810. will take some time if  invoked  during  some  of  the  latter  fixing
  811. phases,   since   DiskSalv  doesn't  want  to  leave  the  disk  in  a
  812. questionable state.  
  813.  
  814.           The "Current Operation" display indicates what  DiskSalv  is
  815. actually doing  at  any  given  time during the scan.  To the right of
  816. this  is  the  "Device  Scan"  box,  which  keeps  track  of  scanning
  817. statistics,  like  the  current  block  and  number of Files or Errors
  818. encountered.  Below this is the "fuel guage", which is always used  to
  819. indicate the  progress  of  the  current  phase.    Below  that is the
  820. "Scanning Results" display, which indicates the type and name of  each
  821. object found, as well as other statistics (this is basically what gets 
  822. written out  to  the  log  file,  if there is a log file).  On a large
  823. display, this is eleven lines long, on a small display its five  lines
  824. long.   The  QUICKSCAN  option  eliminates  this  part  of the display
  825. altogether.  
  826.  
  827.  
  828. 4. THE OUTPUT WINDOW 
  829.  
  830.           All Recover-by-Copy operations and  Fix-In-Place  operations
  831. with  corrupt  files  end  the  scanning  process  and open the Output
  832. Window. This is where objects and the output path are selected  for  a
  833. Restore (eg,  Recover-by-Copy)  operation.  This window's GUI consists
  834. of twelve gadgets and ten menu items.  The gadgets are as follows: 
  835.  
  836.      Salvage File List (etc) 
  837.           The scrolling file list, labelled somewhat  differently  for
  838.           each  function,  is where files are selected for restoration
  839.           to a new volume.  Clicking on a  file  or  link  alternately
  840.           tags  or  clears  that  object,  and  makes it the "current"
  841.           object  (displayed  in  the  text  gadget  below  the   list
  842.           gadget).   Clicking on a directory once makes it the current
  843.           object, but does not tag it.  Clicking again  on  that  same
  844.           directory   causes   this   "browser"   to  "move"  to  that
  845.           directory.  There are keyboard shorts for  this  too.    The
  846.           standard gadget short (shown in the list title), will scroll 
  847.           the  selected  item  in  the  list,  but  won't  actually do
  848.           anything with it.  The space bar will  toggle  selection  of
  849.           file objects, or enter directories.  
  850.  
  851.      Output Path 
  852.           This  specifies two gadgets, a disk icon gadget and a string
  853.           gadget.   Clicking  on  the  disk  icon  brings  up  a  file
  854.           requester,  while  clicking on the string requester lets the
  855.           user enter a path by hand.  This path is the  place  to  put
  856.           any recovered  files.    It  can  be a device, directory, or
  857.  
  858.  
  859. Page 14                               DiskSalv Version 2 Release 11.30
  860.  
  861.           possibly  a  "stream",  depending  on  the  setting  of  the
  862.           "Archive Stream"  option.    If  a non-existant directory is
  863.           specified, it is created.  An output device can  be  entered
  864.           here simply by dropping its disk icon into the window.  
  865.  
  866.      Salvage 
  867.           This gadget  begins  the  file  restoration.    It  won't be
  868.           selectable until at least something is tagged in the Salvage 
  869.           List and proper output device parameters have been entered.  
  870.  
  871.      File List Action 
  872.           The remaining gadgets are  part  of  the  File  List  Action
  873.           group.   These  control tags on objects, browser navigation,
  874.           and other aspects of the file list.  Note that  only  tagged
  875.           files are operated on by "Forget" or "Salvage".  
  876.  
  877.      Parent 
  878.           This  gadget  brings  the  file  browser up by one directory
  879.           level.  
  880.  
  881.      Root 
  882.           This gadget brings the file brower up to the  top  directory
  883.           level.  
  884.  
  885.      Forget 
  886.           This  gadget  removes  any  tagged  objects from the browser
  887.           list.  It has no effect on the object as it exists on-disk.  
  888.  
  889.      Info...  
  890.           Statistics on  the  "current"  object  are  displayed  in  a
  891.           requester when this is selected.  
  892.  
  893.      Select Directory 
  894.           This will recursively tag every object in the hierarchy of a 
  895.           directory.  If the current object is a directory, it's used, 
  896.           otherwise the present (displayed) directory is used.  
  897.  
  898.      Select Files 
  899.           Like "Select Directory", but tags only files.  
  900.  
  901.      Clear Directory 
  902.           Like "Select Directory", but recursively untags objects.  
  903.  
  904.      Clear Files 
  905.           Like "Clear Directory", but untags only files.  
  906.  
  907.           Most  of the menu items are designed to support the settings
  908. of different restore-time parameters.  The menu items are: 
  909.  
  910.      Project/Help...  
  911.           This option pops up with a brief description of  the  Output
  912.           window.  
  913.  
  914.      Project/New Device...  
  915.           This  option  resets  DiskSalv  and  starts over back at the
  916.           Input Window.  
  917.  
  918.      Project/Quit 
  919.           This option, like  the  close  gadget,  causes  DiskSalv  to
  920.           cleanly exit.  
  921.  
  922.      Settings/Size Check 
  923.  
  924.  
  925. DiskSalv Version 2 Release 11.30                               Page 15
  926.  
  927.           This  toggles  automatic size checking of the output volume.
  928.           Normally, DiskSalv watches the size of the output volume  to
  929.           have an idea ahead of time that a volume will fill up.  Some 
  930.           devices,  such  as  RAM:,  are  dynamically sized and always
  931.           indicate full  when  asked,  so  this  parameter  is  mainly
  932.           intended  for  such  devices (DiskSalv actually invokes this
  933.           automatically for RAM:, but it would have  to  be  specified
  934.           manually for other such devices).  
  935.  
  936.      Settings/Warning Notes 
  937.           This  toggles  whether or not DiskSalv will attach a warning
  938.           or error message, as a FileNote, to any file it restores via 
  939.           a Recover-by-Copy operation that  it  considers  suspect  or
  940.           bad.  
  941.  
  942.      Settings/Notes Restored 
  943.           This  toggles  restoration  the  original  FileNote  to  any
  944.           restored object.    Warning  notes  will  override  original
  945.           notes).  This option will inhibit such an action.  
  946.  
  947.      Settings/Protection Restored 
  948.           This toggles restoration of the original protection codes on 
  949.           any object.  This option will inhibit such an action.  
  950.  
  951.      Settings/Date Restored 
  952.           This  toggles  restoration  of the original AmigaDOS date to
  953.           all output objects.  
  954.  
  955.      Settings/Archive Stream 
  956.           This determines which I/O formation is used for  the  output
  957.           device.   By  default, the OUTPUT device is a directory, and
  958.           DiskSalv regenerates the specified directory tree  as  found
  959.           on the  input  disk.    When  Archive  Stream  mode  is set,
  960.           DiskSalv  writes  out  everything  in  a  structured  output
  961.           stream.   This  stream is turned back to a directory tree by
  962.           using the Project/Restore option on the Input Window.  Since
  963.           this  formatted  stream  makes  all disk objects appear as a
  964.           single file, it can be piped though  compression  tools  and
  965.           processed through other interesting programs as desirable.  
  966.  
  967.      Settings/Save Settings 
  968.           When  selected,  this  saves the state of the toggle options
  969.           other than "Archive Stream" out to the DiskSalv.info file.  
  970.  
  971.  
  972. 5. THE RECOVERY WINDOW 
  973.  
  974.           The Recovery Window looks  exactly  like  the  Scan  window,
  975. mainly because  it is the Scan Window just doing something else.  This
  976. window displays each file as  it's  restored  to  the  output  device.
  977. Along  the way, if the output device fails or gets full, DiskSalv will
  978. prompt the user  to  skip  the  file,  change  the  media,  or  change
  979. devices.   When  a  device  change  is requested, the Output window is
  980. called up again to secure a new device input the normal way.  At  that
  981. point, only files left yet-to-be restored will be out on disk.  
  982.  
  983.  
  984. 6. LICENSING AND DISTRIBUTION 
  985.  
  986.           This  program,  DiskSalv  2, is distributed as ShareWare. It
  987. may be freely redistributed, but  no  charges  other  than  reasonable
  988. copying and  handling  fees  may  be  collected.    The program may be
  989.  
  990.  
  991. Page 16                               DiskSalv Version 2 Release 11.30
  992.  
  993. distributed only as originally  released,  in  the  complete  archived
  994. form.   No changes of any kind may be made to the DiskSalv 2 binary or
  995. archive, and I will not answer for any problems that may result from a 
  996. modified binary.  The suggested basic registration fee is US$10, which 
  997. gets you an entry in  my  database  of  users  and  a  certificate  of
  998. registration by  return mail.  At the time of registration, the latest
  999. release can be ordered for US$5. Later  updates  can  be  ordered  for
  1000. US$10  with  proof of registration (registration number will do if the
  1001. and address is the same).  
  1002.  
  1003.           The commercial version offer has changed somewhat since  the
  1004. V11.27  ShareWare  release of DiskSalv. Hopefully everyone (especially
  1005. those who have already sent in money) will be happy with  this.    The
  1006. price  is still US$40, plus additional tax or postage, as shown on the
  1007. price list.  The complete commercial package includes the new DiskSalv 
  1008. 3, the AmigaGuide manual, and the printed manual.  
  1009.  
  1010.           If you send money beyond the registration fee,  it  will  be
  1011. used  for  updates  if  less  than  the  commercial  fee,  unless I am
  1012. otherwise instructed.  Money beyond the commercial fee will  also  get
  1013. you updates, unless I am otherwise instructed.  
  1014.  
  1015.           The  place  to send any and all inquiries, bug reports, etc.
  1016. is: 
  1017.                     Dave Haynie
  1018.                     284 Memorial Avenue
  1019.                     Gibbstown, NJ 08027
  1020.                     USA
  1021.  
  1022.                     You can also contact me electronically:
  1023.                               email:    daveh@cbmvax.commodore.com
  1024.                                   hazy@cup.portal.com
  1025.                                   hazy@bix.com
  1026.                               FAX:    +1-609-224-0442
  1027.  
  1028.           If you're not from the  USA,  you  can  pay  in  your  local
  1029. currency if  you  send a cash equivalent.  Foreign personal checks and
  1030. some other draft forms generally have the banks keeping about 1/2  the
  1031. money on  a  US$10 registration fee.  Most countries have a way to get
  1032. US fund checks, such as postal money  orders,  that  go  through  just
  1033. fine.  I'm not trying to sound greedy here by any means, I just prefer 
  1034. either  you  or I get that $10 or so, not the banks, even if I need to
  1035. go to the city and convert the cash myself once I collect a reasonable 
  1036. amount.  Of course, if your country's laws prohibit sending  cash  out
  1037. of the country or something similar, you may not want to do this.  
  1038.  
  1039.           Also   of  interest  to  foreign  Amiga  users  is  language
  1040. support.   DiskSalv  fully  supports  the  AmigaDOS  2.1  localization
  1041. library mechanism.    Some  locale  catalogs  are  included  with this
  1042. initial release.  Additional locale support should be available  at  a
  1043. later date.    Translations  of the commercial manual may be possible,
  1044. but none are guaranteed yet.  That pretty much depends  on  whether  I
  1045. sign up with any foreign distributer.  
  1046.  
  1047.           If  you're  a  commercial interest, you can contact me about
  1048. non-exclusive bundling deals if you're interested.  Dealers  or  other
  1049. groups  should  contact  me  about  volume  discounts  on  the  deluxe
  1050. distribution.  And I'm not opposed to  going  through  a  distributer,
  1051. either  for  US  or  foreign  distribution, assuming we can work out a
  1052. deal.  I have been talking with some, but no deals  have  been  signed
  1053. yet.  
  1054.  
  1055.  
  1056.  
  1057. DiskSalv Version 2 Release 11.30                               Page 17
  1058.  
  1059. SCANNER CODES 
  1060.  
  1061.           The  DiskSalv  Scanner  (the  window, used in many different
  1062. operations, that displays the bar graph, mode, blocks count,  results,
  1063. etc.)  generates  useful information on what happened during a scan of
  1064. any kind.  If you select a log file  (via  the  "Project/LoG  File..."
  1065. menu  item on the input window, the scanner text that often scrolls by
  1066. too fast is stored to this file.  Every result is tagged with  a  four
  1067. character  code,  indicating  what  has  been found, the action taken,
  1068. etc.  Users can  search  for  particular  things  in  a  log  file  by
  1069. searching for these codes.  The codes are explained below.  
  1070.  
  1071.      ????  
  1072.           This indicates  a  block  that DiskSalv can't indentify.  In
  1073.           OFS file systems, all blocks should have  type  headers,  so
  1074.           you'll see  this  if one doesn't.  In FFS file systems, data
  1075.           blocks are untyped and this code isn't used.  
  1076.  
  1077.      DATA 
  1078.           This indicates an OFS data block.  Data blocks  in  FFS  are
  1079.           untyped.  
  1080.  
  1081.      DCSH 
  1082.           This indicates  a  directory cache block.  It's possible for
  1083.           DiskSalv to find directory cache blocks in  partitions  that
  1084.           aren't  using  directory  cached file systems (for instance,
  1085.           maybe the disk used to have a directory cached  file  system
  1086.           but now  doesn't).    DiskSalv doesn't store directory cache
  1087.           block information except when  processing  either  directory
  1088.           cached or Best-Guess file systems.  
  1089.  
  1090.      DELD 
  1091.           This  indicates  that  DiskSalv has determined a disk object
  1092.           was deleted on-disk.  This code is generated  during  Repair
  1093.           or Unformat operations.  
  1094.  
  1095.      DLNK 
  1096.           This indicates a hard directory link.  
  1097.  
  1098.      ERR!  
  1099.           This indicates  a  physical (hard) read error.  While a file
  1100.           system in operation may report  errors  (such  as  "checksum
  1101.           error",  "not a DOS disk", etc.), most errors are "soft", in
  1102.           that they're only errors in a  file  system  data  structure
  1103.           somewhere.   If,  for  some  reason,  a disk's device driver
  1104.           can't physically read a particular block,  DiskSalv  reports
  1105.           that in this way.  
  1106.  
  1107.      FILE 
  1108.           This indicates a normal file header.  
  1109.  
  1110.      FLNK 
  1111.           This indicates a hard file link.  
  1112.  
  1113.      FREE 
  1114.           This indicates   an   unused   disk   block.    Due  to  the
  1115.           aforementioned block typing conventions, DiskSalv  can  only
  1116.           determine if  a  block  is  unused  on  an OFS disk.  On FFS
  1117.           disks, there's no way to be certain if a block is  currently
  1118.           used,  previously  used,  or  never  used with 100% accuracy
  1119.           (from the block data alone, obviously DiskSalv knows how  to
  1120.           find data blocks by tracing through files).  
  1121.  
  1122.  
  1123. Page 18                               DiskSalv Version 2 Release 11.30
  1124.  
  1125.      GOOD 
  1126.           During  a  Validate,  Repair,  or Unformat operation, a disk
  1127.           object that has been determined  to  be  valid  on  disk  is
  1128.           reported with this code.  
  1129.  
  1130.      KILL 
  1131.           During  a  Validate,  Repair,  or Unformat operation, a disk
  1132.           object that DiskSalv has to  delete  from  the  active  disk
  1133.           structure,  due to some kind of corruption, is reported with
  1134.           this code.  
  1135.  
  1136.      LIST 
  1137.           This indicates a list, or "file  extension"  block.    Every
  1138.           file  header  block (reported with the "FILE" code) contains
  1139.           the location of a number of that  file's  data  blocks  (the
  1140.           actual  number  depends  on  the  size  of  the  partition's
  1141.           "block"; for 512 byte blocks, a  file  header  can  directly
  1142.           reference 72  data  blocks).    When a file needs to contain
  1143.           more data, additional data blocks are  located  via  one  or
  1144.           more  of  these  extension  blocks, each of which references
  1145.           another group of data blocks.  
  1146.  
  1147.      ROOT 
  1148.           This indicates a root directory block.  Each  partition  has
  1149.           only one   root   block.    However,  if  several  different
  1150.           partitions have been on the same disk  from  time  to  time,
  1151.           it's possible to see a few root blocks reported, since those 
  1152.           from a previous format may still be around.  
  1153.  
  1154.      SLNK 
  1155.           This indicates   a  symbolic  link.    Currently,  Commodore
  1156.           doesn't support the  symbolic  link  conventions  that  were
  1157.           implemented  in AmigaDOS 2.0. However, DiskSalv will attempt
  1158.           to deal with one if encountered.  
  1159.  
  1160.      UDIR 
  1161.           This indicates a "User Directory", a normal subdirectory.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.