home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 10 / Fresh_Fish_10_2352.bin / useful / disk / salv / 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 caus