home *** CD-ROM | disk | FTP | other *** search
/ Amiga Repair Kit / Amiga Repair Kit.iso / UpperDiskTools / Docs / UDT (.txt) < prev   
Encoding:
Final Write Document  |  1996-07-24  |  315.5 KB  |  3,695 lines
  1.  
  2.  
  3.  
  4. Upper 
  5. Disk Tools
  6. for the 
  7. AMIGA
  8. TM
  9.  
  10. Copyright © 1992, 1993
  11.  
  12. Upper Design
  13. TM
  14.  
  15. User Guide
  16.  
  17. Written by
  18. Manuel Lemos
  19.  
  20.  
  21.  
  22.  
  23. Copyright
  24.  
  25. Copyright © 1992, 1993 by 
  26. Upper Design
  27. TM
  28. . All rights reserved. Printed in the United Kingdom. No part of this 
  29. publication may be translated, reproduced, stored in a retrieval system. or 
  30. transmitted, in any form or by any means, electronic, mechanical, photocopying, 
  31. or otherwise, without the prior written permission of the publisher, 
  32. Upper Design
  33. TM
  34. .
  35.  
  36. Disclaimer
  37.  
  38. This product is offered for sale 
  39. as is
  40.  with no representation of fitness for any particular purpose.  No Warranty of 
  41. any kind is either expressed or implied.  The user assumes all risks and 
  42. responsibilities related to its use.  The material within is believed to be 
  43. accurate, but the author and 
  44. Upper Design
  45. TM
  46.  reserve the right to make changes to the software or documentation without 
  47. notice.
  48.  
  49. Trademarks
  50.  
  51. Upper 
  52. Disk Tools
  53. TM
  54. ,
  55.  Recovery
  56. TM
  57.  
  58. , 
  59.  DSBackup
  60. TM
  61. , 
  62. Upper Design
  63. TM
  64.   are trademarks of Manuel Lemos in Portugal and in other countries.
  65.  
  66. AMIGA
  67. TM
  68. ,AmigaDOS and the Amiga logo are trademarks of Commodore-Amiga, Inc. in United 
  69. States of America and in other countries.
  70.  
  71. MS-DOS is a registered trademark of Microsoft Corporation.
  72.  
  73. Macintosh is a registered trademark of Apple Computers.
  74.  
  75. Notice
  76.  
  77. All the programs and documentation included in this package were developed 
  78. using only 
  79. AMIGA
  80. TM
  81.  computers and 
  82. AMIGA
  83. TM
  84.  specific software.
  85.  
  86.  
  87.  
  88.  
  89. Acknowledgements
  90.  
  91. Upper Design
  92.  wishes to thank to all of those that volunteered to help making this project 
  93. possible.  
  94. Upper Design
  95.  wishes to thank in particular to Paul Hammant for his continued support and 
  96. mostly for being the mentor of this project.
  97.  
  98. Special thanks to Michael Sinz, Carolyn Schepner, Randel Jesup, James Cooper,  
  99. Douglas Walker, Nico François and Stefan Becker.
  100.  
  101. Thanks to Sérgio Soares for having drawn the icon images for the programs.
  102.  
  103. Also thanks to all those that helped in the localization of this package's 
  104. programs:
  105. Deutsch
  106. Peter Simons (
  107. simons@peti.GUN.de
  108. )
  109. Thomas Ganter (
  110. ganterth@mathematik.tu-muenchen.de
  111. )
  112. Daniel Amor (
  113. amor@student.uni-tuebingen.de
  114. )
  115. Français
  116. Cedric Beust
  117. Nederlands
  118. Paul Kolenbrander (
  119. boinger@myamy.hacktic.nl
  120. )
  121. Slovenski
  122. Jure Vrhovnik (
  123. Jure.Vrhovnik@ijs.si
  124. )
  125. Dansk
  126. Mark Cassidy
  127. Norsk
  128. Eyvind Bernhardsen (
  129. eyvind@lise.unit.no
  130. )
  131. Svenska
  132. Erik Bergersjoe (
  133. d9erikb@dtek.chalmers.se
  134. ) 
  135.  
  136. And others translators that will help with localization to others languages not 
  137. yet available by the time this manual is being printed.
  138.  
  139. Special fonts design and localization coordination done by:
  140. Daniel Amor
  141. Brain Storm Development
  142. Ludwigstr. 124
  143. 70197 Stuttgart
  144. Germany
  145. Installation
  146.  
  147.     
  148. It is recommend that the first thing that should be done before installing any 
  149. Upper
  150.  Disk Tools
  151.  applications, is to make a backup copy of this package's floppy disk. Despite 
  152. this is not a mandatory procedure, the backup copy should taken to be used as 
  153. the working copy.
  154.  
  155. To make a backup copy of the 
  156. Upper
  157.  Disk Tools
  158.  floppy disk, just use from the Shell the AmigaDOS 
  159. DiskCopy
  160.  command.
  161.  
  162. DiskCopy FROM DF0: to DF0:
  163.  
  164. Consultation of the Amiga's manuals for usage of the shell command 
  165. DiskCopy
  166.   would be essential reading to understand better how to take a backup copy of 
  167. a floppy disk.
  168.  
  169. Although every 
  170. Upper
  171.  Disk Tools
  172.  applications can be started directly from the working copy floppy disk, an 
  173. Installer
  174.  script is provided to let the applications be installed in an hard disk.
  175.  
  176. To install the 
  177. Upper
  178.  Disk Tools
  179.  applications in an hard disk, from the WorkBench, open a drawer named 
  180. Install
  181.  in the working copy of 
  182. Upper
  183.  Disk Tools
  184.  floppy disk. In that drawer there several icons named after several language 
  185. names. To start the installation process,  just double-click any of those icons 
  186. according to your preferred language.
  187.  
  188. You will be prompted to reply to several questions about the way you want the 
  189. Upper
  190.  Disk Tools 
  191. applications to be installed. If the language of the selected icon to start the 
  192. instalation process is already supported by 
  193. Upper
  194.  Disk Tools
  195.  instalation script, the questions you have to reply during installation 
  196. process will appear in that language.
  197.  
  198. If you want to un-install 
  199. Upper
  200.  Disk Tools 
  201. applications later after installed, you only need to delete a directory named 
  202. UDT
  203.  that is created during the installation process.
  204.  
  205. Contents
  206.  
  207. Recovery
  208.  
  209.     
  210. 1
  211.     
  212. Introduction
  213.  
  214.     
  215. 2
  216.     
  217. Quick start
  218.  
  219.     
  220. 4
  221.     
  222. Usage
  223.  
  224.     
  225. 5
  226.     
  227. The user interface window
  228.     
  229. 5
  230.     
  231. Disk scanning related buttons
  232.     
  233. 5
  234.     
  235. Search for files tick boxes
  236.     
  237. 5
  238.     
  239. Search pattern text input box
  240.     
  241. 6
  242.     
  243. Search method cycle button
  244.     
  245. 6
  246.     
  247. Skip read errors tick box
  248.     
  249. 6
  250.     
  251. Before scanning a disk... cycle button
  252.     
  253. 6
  254.     
  255. Scanned drives list view
  256.     
  257. 7
  258.     
  259. Free drive button
  260.     
  261. 7
  262.     
  263. Buffers number input box
  264.  
  265.     
  266. 7
  267.     
  268. Other buttons and menus
  269.     
  270. 7
  271.     
  272. Save button or menu item
  273.     
  274. 7
  275.     
  276. Hide button or menu item
  277.     
  278. 8
  279.     
  280. Help button and menu item
  281.     
  282. 8
  283.     
  284. Quit button or menu item
  285.     
  286. 8
  287.     
  288. About menu item
  289.     
  290. 9
  291.     
  292. Provide icons menu item
  293.     
  294. 9
  295.     
  296. Low memory setup menu item
  297.  
  298.     
  299. 10
  300.     
  301. Scanning a disk
  302.     
  303. 11
  304.     
  305. Search for files
  306.     
  307. 11
  308.     
  309. Search for 
  310. NOT_DELETED_FILES
  311.     
  312. 12
  313.     
  314. Search for 
  315. DELETED_FILES
  316.     
  317. 12
  318.     
  319. Search for 
  320. LOST_FILES
  321.     
  322. 12
  323.     
  324. Search for 
  325. HEADERLESS_FILES
  326.     
  327. 13
  328.     
  329. Scanning 
  330. SEARCH_PATTERN
  331.     
  332. 13
  333.     
  334. Search method
  335.     
  336. 13
  337.     
  338. Fast search method
  339.     
  340. 14
  341.     
  342. Deep search method
  343.     
  344. 15
  345.     
  346. LOCK_DRIVE
  347.     
  348. 15
  349.     
  350. Make the disk unavailable for system use
  351.     
  352. 15
  353.     
  354. Make the disk act as write protected
  355.     
  356. 17
  357.     
  358. SKIP_ERRORS
  359.  while scanning a disk
  360.  
  361.     
  362. 18
  363.     
  364. Device options
  365.     
  366. 18
  367.     
  368. DEVICE_NAME
  369.  
  370. option
  371.     
  372. 18
  373.     
  374. VOLUME_NAME
  375.  option
  376.     
  377. 19
  378.     
  379. BUFFERS
  380.  option
  381.  
  382.     
  383. 21
  384.     
  385. Commodity options
  386.     
  387. 21
  388.     
  389. CX_POPUP
  390.  -  Commodity pop-up option
  391.     
  392. 21
  393.     
  394. CX_POPKEY
  395.  - Commodity pop-up key
  396.     
  397. 22
  398.     
  399. CX_PRIORITY
  400.  - Commodity priority
  401.  
  402.     
  403. 24
  404.     
  405. System options
  406.     
  407. 24
  408.     
  409. Locale 
  410. LANGUAGE
  411.     
  412. 24
  413.     
  414. PUBSCREEN
  415.  - Public screen
  416.     
  417. 25
  418.     
  419. TOOLPRI
  420.  - Tool task priority
  421.  
  422.     
  423. 26
  424.     
  425. Outstanding features
  426.  
  427.     
  428. 31
  429.     
  430. Trouble shooting
  431.     
  432. 32
  433.     
  434. In case of low memory...
  435.     
  436. 32
  437.     
  438. Freeing a scanned drive
  439.     
  440. 33
  441.     
  442. Device In Use
  443.  
  444.     
  445. 34
  446.     
  447. Technical notes
  448.     
  449. 34
  450.     
  451. Workbench support
  452.     
  453. 34
  454.     
  455. Multi language support
  456.     
  457. 35
  458.     
  459. On-line help support
  460.     
  461. 36
  462.     
  463. Memory usage
  464.     
  465. 36
  466.     
  467. Scannable disk types
  468.     
  469. 38
  470.     
  471. Device level reading errors
  472.  
  473.     
  474. 40
  475.     
  476. Concepts
  477.  
  478. DSBackup
  479.  
  480.     
  481. 46
  482.     
  483. Introduction
  484.  
  485.     
  486. 47
  487.     
  488. Usage
  489.  
  490.     
  491. 48
  492.     
  493. Options
  494.  
  495.  
  496. Introduction
  497.  
  498. Recovery
  499.  is a tool that enables the user to retrieve files that have been deleted from 
  500. a disk, or for some reason are unreadable through normal AmigaDOS usage.
  501.  
  502. After analysing a disk, it determines what can be recovered and lets the user 
  503. access the files on the disk and save them to another 
  504. volume
  505. .
  506.  
  507. The files that 
  508. Recovery
  509.  can retrieve, are accessed through an AmigaDOS virtual 
  510. device
  511.  called 
  512. REC:
  513.  (
  514. volume
  515.  name 
  516. Recovery:
  517. ). This can be accessed through the Workbench, from the Shell or from any tool 
  518. capable of reading disk based files.
  519.  
  520. Recovery
  521.  is completely safe to use as no data on the volume in question will be 
  522. modified during its use.  That means that neither 
  523. Recovery
  524.  nor any other application using the drive will be allowed to modify data 
  525. through the use of the 
  526. REC:
  527.  device. If the disk was damaged before, it won't be any worse after using 
  528. Recovery
  529. .
  530. Introduction - 
  531. 1
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567. Recovery
  568.  
  569. -A tool for retrieving deleted files from disks 
  570.  
  571. Quick start
  572.  
  573. Start 
  574. Recovery
  575.  either through the AmigaDOS Shell or from Workbench.
  576.  
  577. Use the Shell, Workbench or your favourite directory utility program to browse 
  578. the directory structure of 
  579. REC:
  580.  
  581. device
  582.  (
  583. Recovery:
  584.  
  585. volume
  586. ). Storage devices that are scanable by 
  587. Recovery
  588.  appear as directories inside the 
  589. REC:
  590. Drives
  591.  directory.
  592.  
  593. If you are using the Shell, it is recommended that you use the AmigaDOS 
  594. Run
  595.  command to start 
  596. Recovery
  597.  as a background program. This allows you to analyse the 
  598. REC:
  599.  
  600. device
  601.  from the same Shell window right after 
  602. Recovery
  603.  is launched.
  604.  
  605. Examining one of the 
  606. drive
  607.  sub-directories within 
  608. REC:Drives
  609.  directory for the first time, will start 
  610. Recovery
  611.  
  612. scanning process
  613.  for the disk in the drive with that name.
  614.  
  615. While this is happening a small window will open showing the progress of the 
  616. scanning procedure. It also shows an estimate of the time remaining for its 
  617. completion.
  618.  
  619. Once scanned, files within that disk that were accessible normally through 
  620. AmigaDOS usage, are listed within a directory named 
  621. Files_in_disk
  622. . Deleted files may be found in either 
  623. Deleted_files
  624.  or 
  625. Lost_files
  626.  directories.
  627.  
  628. Lost files are all of those deleted files for which it was not possible to find 
  629. their respective parent directory. If 
  630. Recovery
  631.  finds any files for which it was not possible to find their file 
  632. header block
  633. , they will appear in 
  634. Headerless_Files
  635.  directory.
  636.  
  637.  
  638.  
  639.  
  640. From this stage, you can do anything with the files that does not involve 
  641. writing data to the actual scanned 
  642. volume
  643. . So, you can read, copy, execute or even archive them and perhaps using a 
  644. backup program to take a backup of any files.
  645.  
  646. When you have finnished all data recovery from the scanned disk, the respective 
  647. drive can be freed for normal system usage. This will also release all the 
  648. other resources allocated during the disk 
  649. scanning process
  650. .
  651.  
  652. See 
  653. Scanning a disk
  654.  and 
  655. Trouble shooting - Freeing a scanned drive 
  656. sections.
  657. Quick start - 
  658. 2
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694. Recovery
  695.  
  696. -A tool for retrieving deleted files from disks 
  697.  
  698. Usage
  699.  
  700. Recovery
  701.  can be started from either the Amiga Shell or the Workbench. Whichever way it 
  702. is started, it can be customised by using certain options.        
  703.  
  704. When started from the Amiga's Command Shell, these options are listed
  705. after name of the program, as in this example:
  706.  
  707. Run Recovery DEVICE=REK VOLUME=REKOVER
  708.  
  709. When started from the Workbench the options are retrieved by 
  710. Recovery
  711.  from its icon.  Use 
  712. Information
  713.  item from Workbench's 
  714. Icons
  715.  menu after having selected 
  716. Recovery
  717. 's Icon.  The options are maintained in the list of 
  718. Tool Types
  719.  in the Information window.
  720.  
  721. Whether 
  722. Recovery
  723.  is used from the Shell or the Workbench, its options have the same name and 
  724. achieve the same effect.  Note that all options names must be of the form 
  725. OPTION NAME=OPTION 
  726. V
  727. ALUE
  728. .
  729.  
  730. Although all options names are long and explicit, they also have shorter alias 
  731. to save on finger wear and tear. The example above showed how 
  732. Recovery
  733.  will set the device name (see later) to 
  734. REK
  735.  when started.  The short name for device is 
  736. DEV
  737. , so 
  738. DEV=REK
  739.  would also have achieved the same thing.
  740.  
  741. Some of the options can be controlled, to a limited degree, while 
  742. Recovery
  743.  is running. 
  744. Recovery
  745.  opens a 
  746. user interface window
  747.  and there are various buttons and gadgets to allow the control of the options. 
  748.  If 
  749. Recovery
  750.  was started from the Workbench, these options can be saved to 
  751. Recovery
  752. 's icon.
  753.  
  754. Recovery
  755.  will use defaults if there are any options missing when it is started.  Most 
  756. of the time 
  757. Recovery
  758. 's options will not need to be changed from the default, so they don't have to 
  759. be specified.
  760. Usage - 
  761. 4
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797. Recovery
  798.  
  799. -A tool for retrieving deleted files from disks 
  800.  
  801. The user interface window 
  802.  
  803. Most of 
  804. Recovery
  805. 's options may be set in the user interface window. Other actions may also be 
  806. started from this window.
  807.  
  808.  
  809. Disk scanning related buttons
  810.  
  811. For more detailed information about the options related with these buttons, see 
  812.  
  813. Scanning a disk
  814.  section.
  815.  
  816. Search for files tick boxes
  817.  
  818. These tick boxes that indicate whether 
  819. Recovery
  820.  will search for the indicated respective type files.
  821.  
  822. See 
  823. Scanning a disk
  824.  - 
  825. NOT_DELETED_FILES, DELETED_FILES, LOST_FILES, HEADERLESS_FILES
  826.  options section.
  827.  
  828. Search pattern text input box
  829.  
  830. This is a box where text should be entered to specify an  AmigaDOS file 
  831. pattern. 
  832. Recovery
  833.  will compare all files it finds with that pattern as it scans a volume. Only 
  834. files that match that pattern available for retrieval. If the pattern is blank, 
  835. then all files will be eligible for retrieval.  The pattern cannot exceed 256 
  836. characters in length. 
  837.  
  838. See 
  839. SEARCH_PATTERN
  840.  option section.
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847. Search method cycle button
  848.  
  849. This button indicates which one of two possible methods 
  850. Recovery
  851.  should use to scan a disk. It can be either a fast search method or a deep 
  852. search method. The deep search method usually takes more memory and time to 
  853. complete.
  854.  
  855. See 
  856. FAST_SEARCH
  857.  option section.
  858.  
  859. Skip read errors tick box
  860.  
  861. This tick box indicates whether 
  862. Recovery
  863.  will automatically skip over damaged disk blocks during the 
  864. scanning process
  865. . If the scanned 
  866. volume
  867.  has many damaged blocks, it is probably best to set this option.
  868.  
  869. See 
  870. SKIP_ERRORS
  871.  option section.
  872.  
  873. Before scanning a disk... cycle button
  874.  
  875. This cycle button determines the availability of the device being scanned to 
  876. other applications. Basically it will prevent that the contents of the disk may 
  877. be changed during the 
  878. scanning process
  879. . It can either make the disk act as write protected or make it unavailable for 
  880. system use.
  881.  
  882. See 
  883. Scanning a disk -
  884.  
  885. LOCK_DRIVE
  886.  option section.
  887.  
  888. Scanned drives list view
  889.  
  890. This list displays all the 
  891. drives
  892.  that 
  893. Recovery
  894.  currently has analised. Selecting one of these drives and clicking on the 
  895. Free drive
  896.  button, will cause that drive to be freed.
  897.  
  898.  
  899.  
  900.  
  901.  
  902. Free drive button
  903.  
  904. This button is used to free any drive selected in the 
  905. Scanned drivcs
  906.  list view. If none is selected, this button will appear disabled.
  907.  
  908. See 
  909. Trouble shooting -Freeing a scanned drive 
  910. sections.
  911.  
  912. Buffers number input box
  913.  
  914. This box indicates the maximum amount of blocks that 
  915. Recovery
  916.  will buffer in memory at the same time to store the most read disk blocks. 
  917. This value affects the performance of 
  918. Recovery
  919.  while scanning a disk as well as while retrieving files from the scanned disk.
  920.  
  921. See
  922.  
  923. BUFFERS
  924.  option section.
  925.  
  926. Other buttons and menus
  927.  
  928. Save button or menu item
  929.  
  930. Use this button or menu item to tell 
  931. Recovery
  932.  to save the current option settings. The options are saved in 
  933. Recovery
  934. 's Workbench icon as tooltypes. Because of this, if 
  935. Recovery
  936.  was not started from Workbench, this option will appear disabled. The next 
  937. time 
  938. Recovery
  939.  is started from Workbench these options will be used automatically.
  940.  
  941. Hide button or menu item
  942.  
  943. This button or menu item option closes the 
  944. Recovery
  945. 's user interface window without quitting the program. Hitting the close window 
  946. button or the Escape key (
  947. Esc
  948. ) also causes 
  949. Recovery
  950.  to hide its user interface window.
  951.  
  952.  
  953.  
  954. The user interface window can be recalled by activating the 
  955. hotkey
  956.  or instructing 
  957. Recovery
  958.  to show its interface using the Amiga's Commodity 
  959. Exchange 
  960. program.
  961.  
  962. See 
  963. Commodity - hot-key
  964.  section.
  965.  
  966. Help button and menu item
  967.  
  968. Use this button or menu option to ask for help. You can also obtain specific 
  969. help about the function of most of the user interfaces's window buttons and 
  970. menu items, by pressing the 
  971. Help
  972.  key and leaving the mouse pointer over the button or menu item about which 
  973. help is being asked.
  974.  
  975. See 
  976. Technical notes - On-line help support
  977. .
  978.  
  979. Quit button or menu item
  980.  
  981. Recovery
  982.  can be instructed to quit by either using the quit button or menu item. If 
  983. Recovery
  984.  was started from the Shell, it can also be told to quit by issuing a 
  985. Break
  986.  AmigaDOS command to its Shell process.
  987.  
  988. When 
  989. Recovery
  990.  is instructed to quit, it first tries to free all scanned drives. It then 
  991. tries to remove the 
  992. REC:
  993.  
  994. device
  995.  from the system and closes user interface window (if opened).
  996.  
  997. Recovery
  998.  sometimes may not exit when requested due to some directories still being 
  999. locked
  1000.  by other applications.
  1001.  
  1002. See 
  1003. Trouble shooting - Device in Use
  1004.  and 
  1005. Freeing a scanned drive 
  1006. sections.
  1007.  
  1008. About menu item
  1009.  
  1010. Use this menu item to tell 
  1011. Recovery
  1012.  to display a window requester that shows both the current version and the 
  1013. revision of the program, as well as showing copyright and author information.
  1014. Provide icons menu item
  1015.  
  1016. This menu option, causes 
  1017. Recovery
  1018.  to provide icon files for all Workbench drawers that appear without one in the 
  1019.  
  1020. REC:
  1021.  device.
  1022.  
  1023. See 
  1024. Technical notes - Workbench support
  1025.  section.
  1026.  
  1027. Low memory setup menu item
  1028.  
  1029. This menu option, causes 
  1030. Recovery
  1031.  to turn off some of its own options so that extra memory can be conserved 
  1032. during the 
  1033. scanning process
  1034. .
  1035.  
  1036. It switches off the 
  1037. scanning
  1038.  of 
  1039. not deleted
  1040.  and  
  1041. headerless
  1042.  files as well reducing the amount of disk block 
  1043. buffers 
  1044. to  a minimum. It also tries to free all scanned drives that are not currently 
  1045. in use.
  1046.  
  1047. Holding any shift key while selecting this menu option, will switch these 
  1048. options on again.
  1049.  
  1050. Setting these options to make 
  1051. Recovery
  1052.  use as less memory as possible, usually severely affects disk scanning 
  1053. performance. But it improves the chances of 
  1054. Recovery 
  1055. being able to succesfully scan a disk in computers short of available memory.
  1056.  
  1057.  See 
  1058. Scanning a disk...
  1059.  and 
  1060. Trouble shooting - Freeing a scanned drive 
  1061. sections.
  1062. Usage - User interface window - 
  1063. 5
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099. Recovery
  1100.  
  1101. -A tool for retrieving deleted files from disks 
  1102.  
  1103. Scanning a disk
  1104.  
  1105. The scanning process is the process by which 
  1106. Recovery
  1107.  analyses a 
  1108. drive
  1109.  for files. It is triggered by scanning one of the directories named after the 
  1110. device name of the drive that is meant to be scanned, that is in the directory 
  1111. REC:Drives
  1112. .
  1113.  
  1114. You can use any kind of directory tool to do this, including the WorkBench or 
  1115. the the Amiga's Shell.
  1116.  
  1117. When started, a scanning progress requester window will appear showing a fuel 
  1118. gauge progress bar and a timer that shows an estimate of the amount of time 
  1119. remaining to the completion of the scanning  process.
  1120.  
  1121. The scanning process can also be suspended or cancelled via the respectively 
  1122. named buttons on that scanning progress window.
  1123.  
  1124. This process can take some time and memory depending upon the amount of files 
  1125. and directories that are found in the 
  1126. volume
  1127. . It can be speeded up or use less memory by changing some of the program's 
  1128. options. See 
  1129. Search method
  1130. .
  1131.  
  1132. There are a few options that are directly related with the scanning process. 
  1133. They can be set either in the 
  1134. user interface window
  1135.  or as 
  1136. Recovery 
  1137. arguments.
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148. Search for files
  1149.  
  1150. Search for 
  1151. NOT_DELETED_FILES
  1152.  
  1153. This option indicates whether 
  1154. Recovery
  1155.  should look for files that have not been deleted. They may be found together 
  1156. in a directory called 
  1157. Files_in_disk
  1158. .
  1159.  
  1160. These files are the ones that are supposedly accessible through the normal 
  1161. AmigaDOS usage. Because of that, searching for those files, may not be 
  1162. necessary. It is therefore recommended that this option should be turned off to 
  1163. conserve memory.
  1164.  
  1165. When the 
  1166. fast search method
  1167.  is used, this option is ignored and its tick box will appear shaded in the 
  1168. user interface window
  1169. , because this method won't look for not deleted files by definition. See 
  1170. Search method
  1171. .
  1172.  
  1173. Option argument name: 
  1174. NOT_DELETED_FILES
  1175. Short name: 
  1176. NDEL
  1177. Valid option values: 
  1178. yes, no
  1179. Default value: 
  1180. yes
  1181. Example: 
  1182. NDEL=no
  1183.  
  1184. Search for 
  1185. DELETED_FILES
  1186.  
  1187. This option indicates whether 
  1188. Recovery
  1189.  should look for deleted files while scanning a 
  1190. drive
  1191. . They may be found together in a directory called 
  1192. Deleted_files
  1193. .
  1194.  
  1195. Note that 
  1196. Recovery
  1197.  may consider a file as deleted, when because of some error, this file is not 
  1198. reachable through normal AmigaDOS usage. This situation may be caused by an 
  1199. unreadable preceding file in the same directory or any of its parent 
  1200. directories.
  1201.  
  1202.  
  1203.  
  1204. Option argument name: 
  1205. DELETED_FILES
  1206. Short name: 
  1207. DEL
  1208. Valid option values: 
  1209. yes, no
  1210. Default value: 
  1211. yes
  1212. Example: 
  1213. DEL=no
  1214.  
  1215. Search for 
  1216. LOST_FILES
  1217.  
  1218. This option indicates whether 
  1219. Recovery
  1220.  should look for deleted files that for some reason it couldn't find all its 
  1221. parent directories. These files are found in a directory called 
  1222. Lost_Files
  1223. .
  1224.  
  1225. If many of these files are found, Workbench may take a long time to sort them 
  1226. before they appear listed in a Workbench drawer window.
  1227. Option argument name: 
  1228. LOST_FILES
  1229. Short name: 
  1230. LOST
  1231. Valid option values: 
  1232. yes, no
  1233. Default value: 
  1234. yes
  1235. Example: 
  1236. LOST=no
  1237.  
  1238. Search for 
  1239. HEADERLESS_FILES
  1240.  
  1241. This option indicates whether 
  1242. Recovery
  1243.  should look for files for which 
  1244. header blocks
  1245.  couldn't be found, when possible.  These files be found in a directory called 
  1246. Headerless_Files
  1247. .
  1248.  
  1249. Searching of these types of files is possible only if the scanned disk was 
  1250. formated as an 
  1251. old file system
  1252.  disk.
  1253.  
  1254. Option argument name: 
  1255. HEADERLESS_FILES
  1256. Short name: 
  1257. HLES
  1258. Valid option values: 
  1259. yes, no
  1260. Default value: 
  1261. yes
  1262. Example: 
  1263. HLES=no
  1264.  
  1265. Scanning 
  1266. SEARCH_PATTERN
  1267.  
  1268. A search pattern causes 
  1269. Recovery 
  1270. to only look for files whose names match the selected pattern. The pattern can 
  1271. have wildcards in it like 
  1272. #?.doc
  1273.  meaning all files that end in 
  1274. doc
  1275. .
  1276.  
  1277. The search pattern only applies to files. Directories are never filtered. If no 
  1278. pattern is supplied, all scanned files will be accessible.
  1279.  
  1280. This option can speed up the scan slightly and facilitate easier finding of the 
  1281. deleted and lost files.
  1282.  
  1283. It can be used to split the search in several scans with the advantage of using 
  1284. less memory for each scan, than when no pattern was supplied.
  1285.  
  1286. Read about file patterns in the AmigaDOS user manual for further information.
  1287.  
  1288. Option argument name: 
  1289. SEARCH_PATTERN
  1290. Short name: 
  1291. PAT
  1292. Valid option values: any valid AmigaDOS pattern with upto 256 characters.
  1293. Default value: no pattern
  1294. Example: 
  1295. PAT=~(#?.info)
  1296.  
  1297.  
  1298. Search method
  1299.  
  1300. To scan a 
  1301. volume
  1302. , 
  1303. Recovery 
  1304. may use one of two search methods: fast search method and the deep search 
  1305. method.
  1306.  
  1307. Fast search method
  1308.  
  1309. Fast search method usually causes a faster scan of the drive but it may under 
  1310. some circumstances not be as complete as a deeper scan.
  1311.  
  1312. This method is based on the idea that if there are files on the 
  1313. volume
  1314.  that are deleted, then the disk blocks that they were using, are marked as 
  1315. available in the disk's 
  1316. bitmap
  1317. .
  1318.  
  1319. With this information, 
  1320. Recovery
  1321.  only has to check those blocks that are available for use, to look for deleted 
  1322. files.  If those blocks were not reused after those files were deleted, it will 
  1323. be possible for 
  1324. Recovery
  1325.  to retrieve the files intact.
  1326.  
  1327. This method turns out to be a much faster method to search for files, but this 
  1328. way 
  1329. Recovery
  1330.  will not look for not-deleted files. This is why the 
  1331. Not deleted
  1332.  button of the user interface window appears shaded when fast search is 
  1333. enabled.
  1334.  
  1335. If for some reason 
  1336. Recovery
  1337.  is not able to find a valid 
  1338. bitmap
  1339.  for the 
  1340. volume
  1341. , the user is prompted to indicate whether the deep search method should be 
  1342. used or the whole process should be cancelled.
  1343.  
  1344. Deep search method
  1345.  
  1346. When using this method, 
  1347. Recovery
  1348.  will look for files in every block of the 
  1349. volume
  1350.  being scanned.
  1351.  
  1352. Scanning a 
  1353. volume
  1354.  using this method, takes more time to complete and it uses more 
  1355. memory
  1356. . Anyway, this is the method to use when searching for files that although were 
  1357. not deleted, for some reason they are not accessible through normal AmigaDOS 
  1358. usage.
  1359.  
  1360. This may happen if any of the file's parent directories are either corrupt or 
  1361. unreadable.
  1362.  
  1363. Option argument name: 
  1364. FAST_SEARCH
  1365. Short name: 
  1366. FAST
  1367. Valid option values: 
  1368. yes, no
  1369. Default value: 
  1370. yes
  1371. Example: 
  1372. FAST=no
  1373. LOCK_DRIVE
  1374.  
  1375. This option selects what 
  1376. Recovery
  1377.  will do before scanning a disk in a drive. It can make the disk either 
  1378. unavailable for system use or make it act as write protected.
  1379.  
  1380. Recovery
  1381.  has to do one of these two actions, to ensure the integrity of the contents of 
  1382. the disk while 
  1383. Recovery
  1384.  is scanning it. This way, any attempt to write any data on it by the system is 
  1385. prevented.
  1386.  
  1387. Make the disk unavailable for system use
  1388.  
  1389. Making the disk unavailable for system use, means that no data can be read from 
  1390. or written to it. Essentially the operating system thinks the media has been 
  1391. removed from its drive (even hard disks).
  1392.  
  1393. This option is meant to ensure 
  1394. Recovery
  1395.  has complete control over the volume being scanned. Other programs won't be 
  1396. able to access the drive while it is being scanned.
  1397.  
  1398. There are no circumstances where 
  1399. Recovery
  1400.  will initiate or allow data modification of the scanned volume.  The scanned 
  1401. drive is always protected from update.
  1402.  
  1403. Make the disk act as write protected
  1404.  
  1405. This option is meant to allow the drive to both be scanned by 
  1406. Recovery
  1407.  and used by any other applications.  Files can be read or executed by other 
  1408. programs while that disk is still on the scanned drives list.
  1409.  
  1410. When the scanned drive that was write protected by 
  1411. Recovery 
  1412. is freed, the disk must be physically write unprotected, to let the AmigaDOS  
  1413. unlock to succeed.
  1414.  
  1415. Read about write protection in the section in the AmigaDOS manual pertaining to 
  1416. the 
  1417. Lock
  1418.  command.
  1419.  
  1420. Note: because of a feature of AmigaDOS's software write protection, it is 
  1421. necessary that the disk in the drive to be scanned is initially write enabled.
  1422.  
  1423. Write protect could have been achieved by moving the appropriate plastic tag on 
  1424. a floppy disk or using the AmigaDOS lock command on any type of disk.  Either 
  1425. way the system needs to believe it to be write enabled before it can be made 
  1426. write protected.
  1427.  
  1428. Note: It is possible that other programs write data in a disk scanned by 
  1429. Recovery
  1430.  overriding these protections. This is done by directly accessing the 
  1431. respective disk 
  1432. trackdisk
  1433.  like 
  1434. exec.library
  1435. 's device .
  1436.  
  1437. Obviously this is not the recommended behaviour for programs, but some 
  1438. utilities like disk formatters and copiers actually do this. Changing the data 
  1439. in a disk this way while 
  1440. Recovery
  1441.  scanning it, may confuse 
  1442. Recovery
  1443. .
  1444.  
  1445. Option argument name: 
  1446. LOCK_DRIVE
  1447. Short name: 
  1448. LOCK
  1449. Valid option values: 
  1450. yes, no
  1451. Default value: 
  1452. yes
  1453. Example: 
  1454. LOCK=no
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469. SKIP_ERRORS
  1470.  while scanning a disk
  1471.  
  1472. During the 
  1473. scanning process
  1474. , 
  1475. device reading errors
  1476.  may happen because of a possibly damaged sector. At this point, the user is 
  1477. prompted to retry reading that faulty sector or or skip over it.
  1478.  
  1479. If a disk is seriously damaged, many of these reading errors may stop the 
  1480. scanning process
  1481. .
  1482.  
  1483. This option allows the user to skip all the 
  1484. reading errors
  1485.  automatically, avoiding so the error requester to pop-up.
  1486.  
  1487. See 
  1488. Technical notes - Device level reading
  1489.  errors section.
  1490.  
  1491. Option argument name: 
  1492. SKIP_ERRORS
  1493. Short name: 
  1494. SERR
  1495. Valid option values: 
  1496. yes, no
  1497. Default value: 
  1498. yes
  1499. Example: 
  1500. SERR=no
  1501. Usage - Scanning a disk - 
  1502. 10
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538. Recovery
  1539.  
  1540. -A tool for retrieving deleted files from disks 
  1541.  
  1542. Device options
  1543.  
  1544. Recovery
  1545.  mounts an AmigaDOS 
  1546. device
  1547.  to provide access to the files it finds in a disk during the 
  1548. scanning process.
  1549.  Some parameters of that device can be set through some of 
  1550. Recovery
  1551. 's options.
  1552.  
  1553. DEVICE_NAME 
  1554. option
  1555.  
  1556. This option determines what name is to be attributed to the 
  1557. device 
  1558. mounted by 
  1559. Recovery
  1560. .
  1561.  
  1562. It can be any name, but it is recommend a name with only three letters in upper 
  1563. case with an optional unit number to be consistent with other AmigaDOS device 
  1564. names and to save type work to Shell users.
  1565.  
  1566. Option argument name: 
  1567. DEVICE_NAME
  1568. Short name: 
  1569. DEV
  1570. Valid option values: any sequence upto 30 characters except for characters 
  1571. :
  1572.  and 
  1573. /
  1574. .
  1575. Default value: 
  1576. REC
  1577. Example: 
  1578. DEV=DEL0
  1579.  
  1580. VOLUME_NAME
  1581.  option
  1582.  
  1583. This option determines what name is to attributed to the 
  1584. volume
  1585.  of the 
  1586. device 
  1587. mounted by 
  1588. Recovery
  1589. .
  1590.  
  1591. It can be any name, but it is recommend a name with any continuous sequence of 
  1592. letters.
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599. Option argument name: 
  1600. VOLUME_NAME
  1601. Short name: 
  1602. VOL
  1603. Valid option values: any sequence upto 30 characters except for characters 
  1604. :
  1605.  and 
  1606. /
  1607. .
  1608. Default value: 
  1609. Recovery
  1610. Example: 
  1611. VOL=Retrieval
  1612.  
  1613. BUFFERS
  1614.  option
  1615.  
  1616. This option determines the amount of buffers AmigaDOS is to attribute to the 
  1617. REC:
  1618.  
  1619. device
  1620.  whilst running. Generally speaking the more the better (up to a limit). Note 
  1621. that the more buffers that a 
  1622. device
  1623.  uses the less is available in terms of free memory to the system.
  1624.  
  1625. The memory size allocated for each buffer is the same as the size of the disk 
  1626. block. Although each disk block size may vary, it usually is 512 bytes large 
  1627. which the byte size of a sector for many types of disks. Since AmigaDOS 3.1 it 
  1628. is possible to have blocks that occupy more that one sector.
  1629.  
  1630. The number of buffers for 
  1631. Recovery
  1632.  can be specified either in the tooltypes, the user interface window and even 
  1633. by using the AmigaDOS Shell command 
  1634. AddBuffers
  1635. .
  1636.  
  1637. The minimum amount of buffers is 2. If a smaller amount is specified, 
  1638. Recovery
  1639.  will use a number of buffers equivalent to the number of disk blocks that fit 
  1640. into track for each disk being scanned.
  1641.  
  1642. The amount of buffers used is only allocated before each 
  1643. device
  1644.  is scanned. They will only be freed, when the scanned drive is freed also.
  1645.  
  1646. If there isn't enough memory to allocate the specified number of buffers, 
  1647. Recovery
  1648.  will try to allocate a smaller number till it finds an amount for which there 
  1649. is enough memory.
  1650.  
  1651.  
  1652.  
  1653. If you want to tell 
  1654. Recovery 
  1655. to allocate the largest possible amount of buffers in order to improve scanning 
  1656. performance, just specify a very large number, e.g. 1000000.
  1657.  
  1658. Consultation of the Amiga's manuals for usage of the shell command 
  1659. AddBuffers
  1660.  would be essential reading before changing this parameter.
  1661.  
  1662. Option argument name: 
  1663. BUFFERS
  1664. Short name: 
  1665. BUF
  1666. Valid option values: 0 or any value higher than 1.
  1667. Default value: 
  1668. 0
  1669. Example: 
  1670. BUF=100
  1671.  
  1672. Usage - Device options - 
  1673. 18
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709. Recovery
  1710.  
  1711. -A tool for retrieving deleted files from disks 
  1712.  
  1713. Commodity options
  1714.  
  1715. Commodities are programs that intercept user input. 
  1716. Recovery
  1717.  also acts as a commodity to determine when its 
  1718. hot-key
  1719.  was pressed. When the user presses the 
  1720. hot-key
  1721. , 
  1722. Recovery
  1723. 's user interface window will pop-up.
  1724.  
  1725. Recovery
  1726.  works in the same way as any system commodity. This means that it has options 
  1727. with standard names for commodity options. It can also be controlled through a 
  1728. commodity window interface which is actually the same as the 
  1729. Recovery
  1730. 's user interface window.
  1731.  
  1732. These options control the way that 
  1733. Recovery
  1734.  interfaces with the Commodities part of the Amiga's operating system.
  1735.  
  1736. CX_POPUP
  1737.  -  Commodity pop-up option
  1738.  
  1739. This option determines whether 
  1740. Recovery
  1741.  will show its window when started. 
  1742. yes
  1743.  will cause the window to appear and 
  1744. no
  1745.  will cause 
  1746. Recovery
  1747.  to run in hidden mode when started.
  1748.  
  1749. Option argument name: 
  1750. CX_POPUP
  1751. Short name: 
  1752. POP
  1753. Valid option values: 
  1754. yes, no
  1755. Default value: 
  1756. yes
  1757. Example: 
  1758. POP=no
  1759.  
  1760. CX_POPKEY
  1761.  - Commodity pop-up key
  1762.  
  1763. This option determines which 
  1764. key
  1765.  will cause 
  1766. Recovery
  1767.  to show its commodity window interface. This may cause the window to open if 
  1768. previously closed or to come to the front if previously covered by other 
  1769. windows or not being displayed in the current front screen.
  1770.  
  1771.  
  1772.  
  1773. The 
  1774. key
  1775.  is usually a combination of keys. This can be changed if it clashes with 
  1776. another commodity 
  1777. hot-key
  1778.  or if a different combination of keys is preffered.
  1779.  
  1780. If an invalid combination is specified for the pop-up key, 
  1781. Recovery
  1782.  will revert to its default pop-up key without issuing an error message to the 
  1783. user. The pop-up key that has been used by 
  1784. Recovery
  1785.  is shown in the title of the user interface window.
  1786.  
  1787. If for some reason you forget what was the 
  1788. hot-key
  1789.  used to pop-up the commodity window interface, you can use the Amiga system's 
  1790. commodity 
  1791. Exchange
  1792.  tool to signal 
  1793. Recovery
  1794.  to show its interface or simply run 
  1795. Recovery
  1796.  again.
  1797.  
  1798. Consultation of the Amiga's manuals will yield further insight into the usage 
  1799. of 
  1800. hot-keys
  1801. .
  1802.  
  1803. Option argument name: 
  1804. CX_POPKEY
  1805. Short name: 
  1806. KEY
  1807. Valid option values: any valid combination of keys.
  1808. Default value: 
  1809. control alt r
  1810. Example: 
  1811. KEY=lcommand shift 0
  1812.  
  1813. CX_PRIORITY
  1814.  - Commodity priority
  1815.  
  1816. Commodity programs are notified about user input by the system. All the 
  1817. commodities running are notified one after another acording to an order. That 
  1818. order is determined by each commodity's priority value.
  1819.  
  1820. This options determines 
  1821. Recovery
  1822. 's own commodity prority value. Commodities with higher priorities are able to 
  1823. intercept input before others with lower priorities.
  1824.  
  1825. Commodities like 
  1826. Recovery
  1827.  filter the kind that they are meant to intercept. In 
  1828. Recovery
  1829. 's case it is its 
  1830. hot-key.
  1831.  Commodities with lower priority will never know about same kind of input.
  1832. Consultation of the Amiga's manuals will yield further insight into the usage 
  1833. of 
  1834. priorities
  1835. .
  1836.  
  1837. Option argument name: 
  1838. CX_PRIORITY
  1839. Short name: 
  1840. CX_PRI
  1841. Valid option values: any value between -127 and 128
  1842. Default value: 
  1843. 0
  1844. Example: 
  1845. CX_PRI=10
  1846. Usage - Commodity - 
  1847. 21
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883. Recovery
  1884.  
  1885. -A tool for retrieving deleted files from disks 
  1886.  
  1887. System options
  1888.  
  1889. Recovery
  1890.  has several options to control the way it interface to the operating system.
  1891.  
  1892. Locale 
  1893. LANGUAGE
  1894.  
  1895. Recovery
  1896.  is fully localized, and it is ready be used in any of the supported languages. 
  1897. This means that the all the text that the program displays can appear in 
  1898. several different languages.
  1899.  
  1900. Use the Locale system preference editor to select the default languages. If 
  1901. Recovery
  1902.  doesn't yet support the selected language, the default built-in language will 
  1903. be used.
  1904.  
  1905. System localization support was only introduced in AmigaDOS V2.1. This 
  1906. LANGUAGE
  1907.  
  1908. option is meant only to specify the language to be used when system 
  1909. localization support is not available. Otherwise this option will be ignored.
  1910.  
  1911. See 
  1912. Technical notes - Locale 
  1913.  
  1914. LANGUAGE 
  1915. support
  1916. .
  1917.  
  1918. Option argument name: 
  1919. LANGUAGE
  1920. Short name: 
  1921. LANG
  1922. Valid option values: any language of the currently supported
  1923. Default value: no language, built-in default is used (english).
  1924. Example: 
  1925. LANG=deutsch
  1926.  
  1927. PUBSCREEN
  1928.  - Public screen
  1929.  
  1930. This option tells
  1931.  Recovery
  1932.  the name of a public screen where its windows will be opened.
  1933.  
  1934. If no name is supplied for this option or for some reason it was not possible 
  1935. to open a window in that screen or there is no screen with the suplied name, 
  1936. Recovery
  1937.  will open its windows in the default public screen which is usually the 
  1938. Workbench screen.
  1939.  
  1940. Option argument name: 
  1941. PUBSCREEN
  1942. Short name: 
  1943. SCR
  1944. Valid option values: any currently opened public screen name
  1945. Default value: no public screen name, Workbench screen is used
  1946. Example: 
  1947. SCR=My public screen
  1948.  
  1949. TOOLPRI
  1950.  - Tool task priority
  1951.  
  1952. The task priority value is used to arbitrate in a multi-tasking system like 
  1953. Amiga's, which task preferencially gets to use the CPU. This means that if a 
  1954. task has a certain priority, all the remaining tasks that have lower priority 
  1955. will have to wait till that first task ends its job or goes to sleep.
  1956.  
  1957. Applications usually run with priority 0. If you set this option to an higher 
  1958. value, 
  1959. Recovery
  1960.  will have most of the time the CPU preference over tasks with lower priority 
  1961. till goes to sleep.
  1962.  
  1963. Saying that a task goes to sleep, means that it will be waiting for the system 
  1964. to send it a signal telling it that some event that it was waiting for has just 
  1965. happened. This is the case when for instance, a program is waiting for the user 
  1966. to act upon the user interface window or some data to be read from a disk.
  1967.  
  1968. This options determines what priority 
  1969. Recovery 
  1970. task will run at. It is not very important and was only provided to be 
  1971. consistent with other tools that have the same option. Since the default for 
  1972. the priority is already 0, it is not important to change it.
  1973.  
  1974. Option argument name: 
  1975. TOOLPRI
  1976. Short name: 
  1977. PRI
  1978. Valid option values: any value between -128 and 127
  1979. Default value: 
  1980. 0
  1981. Example: 
  1982. PRI=20
  1983. Usage - System options - 
  1984. 24
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020. Recovery
  2021.  
  2022. -A tool for retrieving deleted files from disks 
  2023.  
  2024. Outstanding features
  2025.  
  2026. Recovery never modifies the disk being scanned
  2027.  
  2028. Recovery
  2029.  is absolutely safe to use as it never alters data on the 
  2030. volume
  2031.  being scanned, nor allows any other application to modify data on the 
  2032. volume
  2033.  while 
  2034. Recovery
  2035.  is scanning it.
  2036.  
  2037. This was done to both inspire trust in the user and provide failsafe access to 
  2038. a possibly damaged disk.
  2039.  
  2040. See 
  2041. Scanning a disk - Lock drive
  2042.  section.
  2043.  
  2044. Use your favourite file management tool
  2045.  
  2046. The main advantage of 
  2047. Recovery
  2048. , is its ability to act as an intermediate 
  2049. device
  2050. , between any standard Amiga application and the actual storage units.
  2051.  
  2052. Since this is achieved using a virtual AmigaDOS 
  2053. device
  2054. , that provides access to all the scanned files in a transparent way, the user 
  2055. can still do any thing with those files except for write actions. Files can be 
  2056. read, copied or even executed in a transparent way, as from a normal 
  2057. volume
  2058. .
  2059.  
  2060. This facilitates the use of the Workbench, the Shell or any kind of directory 
  2061. utility, for the exploration and recovery of files. Other programs can 
  2062. co-operate in the file recovery process, e.g. backup programs which allow very 
  2063. large files to be recovered to anywhere else, very easily.
  2064.  
  2065. Using 
  2066. Recovery
  2067.  and a hard disk backup program it would be possible to safely recover a file 
  2068. that is larger than any one floppy disk.  This is possible as most backup 
  2069. programs will split the file over many floppies.
  2070.  
  2071.  
  2072.  
  2073. Another important consequence of this, is that it is possible (and very easy) 
  2074. to recover files or even whole directory structures to another computer in the 
  2075. computer's network.  Of course, both computers have to be in the same network.
  2076.  
  2077. Support for the newer filesystems
  2078.  
  2079. Recovery
  2080.  also retrieves data from the newer versions of the filesystem like 
  2081. International and Directory Cached.  This allows disks formated in any of the 
  2082. newer file systems, to be read in a transparent way, even if the version of the 
  2083. system on which 
  2084. Recovery
  2085.  is being run, does not support those file systems.
  2086.  
  2087. Recovery
  2088.  also supports and scans disks which use multiple sectors per block. This 
  2089. feature was introduced in AmigaDOS version 3.1 (V40).
  2090.  
  2091. See 
  2092. Technical notes -Scannable disk types
  2093.  section.
  2094.  
  2095. Headerless files can be recovered
  2096.  
  2097. Recovery
  2098.  can also search for files which their 
  2099. headers blocks
  2100.  had been wiped or are unreadable because of some error. Headerless files can 
  2101. be scanned for, if the 
  2102. file system
  2103.  used in the disk is one of the versions of the old 
  2104. file system
  2105. . This includes the newer variants International and Directory Cached.
  2106.  
  2107. See 
  2108. Scanning a disk - Search for headerless files
  2109.  section.
  2110.  
  2111. Scanning progress is shown
  2112.  
  2113. While a disk in a drive is being scanned, 
  2114. Recovery 
  2115. always gives the user an idea of how much of the disk has already been scanned 
  2116. by means of a fuel guage.  There is also a percentage indicator and a timer 
  2117. that shows an estimate of the remaining time to the end of the scanning 
  2118. procedure.
  2119.  
  2120. See 
  2121. Scanning a disk
  2122.  section.
  2123. Fast search method
  2124.  
  2125. Recovery
  2126.  can use when possible, a 
  2127. fast search
  2128.  method that only searches for files in a disk's free blocks, where the deleted 
  2129. files are most likely to be found. 
  2130.  
  2131. See 
  2132. Scanning a disk - Search method
  2133.  section.
  2134.  
  2135. Very low disk access overhead
  2136.  
  2137. Recovery
  2138.  
  2139. buffers
  2140.  the most frequently read blocks, while both scanning a disk or reading file 
  2141. data from it.  This reduces to a minimum the disk access and preserves memory. 
  2142.  
  2143. See 
  2144. Scanning a disk - Device options Buffers option
  2145.  section.
  2146.  
  2147. Drives being scanned can still be available for use
  2148.  
  2149. Recovery
  2150.  can optionally be set to not inhibit the use of a device while scanning is in 
  2151. progress. Though this still precludes writing data to that device, reading from 
  2152. it can continue as if 
  2153. Recovery
  2154.  had never been started.
  2155.  
  2156. See 
  2157. Scanning a disk - Lock drive
  2158.  section.
  2159.  
  2160. Recovery can run under arduous memory conditions
  2161.  
  2162. Options can be set before scanning to cause 
  2163. Recovery
  2164.  to use the minimum of available system memory.
  2165.  
  2166. If the computer has enough memory, the options can be set to make the scanning 
  2167. process faster.
  2168.  
  2169. See 
  2170. Technical notes - Memory usage
  2171.  section.
  2172.  
  2173.  
  2174.  
  2175. On-line Help
  2176.  
  2177. Recovery
  2178.  provides on-line help to most of its window buttons and menus. Help buttons, 
  2179. also appear in requesters where an important decision has to be made.
  2180.  
  2181. See 
  2182. Technical notes - On-line help support
  2183.  section.
  2184.  
  2185. Localization
  2186.  
  2187. Recovery
  2188.  is fully localized even when run in system with earlier than Amiga OS 2.1. So 
  2189. it is ready be used in any country with any of the supported languages.
  2190.  
  2191. See 
  2192. Technical  notes - Multi language support
  2193.  section.
  2194.  
  2195.  
  2196. Limitations
  2197.  
  2198. Recovery
  2199.  can only retrieve files from 
  2200. track based disks
  2201.  like floppies, hard disks, etc...  but not from sequentially read storage 
  2202. devices like tape streamers, nor virtual dynamic 
  2203. devices
  2204.  like the Amiga's 
  2205. Ram Disk
  2206. .
  2207.  
  2208. Recovery 
  2209. doesn't try to retrieve data from corrupt portions of a disk. If while scanning 
  2210. a disk, 
  2211. Recovery
  2212.  encounters an unreadable block, a requester will open on screen. Via this 
  2213. requester the user can instruct 
  2214. Recovery
  2215.  to skip the faulty block or abort the scan.
  2216.  
  2217. Recovery
  2218.  cannot retrieve deleted files when AmigaDOS has reused the space they occupied 
  2219. on the disk. If a file is accidentally deleted then 
  2220. Recovery
  2221.  should be started without delay!
  2222.  
  2223.  
  2224.  
  2225.  
  2226. In disks formated with 
  2227. old file system,
  2228.  file blocks have redundant information, that makes possible to double check if 
  2229. that block really belongs to the file as well the data in that block is 
  2230. corrupt. In disks formated with 
  2231. fast file system
  2232. , each block is completely filled with the file data and so this redundant 
  2233. information is no longer available. Because of this, it is not possible to 
  2234. check if a 
  2235. fast file system
  2236.  disk block was corrupted. This is also the reason why 
  2237. Recovery
  2238.  can't find any 
  2239. headerless files
  2240.  in 
  2241. fast file system 
  2242. formated disks.
  2243.  
  2244. Recovery
  2245.  uses the available memory to store information about scanned files. There can 
  2246. be problems during the 
  2247. scanning process
  2248.  if there are too many files and too little memory to store information in. In 
  2249. this scenario, 
  2250. Recovery
  2251.  can be set to conserve as much memory as possible.
  2252.  
  2253. See 
  2254. User interface window - Low memory setup
  2255.  section.
  2256.  
  2257. Recovery
  2258.  currently ignores any scanned file or directory link blocks, as these are just 
  2259. blocks that contain reference to the real file or directory 
  2260. header block
  2261.  that is somewhere else in the disk.
  2262.  
  2263. Recovery
  2264.  also doesn't try to correct a problem with Workbench, still present in all 
  2265. versions upto 3.1, where it doesn't check if a directory really exists when it 
  2266. finds its drawer icon file alone.
  2267. Outstanding features - 
  2268. 26
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304. Recovery
  2305.  
  2306. -A tool for retrieving deleted files from disks 
  2307.  
  2308. Trouble shooting
  2309.  
  2310. Q.
  2311.   What should I do when 
  2312. Recovery
  2313.  says that the disk scanning operation failed with a 
  2314. Not enough memory available!
  2315.  message?
  2316. A.
  2317.   See the 
  2318. User interface window - Low memory setup
  2319.  and 
  2320. Technical notes - Memory usage
  2321.  sections.
  2322.  
  2323. Q.
  2324.   How do I free a drive when I have finished scanning it with 
  2325. Recovery
  2326. ?
  2327. A.
  2328.   See the 
  2329. Freeing a drive
  2330.  section.
  2331.  
  2332. Q.
  2333.   What should I do if 
  2334. Recovery
  2335.  says that the drive I want to free is still being used?
  2336. A.
  2337.   See the 
  2338. Device in use
  2339.  section.
  2340.  
  2341. Q.
  2342.   How do I quit 
  2343. Recovery
  2344. ?
  2345. A.
  2346.   See 
  2347. User interface window - Quit button and menu item
  2348.  section.
  2349.  
  2350. Q.
  2351.   What should I do if I forget the hot key used to pop-up the 
  2352. Recovery
  2353.  commodity interface?
  2354. A.
  2355.   See 
  2356. Usage - 
  2357. CX_POPKEY
  2358.  - Commodity pop-up key
  2359.  section.
  2360.  
  2361. Q.
  2362.   What should I do if 
  2363. Recovery
  2364.  says that the disk in the drive is write protected?
  2365. A.
  2366.   See 
  2367. Usage - 
  2368. LOCK_DRIVE 
  2369. section.
  2370.  
  2371. Q.
  2372.   What should I do 
  2373. Recovery
  2374.  says that it couldn't find a valid disk type identifier?
  2375. A.
  2376.   See the 
  2377. Technical notes - Scannable disk types
  2378.  section.
  2379.  
  2380. Q.
  2381.   What should I do if it seems there isn't any deleted files although the 
  2382. Deleted_files
  2383.  or 
  2384. Lost_files
  2385.  Workbench drawers still appear?
  2386. A.
  2387.   Sometimes a file or a directory may have been deleted but its icon file may 
  2388. not exist or simply might not appear as deleted. Make sure that the Workbench 
  2389. shows all files in the current drawer you are examining. See your Workbench 
  2390. manual.
  2391. In case of low memory...
  2392.  
  2393. If your computer runs out of memory during the scanning process, you can gain 
  2394. extra memory by freeing any previously scanned drives. See about 
  2395. free drive
  2396.  interface function.
  2397.  
  2398. If you still encounter memory problems, you can switch off some search options 
  2399. to again decrease the memory that 
  2400. Recovery
  2401.  will need. You can do this easily by selecting (from the user interface window 
  2402. options menu) the 
  2403. Low memory setup
  2404.  menu option. If 
  2405. Recovery
  2406.  still has problem completing a scan due to the lack of available memory then 
  2407. you can always split the retrieval of files in two or more parts, by using 
  2408. different 
  2409. search file patterns
  2410.  each time the disk is scanned.
  2411.  
  2412. For instance you can set the search pattern to 
  2413. [a-l]#?
  2414.  for the first scan (and recover any necessary files) and for a second scan you 
  2415. can use the opposite search pattern to recover any remaining files with 
  2416. ~([a-l]#?)
  2417.  as search pattern. 
  2418.  
  2419. Freeing a scanned drive
  2420.  
  2421. When data recovery is complete, the drive can be freed for normal system usage 
  2422. by one of three possible methods:
  2423.  
  2424. - In the user interface window, select the respective drive in the 
  2425. Scanned drives
  2426.  list view, and then push the 
  2427. Free drive 
  2428. button.
  2429.  
  2430. - In the 
  2431. REC:Scanned_Drives
  2432.  directory, delete the file with the same name of drive to be freed.
  2433.  
  2434. - 
  2435. Quit
  2436.  
  2437. Recovery
  2438. .
  2439.  
  2440. Recovery
  2441.  can only free a drive when it is no longer being used by other applications 
  2442. through 
  2443. REC:
  2444.  
  2445. device
  2446. .
  2447.  
  2448. Make sure if the scanned disk was software 
  2449. write protected
  2450.  by 
  2451. Recovery
  2452.  before it was scanned, it is then physically unprotected or else the system 
  2453. won't unprotect it.
  2454.  
  2455. If 
  2456. Recovery
  2457.  is being run on an Amiga running Amiga OS 3 or higher, and the system 
  2458. encounters a low memory situation, 
  2459. Recovery
  2460.  will try to free all the scanned drives that are not being used without 
  2461. informing the user. Using the 
  2462. low memory setup
  2463.  menu item, also makes 
  2464. Recovery
  2465.  to try to free all scanned drives.
  2466.  
  2467.  See 
  2468. Scanning a disk - Lock drive
  2469. , 
  2470. Device in use
  2471.  and 
  2472. User Interface window - Low memory setup
  2473.  sections.
  2474.  
  2475. Device In Use
  2476.  
  2477. Any program that has a 
  2478. lock
  2479.  on the directory created by 
  2480. Recovery
  2481.  in 
  2482. REC:Drives
  2483.  will prevent that drive being freed.
  2484.  
  2485. The Workbench via its open windows, the Shell via its current directory, or 
  2486. other programs that can list a, read from, or save to a directory will 
  2487. lock
  2488.  the last one used. This is sufficient to stop 
  2489. Recovery
  2490.  freeing a drive.
  2491.  
  2492. All windows pertaining to 
  2493. REC:Drives/xxx
  2494.  where 
  2495. xxx
  2496.  is the drive in question and below must be closed. All Shell processes must be 
  2497. set to have another device or volume as their current directory or must be 
  2498. quit. The same is true of other applications.  If in doubt then quitting 
  2499. applications you think are locking the drive should free all the locks on it.
  2500.  
  2501. It is possible that a faulty application may retain a 
  2502. lock
  2503.  for file or a directory from 
  2504. REC:
  2505.  device after it has exited or crashed. This will effectively prevent Recovery 
  2506. from quitting.
  2507. Trouble shooting - 
  2508. 31
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544. Recovery
  2545.  
  2546. -A tool for retrieving deleted files from disks 
  2547.  
  2548. Technical notes
  2549.  
  2550. Workbench support
  2551.  
  2552. To support Workbench, 
  2553. Recovery
  2554.  provides icons for directories and files that it creates in the 
  2555. Recovery:
  2556.  
  2557. volume 
  2558. .
  2559.  
  2560. This facility can be controlled with the option 
  2561. PROVIDE_ICONS
  2562. . This option can be also set in the user interface window 
  2563. Options
  2564.  menu.
  2565.  
  2566. Recovery
  2567.  searches through directories for these icon files in the following order: 
  2568. PROGDIR:Icons/
  2569. , 
  2570. ENV:sys/
  2571. , 
  2572. ENVARC:sys/
  2573.  where 
  2574. PROGDIR:
  2575.  is the directory path of 
  2576. Recovery
  2577.  program file.
  2578.  
  2579. Recovery
  2580.  tries to find icons with the names 
  2581. def_Disk.info
  2582.  for the 
  2583. volume
  2584.  icon, 
  2585. def_Drawer.info
  2586.  for drawer icon and 
  2587. def_Project.info
  2588.  for project icons.
  2589.  
  2590. If no icons files where found in the above directories then 
  2591. Recovery
  2592.  will use built in icon images.
  2593.  
  2594. Multi language support
  2595.  
  2596. Recovery
  2597.  supports language localization using Amiga standard methods, in all supported 
  2598. versions of Amiga operating system.
  2599.  
  2600. Although localization was only introduced in Amiga OS version 2.1, localization 
  2601. is still available if 
  2602. Recovery
  2603.  is run within earlier versions of the OS. In this case, the user's preferred 
  2604. language must be specified with the 
  2605. LANGUAGE
  2606.  option, or else the built-in default language will be used.
  2607.  
  2608. For each of the supported languages, there is the respective catalog file in a 
  2609. sub-directory in the same directory where 
  2610. Recovery
  2611.  is started. The path is:
  2612. PROGDIR:Catalogs/
  2613. LANGUAGE
  2614. /Recovery.catalog.
  2615. The 
  2616. LANGUAGE
  2617.  directory name is the same as the 
  2618. Recovery
  2619. 's 
  2620. LANGUAGE
  2621.  option or the selected locale language system preferences. If for instance the 
  2622.  
  2623. LANGUAGE
  2624.  was set to 
  2625. deutsch
  2626.  then the corresponding catalog file must be found in either the following 
  2627. paths:
  2628.  
  2629. PROGDIR:Catalogs/deutsch
  2630. LOCALE:Catalogs/deutsch
  2631.  
  2632. The installation procedure doesn't put the language catalog files in this last 
  2633. path.
  2634.  
  2635. See 
  2636. System options - Locale language
  2637. .
  2638.  
  2639. On-line help support
  2640.  
  2641. Recovery
  2642.  uses AmigaGuide hypertext system to provide context dependant on-line help. 
  2643. On-line is also localized.
  2644.  
  2645. Besides help buttons and the help menu item, it is possible to have context 
  2646. dependant help by pressing the 
  2647. Help
  2648.  key with the mouse pointer over a button, gadget or menu item in the user 
  2649. interface window.
  2650.  
  2651. If for some reason AmigaGuide is not available, alternative information windows 
  2652. will appear instead.
  2653.  
  2654. AmigaGuide based on-line help support will only work if at least version 33 of 
  2655. amigaguide.library
  2656.  is available. Use AmigaDOS command 
  2657. Version amigaguide.library
  2658.  to check what if and what version of AmigaGuide is available.
  2659.  
  2660. The normal 
  2661. Recovery
  2662.  installation procedure tries to install the AmigaGuide if it is not currently 
  2663. installed.
  2664.  
  2665.  
  2666.  
  2667. Memory usage
  2668.  
  2669. Recovery
  2670.  uses an amount of available memory to store information about the scanned 
  2671. files and directories on a drive.  The amount of memory used is more or less in 
  2672. proportion to the size of the disk.
  2673.  
  2674. It is recommended that the user should partition the hard disk in such a way as 
  2675. to ease the later use of 
  2676. Recovery
  2677.  if a file has accidentally been deleted.
  2678.  
  2679. Although 
  2680. Recovery
  2681. 's memory usage depends mostly on the number files and directories the user has 
  2682. stored in a disk, partitioning a hard disk into smaller, more manageable, 
  2683. chunks will limit the number of files and directories that can be fitted into 
  2684. each partition and hence speed up the scanning process taking less memory to 
  2685. hold the scanned disk's directory tree.
  2686.  
  2687. Most of the options available through the 
  2688. Recovery
  2689.  user interface window, are meant to allow the user to limit program memory 
  2690. usage. Use 
  2691. Low memory setup
  2692.  menu option to switch off some options to minimize memory usage.
  2693.  
  2694. See 
  2695. User interface window - Low memory setup
  2696.  section.
  2697.  
  2698. If 
  2699. Recovery
  2700.  is being run in a computer with Amiga OS 3 or higher, and the system is low in 
  2701. memory 
  2702. Recovery
  2703.  will try to free all the scanned drives that are not being used.
  2704.  
  2705. Scannable disk types
  2706.  
  2707. Currently, 
  2708. Recovery
  2709.  is only able to scan disks which are of AmigaDOS type. It determines that disk 
  2710. type by reading some special reserved sectors at the beginning of the disk or 
  2711. partition being scanned.
  2712.  
  2713. The type identifier consists of 4 bytes forming a longword, that are the first 
  2714. bytes of those reserved sectors.
  2715.  
  2716. An AmigaDOS disk type identifier must have the first 3 bytes with the letters 
  2717. 'D', 'O' and 'S' respectively. The last letter is used to determine the type of 
  2718. the 
  2719. file system
  2720.  used in the disk.
  2721.  
  2722. In general, if the number in this fourth byte is even, the 
  2723. file system 
  2724. is the old file system, if it's odd it is the fast file system.
  2725.  
  2726. So we have:
  2727. 'D', 'O', 'S', 0 - Original old file system
  2728. 'D', 'O', 'S', 1 - Original fast file system
  2729. 'D', 'O', 'S', 2 - International old file system
  2730. 'D', 'O', 'S', 3 - International fast file system
  2731. 'D', 'O', 'S', 4 - Directory cached old file system
  2732. 'D', 'O', 'S', 5 - Directory cached fast file system
  2733.  
  2734. If the first reserved sector is unreadable or the disk type identifier was none 
  2735. of those shown above, a requester will appear, prompting the user to indicate 
  2736. whether old file system or fast file system should be assumed as the disk file 
  2737. system.
  2738.  
  2739. Both could be tried, but only one is right. If the wrong one is chosen, files 
  2740. may appear as corrupted. In that case, the disk should be rescanned, but the 
  2741. other file system should be selected when asked again.
  2742.  
  2743. If 
  2744. Recovery
  2745.  says that an unknown disk type identifier was found, it is not very likely 
  2746. that the disk is an AmigaDOS disk and most probably no files will appear. This 
  2747. may still occur though, as the first disk block may have been corrupted but not 
  2748. the rest of the disk.
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756. Device level reading errors
  2757.  
  2758. Recovery
  2759.  uses Amiga 
  2760. exec.library
  2761.  functions to read each device to be scanned. It is assumed that each disk or 
  2762. partition's associated Exec device behaves like the 
  2763. trackdisk.device
  2764. .
  2765.  
  2766. All the device reading error numbers that 
  2767. Recovery
  2768.  reports, are also assumed to mean the same as if the drive being access is 
  2769. like a 
  2770. trackdisk.device
  2771.  based floppy.
  2772.  
  2773. The meaning of those errors is listed here as quoted from the programming 
  2774. include files 
  2775. <devices/trackdisk.h>
  2776.  and 
  2777. <exec/errors.h>
  2778. .
  2779.  
  2780. Name
  2781.     
  2782. no.
  2783.     
  2784. short description
  2785.  
  2786. TDERR_NotSpecified
  2787.     
  2788. 20
  2789.     
  2790. general catchall
  2791. TDERR_NoSecHdr
  2792.     
  2793. 21
  2794.     
  2795. couldn't even find a sector
  2796. TDERR_BadSecPreamble
  2797.     
  2798. 22
  2799.     
  2800. sector looked wrong
  2801. TDERR_BadSecID
  2802.     
  2803. 23
  2804.     
  2805. ditto
  2806. TDERR_BadHdrSum
  2807.     
  2808. 24
  2809.     
  2810. header had incorrect checksum
  2811. TDERR_BadSecSum
  2812.     
  2813. 25
  2814.     
  2815. data had incorrect checksum
  2816. TDERR_TooFewSecs
  2817.     
  2818. 26
  2819.     
  2820. couldn't find enough sectors
  2821. TDERR_BadSecHdr
  2822.     
  2823. 27
  2824.     
  2825. another "sector looked wrong"
  2826. TDERR_WriteProt
  2827.     
  2828. 28
  2829.     
  2830. can't write to a protected disk
  2831. TDERR_DiskChanged
  2832.     
  2833. 29
  2834.     
  2835. no disk in the drive
  2836. TDERR_SeekError
  2837.     
  2838. 30
  2839.     
  2840. couldn't find track 0
  2841. TDERR_NoMem
  2842.     
  2843. 31
  2844.     
  2845. ran out of memory
  2846. TDERR_BadUnitNum
  2847.     
  2848. 32
  2849.     
  2850. asked for a unit > 
  2851. NUMUNITS
  2852. TDERR_BadDriveType
  2853.     
  2854. 33
  2855.     
  2856. not a drive that trackdisk groks
  2857. TDERR_DriveInUse
  2858.     
  2859. 34
  2860.     
  2861. someone else allocated the drive
  2862. TDERR_PostReset
  2863.     
  2864. 35
  2865.     
  2866. user hit reset; awaiting doom
  2867.  
  2868.  
  2869.  
  2870.  
  2871. Other general Exec device errors
  2872.  
  2873. Name
  2874.     
  2875. no.
  2876.     
  2877. short description
  2878.  
  2879. IOERR_OPENFAIL
  2880.     
  2881. -1
  2882.     
  2883. device/unit failed to open
  2884. IOERR_ABORTED
  2885.     
  2886. -2
  2887.     
  2888. request terminated early [after 
  2889. AbortIO()
  2890. ]
  2891. IOERR_NOCMD
  2892.     
  2893. -3
  2894.     
  2895. command not supported by device
  2896. IOERR_BADLENGTH
  2897.     
  2898. -4
  2899.     
  2900. not a valid length (usually 
  2901. IO_LENGTH
  2902. )
  2903. IOERR_BADADDRESS
  2904.     
  2905. -5
  2906.     
  2907. invalid address (misaligned or bad range)
  2908. IOERR_UNITBUSY
  2909.     
  2910. -6
  2911.     
  2912. device opens ok, but requested unit is busy
  2913. IOERR_SELFTEST
  2914.     
  2915. -7
  2916.     
  2917. hardware failed self-test
  2918. Technical notes - 
  2919. 34
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955. Recovery
  2956.  
  2957. -A tool for retrieving deleted files from disks 
  2958.  
  2959. Concepts
  2960.  
  2961. Volume
  2962.  
  2963. A Volume is a disk inserted into a disk 
  2964. device
  2965. .
  2966.  
  2967. For example 
  2968. Extras4.0
  2969.  is the name of a volume that can be inserted into a floppy drive.
  2970.  
  2971. Another may be 
  2972. Ram Disk
  2973.  - the non-permanent simulated disk in the computers memory.
  2974.  
  2975. A disk inserted into a disk-drive (floppy or permanently fitted hard drive) 
  2976. will have a volume name as well as a device name.
  2977.  
  2978. A volume can be renamed eg 
  2979. Ram Disk
  2980.  can be renamed to 
  2981. Disk In Ram
  2982. .
  2983.  
  2984. Device
  2985.  
  2986. An AmigaDOS Device is a sort of interface capable of having data written to it 
  2987. or read from it.
  2988.  
  2989. For example 
  2990. DF0:
  2991.  is the name of a device that can receive floppy disks. It can be written to 
  2992. and read from.
  2993.  
  2994. Another may be 
  2995. RAM:
  2996.  - the non-permanent simulated disk in the computers memory. This too has read 
  2997. and write capability.
  2998.  
  2999. A disk inserted into a disk-drive (floppy or permanently fitted hard drive) 
  3000. will have a 
  3001. volume
  3002.  name as well as a device name.
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008. Other examples of devices may be:
  3009. HD0:
  3010.  Where Workbench is held for hard disk users.
  3011. HD1:
  3012.  Work storage for hard disk users.
  3013. RAD:
  3014.  A reset proof Ram disk.
  3015. DF1:
  3016.  A second disk drive (if you have one).
  3017. PRT:
  3018.  The output only printer device.
  3019. SER:
  3020.  The serial port (read and write)
  3021. PAR:
  3022.  Read and write capable parallel device.
  3023.  
  3024. Only devices capable of storing data on a 
  3025. track by track
  3026.  basis will be able to be scanned by 
  3027. Recovery
  3028. . Printer ports, parallel and serial devices cannot be scanned. Also, sadly, 
  3029. the 
  3030. RAM:
  3031.  device cannot be scanned by 
  3032. Recovery
  3033.  because it is dynamic in nature. This means that it shrinks and expands 
  3034. depending upon how much data is stored within it.
  3035.  
  3036. Remember that although 
  3037. RAD:
  3038.  is a virtual device, it is also a 
  3039. track based device
  3040.  simulated in the computer memory. So, 
  3041. Recovery
  3042.  can still retrieve files from 
  3043. RAD:
  3044.  as well.
  3045.  
  3046. When this document refers to a 
  3047. drive
  3048.  it means a device capable of 
  3049. track based
  3050.  read and write.
  3051.  
  3052. Drive
  3053.  
  3054. A Drive is a 
  3055. device
  3056.  capable of storing data for later recovery. It can be written to and read from 
  3057. by normal Amiga applications.
  3058.  
  3059. Recovery
  3060.  can only scan disks in 
  3061. track based devices
  3062. .
  3063.  
  3064. Track based device
  3065.  
  3066. A track based device is usually a physical 
  3067. device
  3068.  like floppies, hard-drives and CD-ROMs, which are capable of reading or 
  3069. writing data in disks layered in tracks. Usually, the information is divided in 
  3070. sectors inside each track.
  3071.  
  3072. Due to versatility of AmigaDOS, it is possible to simulate a track based device 
  3073. to store files for instance in the computer memory like the 
  3074. RAD:
  3075.  
  3076. device
  3077. . Although 
  3078. RAM:
  3079.  is also a simulated 
  3080. device
  3081.  in the computer memory, 
  3082. Recovery
  3083.  can't scan it to search for files, because the information stored in 
  3084. RAM:
  3085.  is not layered as in disk tracks.
  3086.  
  3087. File system
  3088.  
  3089. AmigaDOS file system is the system that AmigaDOS uses to manage information of 
  3090. files and directories in a disk.
  3091.  
  3092. There are two basic types of the AmigaDOS file system: the 
  3093. OldFileSystem
  3094.  and the 
  3095. FastFileSystem
  3096. .
  3097.  
  3098. Old File System
  3099.  
  3100. OldFileSystem
  3101.  (OFS) is the original Filing system used by the Amiga range of computers.
  3102.  
  3103. Fast File System
  3104.  
  3105. FastFileSystem
  3106.  (FFS) is the newer type of filing system that was introduced with the release 
  3107. of Amiga OS 1.3. FFS allows more data to be stored on a given disk. The gain in 
  3108. storage capacity is at the sacrifice of an invisible form of file continuity 
  3109. checking. This goes mostly un-noticed to the user, who only sees more storage 
  3110. and marginally quicker file accessing.
  3111.  
  3112. The lost continuity checking of FFS means that 
  3113. Recovery
  3114.  cannot retrieve sections of files without 
  3115. header blocks
  3116. . OFS has no problems with these.
  3117.  
  3118. Newer still File Systems
  3119.  
  3120. Since AmigaDOS 3, other options have been available for filing systems. 
  3121. Although there are basically based on OFS and FFS, they are more efficient and 
  3122. functional.
  3123.  
  3124. Directory cacheing
  3125.  is where storage is sacrificed for directory access speed.
  3126.  
  3127. International
  3128.  is where file names cater better for international characters.
  3129.  
  3130. Since the release 3.1 of AmigaDOS, it is possible to use more than one sector 
  3131. per disk block. This feature improves the performance of disk operations within 
  3132. directories that have large amounts of files and sub-directories.
  3133.  
  3134. Alien File Systems
  3135.  
  3136. With latter releases of the operating system, Amiga is able to read and write 
  3137. disks which use different file systems than any of those referred above.
  3138.  
  3139. Those file systems were originally used in other types of computers that use 
  3140. MS-DOS or Apple's MacIntosh DOS.
  3141.  
  3142. The current version of 
  3143. Recovery
  3144.  is not yet able to retrieve any data from disks that use those alien file 
  3145. systems.
  3146.  
  3147. Lock
  3148.  
  3149. Lock is the name that is given to a reference that AmigaDOS uses internally to 
  3150. both locate a file or a directory in a 
  3151. volume
  3152.  and to protect it from being overwritten or removed from the 
  3153. filing system
  3154. .
  3155.  
  3156. Recovery
  3157.  will only exit (or allow you to 
  3158. free a drive
  3159. ) if there are no associated locks on the drive.
  3160.  
  3161. An opened file, implicitly sets up a lock, preventing it to be deleted. 
  3162. Therefore, all relevant opened files should be closed to allow 
  3163. Recovery
  3164.  to either exit or allow a device to be freed.
  3165.  
  3166. See 
  3167. Trouble shooting - Freeing a drive
  3168.  section.
  3169.  
  3170.  
  3171. Disk bitmap
  3172.  
  3173. When files are written in a 
  3174. volume
  3175. , its 
  3176. file system
  3177.  must have a way to determine which of the disk's blocks are available for use.
  3178.  
  3179. This information is available in a set of special blocks in the 
  3180. volume
  3181.  that maps the disk's free blocks.
  3182.  
  3183. Each bit of each byte of those bitmap blocks that is set to '1', means that the 
  3184. respective block in the 
  3185. volume
  3186.  is free for use. This is why that set of blocks is named bitmap.
  3187.  
  3188. When a 
  3189. volume
  3190.  is found 
  3191. unvalidated
  3192. , it means that the information present in the bitmap blocks does not 
  3193. correspond to the real usage of the 
  3194. volume
  3195.  blocks by the files and directories, meaning the bitmap is not valid.
  3196.  
  3197. A 
  3198. volume
  3199.  is usually found 
  3200. unvalidated
  3201.  when for some reason it was not possible to update the bitmap blocks after a 
  3202. write access to the 
  3203. volume
  3204. . This may happen if the computer is reset or turned off during a an incomplete 
  3205. write or delete operation on the 
  3206. volume
  3207. .
  3208.  
  3209. If a 
  3210. volume
  3211.  is found 
  3212. unvalidated
  3213. , the 
  3214. file system
  3215.  will try to validate by rescanning the whole 
  3216. volume
  3217.  directory tree structure to find out which blocks are in use.
  3218.  
  3219. The validation process is done automatically if the respective 
  3220. file system
  3221.  process finds the 
  3222. volume
  3223.  
  3224. unvalidated
  3225. . It may take a while depending on the number of files and directories in the 
  3226. volume.
  3227.  
  3228. The validation process may fail if the disk's directory tree structure is 
  3229. corrupt or unreadable.  At this time the system doesn't allow any data to be 
  3230. written, updated or deleted from the 
  3231. unvalidated
  3232.  disk.
  3233.  
  3234.  
  3235.  
  3236.  
  3237. Header blocks
  3238.  
  3239. An header block is a block in the volume that the 
  3240. file system
  3241.  uses to store attributes of files or directories.  For instance, the name, the 
  3242. creation date, protection bits, file comments an the location of each sub block 
  3243. are stored in the header block.  Sub blocks can be the list of data blocks for 
  3244. a file or the list of header blocks for a child directory.
  3245.  
  3246. If, for some reason, a file header block is unreadable or has been overwritten, 
  3247. the recovery process for files will be harder. 
  3248.  
  3249. See 
  3250. Scanning a disk - Headerless files
  3251.  section.
  3252.  
  3253. Concepts - 
  3254. 40
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290. Recovery
  3291.  
  3292. -A tool for retrieving deleted files from disks 
  3293.  
  3294. Introduction
  3295.  
  3296. DSBackup
  3297.  is a tool that enables the user to backup information about the structure of 
  3298. an AmigaDOS formated disk. Once saved in another disk, this information may be 
  3299. restored later. That might be the case when because of an accident, the disk 
  3300. structure information present in the disk itself, is corrupted.
  3301.  
  3302. The disk structure information may be saved in two forms. It can be a mountlist 
  3303. file or an IFF RDB (
  3304. Rigid Disk Block
  3305. ) file.
  3306.  
  3307. A mountlist is a text file that is used by AmigaDOS when mounting a device. An 
  3308. AmigaDOS device can be for instance a disk partition.
  3309.  
  3310. A mountlist consists of several keywords with the names of each relevant 
  3311. parameter of the AmigaDOS device, and the respective value to be. Mountlists 
  3312. are interpreted by the AmigaDOS 
  3313. Mount
  3314.  command to make the device being mounted available to the system.
  3315.  
  3316. An IFF RDB file is a custom IFF file that stores all the information contained 
  3317. in a disk's 
  3318. Rigid Disk Block
  3319. . A 
  3320. Rigid Disk Block
  3321.  is a block of information stored in the begining of a disk that can be 
  3322. partitioned.
  3323.  
  3324. When the computer boots, the disk's auto-boot driver tries to read the 
  3325. Rigid Disk Block
  3326.  information from the disk. If that information is found and is valid (not 
  3327. corrupted), the disk's partitions are mounted and the system can boot from one 
  3328. of the partitions.
  3329.  
  3330. If the 
  3331. Rigid Disk Block
  3332.  is corrupted because of some accident, booting from the disk won't be possible 
  3333. and the disk data won't be accessible. This is the time to use 
  3334. DSBackup
  3335.  to restore a previously saved 
  3336. Rigid Disk Block
  3337. .
  3338. Introduction - 
  3339. 46
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.  
  3374.  
  3375. DSBackup
  3376.  
  3377. -A tool for backup and restore disk structure information
  3378.  
  3379. Usage
  3380.  
  3381. Start 
  3382. DSBackup
  3383.  from either Workbench or Shell. 
  3384. DSBackup
  3385.  main window opens displaying initially a list of AmigaDOS drives.
  3386.  
  3387. Selecting one of the drives and hitting the 
  3388. Show
  3389.  button opens another window that displays several parameters of that drive and 
  3390. allows the respective mountlist to be saved to a file.
  3391.  
  3392. Switching the radio button in the main window to 
  3393. Device units
  3394.  switches the lists to display all the phisycal device units that can hold 
  3395. AmigaDOS formated disks.
  3396.  
  3397. Selecting one of the device units and hitting the 
  3398. Show
  3399.  button, if that device unit holds a disk that has a valid 
  3400. Rigid Disk Block
  3401. , another window opens displaying several parameter about that 
  3402. Rigid Disk Block
  3403. .From that window you can save the 
  3404. Rigid Disk Block
  3405.  to an IFF RDB file or verify if a previously saved 
  3406. Rigid Disk Block
  3407.  matches the currently present in that device's unit.
  3408.  
  3409. From the main window you can also tell the program to restore a previously 
  3410. saved 
  3411. Rigid Disk Block
  3412.  to an IFF RDB file. Each IFF RDB file holds enough information about the 
  3413. device unit from which the 
  3414. Rigid Disk Block
  3415.  was saved. Usually only hard-disks have 
  3416. Rigid Disk Blocks
  3417. , but notice that some controllers do not support the Commodore's 
  3418. Rigid Disk Block
  3419.   standard format, and so they are not supported by 
  3420. DSBackup
  3421. .
  3422.  
  3423. After loading the IFF RDB in memory, a small window requester opens displaying 
  3424. that device's unit information read from the IFF RDB file. That information can 
  3425. be changed in that requester, if it is the case for instance when the disk was 
  3426. moved to different device unit.
  3427.  
  3428. After succesfully restoring the 
  3429. Rigid Disk Block
  3430.  into the disk, the user is prompted reboot the computer to let the system 
  3431. recognise the newly restored disk's 
  3432. Rigid Disk Block.
  3433. Usage - 
  3434. 47
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.  
  3451.  
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470. DSBackup
  3471.  
  3472. -A tool for backup and restore disk structure information
  3473.  
  3474. Options
  3475.  
  3476. DSBackup
  3477.  has several options that can be specified when being started. 
  3478. When started from the Amiga's Command Shell, these options are listed
  3479. after name of the program, as in this example:
  3480.  
  3481. DSBackup CREATE_ICONS=no TOOLPRI=5
  3482.  
  3483. When started from the Workbench the options are retrieved by 
  3484. DSBackup
  3485.  from its icon.  Use 
  3486. Information
  3487.  item from Workbench's 
  3488. Icons
  3489.  menu after having selected 
  3490. DSBackup
  3491. 's Icon.  The options are maintained in the list of 
  3492. Tool Types
  3493.  in the Information window.
  3494.  
  3495. Whether 
  3496. DSBackup
  3497.  is used from the Shell or the Workbench, its options have the same name and 
  3498. achieve the same effect.  Note that all options names must be of the form 
  3499. OPTION NAME=OPTION VALUE
  3500. .
  3501.  
  3502. Although all options names are long and explicit, they also have shorter alias 
  3503. to save on finger wear and tear. The example above showed how to set 
  3504. DSBackup
  3505.  to not create icons for files it saves and sets priority of its task to 5. 
  3506. The short name for 
  3507. CREATE_ICONS
  3508.  is 
  3509. ICONS
  3510. , so 
  3511. ICONS=no
  3512.  would also have achieved the same thing.
  3513.  
  3514. DSBackup
  3515.  will use defaults if there are any options missing when it is started.  Most 
  3516. of the time 
  3517. DSBackup
  3518. 's options will not need to be changed from the default, so they don't have to 
  3519. be specified.
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529. Locale 
  3530. LANGUAGE
  3531.  
  3532. DSBackup
  3533.  is fully localized, and it is ready be used in any of the supported languages. 
  3534. This means that the all the text that the program displays can appear in 
  3535. several different languages.
  3536.  
  3537. Use the Locale system preference editor to select the default languages. If 
  3538. DSBackup
  3539.  doesn't yet support the selected language, the default built-in language will 
  3540. be used.
  3541.  
  3542. System localization support was only introduced in AmigaDOS V2.1. This 
  3543. LANGUAGE
  3544.  
  3545. option is meant only to specify the language to be used when system 
  3546. localization support is not available. Otherwise this option will be ignored.
  3547.  
  3548. Option argument name: 
  3549. LANGUAGE
  3550. Short name: 
  3551. LANG
  3552. Valid option values: any language of the currently supported
  3553. Default value: no language, built-in default is used (english).
  3554. Example: 
  3555. LANG=deutsch
  3556.  
  3557. PUBSCREEN
  3558.  - Public screen
  3559.  
  3560. This option tells
  3561.  
  3562. DSBackup
  3563.  the name of a public screen where its windows will be opened.
  3564.  
  3565. If no name is supplied for this option or for some reason it was not possible 
  3566. to open a window in that screen or there is no screen with the suplied name, 
  3567. DSBackup
  3568.  will open its windows in the default public screen which is usually the 
  3569. Workbench screen.
  3570.  
  3571. Option argument name: 
  3572. PUBSCREEN
  3573. Short name: 
  3574. SCR
  3575. Valid option values: any currently opened public screen name
  3576. Default value: no public screen name, Workbench screen is used
  3577. Example: 
  3578. SCR=My public screen
  3579. TOOLPRI
  3580.  - Tool task priority
  3581.  
  3582. The task priority value is used to arbitrate in a multi-tasking system like 
  3583. Amiga's, which task preferencially gets to use the CPU. This means that if a 
  3584. task has a certain priority, all the remaining tasks that have lower priority 
  3585. will have to wait till that first task ends its job or goes to sleep.
  3586.  
  3587. Applications usually run with priority 0. If you set this option to an higher 
  3588. value, 
  3589. DSBackup
  3590.  will have most of the time the CPU preference over tasks with lower priority 
  3591. till goes to sleep.
  3592.  
  3593. Saying that a task goes to sleep, means that it will be waiting for the system 
  3594. to send it a signal telling it that some event that it was waiting for has just 
  3595. happened. This is the case when for instance, a program is waiting for the user 
  3596. to act upon the user interface window or some data to be read from a disk.
  3597.  
  3598. This options determines what priority 
  3599. DSBackup
  3600.  
  3601. task will run at. It is not very important and was only provided to be 
  3602. consistent with other tools that have the same option. Since the default for 
  3603. the priority is already 0, it is not important to change it.
  3604.  
  3605. Option argument name: 
  3606. TOOLPRI
  3607. Short name: 
  3608. PRI
  3609. Valid option values: any value between -128 and 127
  3610. Default value: 
  3611. 0
  3612. Example: 
  3613. PRI=20
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623. CREATE_ICONS
  3624.  
  3625. If this option is set 
  3626. DSBackup
  3627.  will create icons for all the files being saved. 
  3628.  
  3629. The icon template file for mountlists id def_mountlist.info and for the IFF RDB 
  3630. is def_RDB.info.
  3631.  
  3632. DSBackup
  3633.  searches through directories for these icon files in the following order: 
  3634. PROGDIR:Icons/
  3635. , 
  3636. ENV:sys/
  3637. , 
  3638. ENVARC:sys/
  3639.  where 
  3640. PROGDIR:
  3641.  is the directory path of 
  3642. DSBackup
  3643.  program file.
  3644.  
  3645. Option argument name: 
  3646. CREATE_ICONS
  3647. Short name: 
  3648. ICONS
  3649. Valid option values: yes, no
  3650. Default value: yes
  3651. Example: 
  3652. ICONS=no
  3653.  
  3654. Options - 
  3655. 48
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661.  
  3662.  
  3663.  
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691. DSBackup
  3692.  
  3693. -A tool for backup and restore disk structure information
  3694.  
  3695.