home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / disk / moni / ded / ded.doc < prev    next >
Text File  |  1993-12-21  |  19KB  |  680 lines
  1.  
  2.  
  3.                  Disk-Editor, Version 1.1, User documentation
  4.                              Edition 3-Nov-1993
  5.                     Copyright 1992,3 Misoftware Computing
  6.  
  7.  
  8.  
  9.  
  10. 1. I'm sorry for my bad English.
  11. --------------------------------
  12.  
  13. 2. Requirements
  14. ---------------
  15.  
  16.    Hardware:
  17.  
  18.    An  AMIGA, Version 1.2 or higher (tested on 1.3, 2.0 and 3.0, next version
  19. will be 2.0+ only), NTSC or PAL, cca 100KB of memory free, 5 bytes per sector
  20. for  bitmap (for standard floppy format it's about 8800 bytes), 512 bytes for
  21. sector data, some memory for CD, drive, disk...
  22.  
  23.  
  24.    Software:
  25.  
  26.    Arp  library,  Req  or Reqtools library.  If you want nicer design, you need
  27. Reqtools library.  If DED is unable to open it, it will use Req, but the design
  28. has been made for Reqtools.
  29.  
  30.  
  31. 3. Design
  32. ---------
  33.  
  34.    On  the  screen title, there is the program version and number of sectors in
  35. memory  displayed.   In  the  bottom  of  the  screen,  there  is a status line
  36. containing  type  of  current sector, position in it, its number, its flags and
  37. total free memory.
  38.  
  39. 3.1 Type
  40.  
  41.    Program recognises 21 types of sectors:  BOOT, ROOT, USERDIR, FHEADER, EXT.,
  42. DATA,  BITMAP,  DIRCACHE,  LDIR, LFILE, LSEG, FSHD, PART., BAD BLK, RIGID, BMAP
  43. EXT,???, SUSPECT, BITMAP?, FREE, DATA?
  44.  
  45. BOOT     - Bootblock
  46. ROOT     - Rootblock
  47. USERDIR  - User directory
  48. FHEADER  - File header
  49. EXT.     - Extension of file header
  50. DATA     - Data block
  51. BITMAP   - Bitmap block
  52. DIRCACHE - Directory  cache  block (introduced in  OS V39, DED may  handle them
  53.            under any OS version including 1.2)
  54. LDIR     - Linked directory (introduced in  OS V36, DED may  handle  them under
  55.            any OS version including 1.2)
  56. LFILE    - Linked fileheader (introduced in  OS V36, DED may  handle them under
  57.            any OS version including 1.2)
  58. LSEG     - Load segment block
  59. FSHD     - Filesystem header block
  60. PART.    - Partition block
  61. BAD BLK  - Replacement of bad block
  62. RIGID    - Disk rigid block
  63. BMAP EXT - Bitmap extension block
  64.  
  65. ???      - Unknown type, but may be free (use "Load root & bitmap" for correct
  66.            identification)
  67. SUSPECT  - Unknown type, but allocated or something very suspicious
  68. BITMAP?  - Sector can be a bitmap
  69. FREE     - Free block
  70. DATA?    - May be  a  FFS data  block (use "Load  root  &  bitmap" for correct
  71.            identification)
  72.  
  73. 3.2 Position in block
  74.  
  75.    Format  of  numbers:  there are six numbers, separated by slashes:  pos in
  76. bytes  in  dec/pos  in words in dec/pos in longs in dec space pos in bytes in
  77. hex/pos in words in hex/pos in longs in hex.
  78.  
  79.    If you edit bitmap block in DOS edit mode, the number of the sector, pointed
  80. to by mouse, is displayed here, instead.
  81.  
  82. 3.3 Block
  83.  
  84.    Number of block, pointed to by the cursor.
  85.  
  86. 3.4 Sector flags
  87.  
  88. 1st character: Sector is changed   *=changed, #=not changed
  89. 2nd character: Sector is selected  +=selected, #=not selected
  90. 3rd character: Checksum            G=good, B=bad, Nothing=has no checksum
  91. 4th character: Status              B=Busy
  92.  
  93. 3.5 Free memory
  94.  
  95.    Current amount of total free memory.
  96.  
  97.  
  98. 4. Control
  99. ----------
  100.  
  101.  DED can be controlled using:
  102.  
  103.   - menus
  104.  
  105.   - cursor keys - move the cursor by one position in some way
  106.  
  107.   - up and down arrows with shift - move the cursor by one screen
  108.  
  109.   - up and down arrows with alt - move the cursor by 12 lines
  110.  
  111.   - left and right arrows with alt - move the cursor by one byte
  112.  
  113.   - TAB key - switches between ASCII and number edit modes
  114.  
  115.   - CTRL and up/down/left/right - hotkeys for
  116.       Parent/Descendant/Previous object/Next object menu functions
  117.  
  118.   -  F-key  functions - If you press CTRL + one of the F-keys, you may set your
  119. own  ASCII-code  of  this F-key.  But this code is valid only in the edit mode.
  120. CTRL  +  SHIFT + one of the F-keys => you will have to enter sector number.  If
  121. you  press  SHIFT  and  this F-key, DED will jump on sector you defined before.
  122. You can clear the sector number by entering empty string or -1.
  123.  
  124.  
  125.    In  number  gadgets,  you can enter an expression.  Expressions can contain
  126. numbers,  operators  (see  the  table  below),  variables (a-z), $ followed by
  127. hexadecimal  number,  <  (means:   minimal  allowed value), > (maximal allowed
  128. value).   If  you want to set a variable, you must use the calculator function
  129. to do it.
  130.  
  131.    Operators: (sorted by priority)
  132.  
  133.     *,/        multiplication, division
  134.     +,-        addition, subtraction
  135.     &          logical AND
  136.     ^,|        logical XOR and OR
  137.  
  138.    Control in DOS edit mode:
  139.  
  140.     - CTRL and up/down/left/right - hotkeys for
  141.         Parent/Descendant/Previous object/Next object menu functions
  142.  
  143.     - up or left - same as menuitem "Previous sector"
  144.  
  145.     - down or right - same as menuitem "Next sector"
  146.  
  147.     - menuitem "Jump to byte ..." is changed to "Jump to bitmap flag of sector
  148.       ..."
  149.  
  150.     - You may change any information (including sector type) by clicking on it.
  151.       You  cannot change BOOT, BITMAP, FREE and DATA? sector types and the ROOT
  152.       type can be switched only between ROOT and SUSPECT types.
  153.  
  154.     - SHIFT + F-key functions (see above)
  155.  
  156.     - up and down arrows with shift - scroll the display
  157.  
  158. 5. Testing
  159. ----------
  160.  
  161.    This  version  has  been written on AMIGA 500 with 2MB of RAM, one external
  162. disk drive and system 1.3.
  163.  
  164.  Tested on:
  165.  
  166.      My AMIGA
  167.      AMIGA 500+ with 6 MB of RAM, 50MB hard disk and kickstart 2.0
  168.      AMIGA 500 with 1MB of chip and 1MB of fast RAM, one external drive
  169.         and a 45 MB hard-disk.
  170.      AMIGA 1200 with 2 MB of CHIP-RAM, 80MB hard disk
  171.  
  172.  
  173. 6. Miscellaneous
  174. ----------------
  175.  
  176.    This  program  is freely distributable, but the copyright remains with the
  177. author at all times.  It's provided "as is"; no warranties are made.  All use
  178. Is at your own risk, and no liability or responsibility is assumed.
  179.  
  180.    This  is a first public released version.  Here are still some unknown bugs,
  181. but I don't know where.  If you know some, please write to:
  182.  
  183.      Internet E-mail:
  184.             lemming@k332.feld.cvut.cz
  185.  
  186.          or Michal Kara
  187.             Krosenska 543
  188.             Praha 8-Troja
  189.             181 00
  190.             Czech republic
  191.  
  192.  
  193.    If  you  call DED from CLI, you can also specify mounted device by giving it
  194. as an argument - for example "ded df0:".
  195.  
  196.  
  197. 7. Thanks
  198. ---------
  199.  
  200.    Thanks  to  Martin Mares of MJSoft System Software for testing, critics and
  201. some information about AMIGA system,
  202.  
  203.    Pavel Troller of SinSoft for language censoring,
  204.  
  205.    Honza Kratochvil ("LACE") for testing and some ideas
  206.  
  207.    and Petr Cisar (PCSoft) & "mr. Zub" for risking integrity of their hards.
  208.  
  209.  
  210.    No thanks to PC for its existency.
  211.  
  212.  
  213. 8. History
  214. ----------
  215.  
  216.    History is stored in the ded.history file.
  217.  
  218.  
  219. 9. Plans for future
  220. -------------------
  221.  
  222.  - Check and repair disk (The Re-hash function in this version has some
  223.    repairing effects...)
  224.  
  225.  - Recover actions
  226.  
  227.  - User selectable screen mode
  228.  
  229.  - Wildcards in search
  230.  
  231.  - Optimize the code
  232.  
  233.  - Dynamic bitmap of sectors (less than 5 bytes for every sector)
  234.  
  235.  - Variable length of block
  236.  
  237.  - The next release will be probably 2.0+ only (some 2.0+ features will be
  238.    added)
  239.  
  240.  - Use only reqtools.library, no req
  241.  
  242. 10. Appendixes
  243. --------------
  244.  
  245.                                 APPENDIX A
  246.                               DOS STRUCTURES
  247.  
  248. (Thanks to Martin Mares for most of these structures)
  249.  
  250. Here  are  dos  structures  for  the  Old  File  System (OFS), offsets are in
  251. longs:
  252.  
  253. ROOT BLOCK:
  254.  
  255. This block is in the middle of the medium. It's the root directory.
  256.  
  257. 0 T.SHORT (=2)
  258. 1 0
  259. 2 0
  260. 3 HASH TABLE SIZE
  261. 4 0
  262. 5 CHECKSUM
  263. 6 HASH TABLE
  264. ...
  265. SIZE-50 BITMAP FLAG (TRUE=BITMAP IS VALID)
  266. SIZE-49 BITMAPBLOCKS
  267. ...
  268. SIZE-24 BITMAP EXTENSION BLOCK
  269. SIZE-23 DAYS LAST ACCESS
  270. SIZE-22 MINS LAST ACCESS
  271. SIZE-21 TICKS LAST ACCESS
  272. SIZE-20 DISK NAME
  273. ...
  274. SIZE-7 CREATE DAYS
  275. SIZE-6 CREATE MINS
  276. SIZE-5 CREATE TICKS
  277. SIZE-4 0
  278. SIZE-3 0
  279. SIZE-2 FIRST DIRECTORY CACHE BLOCK
  280. SIZE-1 ST.ROOT (=1)
  281.  
  282.  
  283. USER DIR:
  284.  
  285. 0 T.SHORT (=2)
  286. 1 POINTER TO SELF
  287. 2 0
  288. 3 0
  289. 4 0
  290. 5 CHECKSUM
  291. 6 HASH TABLE
  292. ...
  293. SIZE-50 NOT USED
  294. SIZE-48 PROTECTION BITS
  295. SIZE-47 0
  296. SIZE-46 COMMENT
  297. ...
  298. SIZE-23 DAYS LAST ACCES
  299. SIZE-22 MINS LAST ACCES
  300. SIZE-21 TICKS LAST ACCES
  301. SIZE-20 DIRECTORY NAME
  302. ...
  303. SIZE-11 PREVIOUS BLOCK IN LINK-LIST - This value is always NULL.
  304. SIZE-10 NEXT BLOCK IN