home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / disk / misc / undel / undel.doc < prev    next >
Text File  |  1995-02-27  |  5KB  |  137 lines
  1.  
  2.                             File Undeleting Utility
  3.  
  4.                  (c) 1994 Martin Mares, MJSoft System Software
  5.  
  6. ================================================================================
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.    UnDel 1.0 and its documentation are Copyright (c) Martin Mares, MJSoft System
  13. Software, Prague, Czech Republic.
  14.  
  15.    This  archive  can  be  freely redistributed, as long as all of its files are
  16. included   in   their   original   form  without  any  additions,  deletions  or
  17. modifications,  and  no more than a nominal fee is charged for its distribution.
  18. All  copyright notices in the programs and accompanying documentation files must
  19. remain  on  their  places.  Also '.displayme' and other similar files may not be
  20. added.  This is generally known as FREEWARE.
  21.  
  22.    Special  permission is given to Fred Fish to distribute this program on his
  23. "Fish Disks".
  24.  
  25.    This  software  is  provided  "AS  IS"  without  warranty of any kind, either
  26. expressed  or  implied.   The author is not responsible for any damage caused by
  27. it.
  28.  
  29.  
  30. Introduction
  31. ============
  32.  
  33.    AmigaDos and its filesystem have been released some years ago. During
  34. this long period, CBM didn't release any kind of tool which would be able
  35. to check and repair disks and recover deleted files. There are many third-party
  36. utilities capable of doing such a job, but they are usually terribly slow and
  37. they don't support all standard filesystems. I have been so annoyed with this
  38. situation that I decided to try to write a good unerasing tool. UnDel is the
  39. result of this work.
  40.  
  41.    Features:
  42.  
  43.     - Supports any standard filesystem - OFS / FFS + DirCache / INTL mode
  44.  
  45.     - Very fast (only free blocks are scanned, written in assembly etc.)
  46.  
  47.     - Special option for systems with small amount of memory
  48.  
  49.     - Nice user interface in shell window  ;-)
  50.  
  51.     - Recovered files are copied to another device
  52.  
  53.     - Protection bits and file note are also recovered
  54.  
  55.         - UNDEL is pure and can be made resident
  56.  
  57.  
  58. Requirements
  59. ============
  60.  
  61.    - Kickstart 2.04 or higher
  62.  
  63.    - ss.library 4.0 or higher (included in this archive)
  64.  
  65.    - 68000 or higher
  66.  
  67.  
  68. Usage
  69. =====
  70.  
  71.    UnDel must be started from the CLI.
  72.  
  73.    Syntax: UnDel <from> <to> [NOPATH] [SLOW] [NOCHECK]
  74.  
  75.    <from> - name of device or volume to recover files from. Must end with ':'.
  76.  
  77.      <to> - name of directory to copy recovered files to. Must exist.
  78.  
  79.    NOPATH - asks UnDel to ignore all paths (slight improvement of speed). All
  80.         files are shown as if they are stored in the same directory.
  81.  
  82.      SLOW - reduce memory requirements at the cost of lower speed. Use if you
  83.             have not enough memory to run UnDel in standard mode.
  84.  
  85.   NOCHECK - don't check cross-links between files. Increases speed, but the
  86.         number of cross-links is always displayed as zero.
  87.  
  88.  
  89.    After you start UnDel with appropriate options, it starts to scan the
  90. disk for deleted files (40 seconds on 120MB drive with 30MB of free space).
  91. The scanning is succeeded by checking of files, checking of data blocks (FFS
  92. disks only) and building of directory tree. At the end, file list is displayed
  93. and you are given chance to select some files to be recovered.
  94.  
  95.    Listing format:
  96.  
  97. * 23-05-93  88B     0 :tt/grep-2.0/ChangeLog
  98. |    |       |      |         |
  99. |    |         |        |          *--- file name
  100. |    |         |        *--- number of sectors cross-linked with other files
  101. |    |         *--- file size
  102. |    *--- date of last modification of the file
  103. *--- asterisk if selected, space if not
  104.  
  105.    You can use the following keys:
  106.  
  107. j,8,<up>            go up
  108. k,2,<down>            go down
  109. 9,<shift-up>            page up
  110. 3,<shift-dn>            page down
  111. 7,<shift-left>            first record
  112. 1,<shift-right>            last record
  113. s,/,+                select pattern (standard AmigaDos patterns)
  114. d,-                deselect pattern
  115. 0,<space>            toggle selection
  116. i,?,*                get info
  117. h,<help>            show help page
  118. q,<esc>,x,<ctrl-c>        quit
  119.  
  120.    Press ENTER to start undeleting. If the files are inside some directory
  121. and name of that directory is known, you are prompted whether you want to create
  122. directories for the files or to leave them all directly in the destination
  123. directory.
  124.  
  125.    If the number of cross-linked sectors is non-zero, these sectors are probably
  126. overwritten by some other data. Cross-links are detected when some sector is
  127. used by more than one deleted file and it is impossible to detect which one is
  128. the real owner of the data. This cannot appear on OFS disks, because OFS data
  129. blocks always contain which file they belong to.
  130.  
  131.  
  132. Notes
  133. =====
  134.  
  135.    Send comments, suggestions and bug reports to mjsoft@k332.feld.cvut.cz
  136.  
  137.