home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 2 / CDPD_II_2352.bin / scope / 101-125 / scopedisk108 / dedit / dedit.man < prev    next >
Text File  |  1992-10-27  |  14KB  |  578 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25. **********************************************************************
  26. *                                                                    *
  27. *                        DEdit by Mike Ruble                         *
  28. *                                                                    *
  29. **********************************************************************
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. v2.01                    DEdit documentation                  02/06/90
  68.  
  69.  
  70.                             PROGRAM
  71.  
  72.  
  73.      DEdit is  a Disk Editor that will edit sectors on any disk device
  74. that  uses  512 byte sectors I've used it with my Floppy drives, RAD:,
  75. and  my  hard  drive  using  the FastFileSystem.  I've written and run
  76. DEdit  on  an Amiga 1000 with Kickstart 1.2+, 2.5megs, 2 floppies, and
  77. an  80  meg  hard  drive.   To  use  the  program  you  will  need the
  78. following...  
  79.  
  80.                         FILE            DIR
  81.                 string.library          LIBS:        (supplied by me)
  82.                 DEdit.font              FONTS:       (supplied by me)
  83.                 8                       FONTS:DEdit/ (supplied by me)
  84.  
  85. An  insallation  script  is supplied (DEdInstall) that will copy these
  86. files for you.  
  87.  
  88. ---------------------------------------------------------------------- 
  89.                            OPERATION
  90.  
  91.  
  92.      DEdit is  invoked  from  CLI with the command DEdit [drive] where
  93. drive  is DF0: DH0: RAD: etc. if no drive is specified then DEdit will
  94. start  up  using DF0: you can choose a different drive later using the
  95. DRIVE menu.  
  96.  
  97.  
  98.      To start  DEdit from Workbench just double-click its icon it will
  99. start up using DF0: 
  100.  
  101.  
  102.      When DEdit  starts  it  will check the AmigaDOS device list for a
  103. disk  device  with  a  name that matches the one you supplied, open it
  104. and show you what it thinks should be the ROOT block.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                   1
  129.  
  130.  
  131. v2.01                    DEdit documentation                  02/06/90
  132.  
  133.  
  134.                             GADGETS
  135.  
  136.      Across the top of the display are 6 string gadgets which are...  
  137.  
  138. BLOCK 
  139.      Display/Change  current block number there are really two gadgets
  140.      here,  the  top  is a decimal display and the bottom one is a hex
  141.      display.  
  142.  
  143. TRACK 
  144.      Display/Change current track number.  
  145.  
  146. SECTOR 
  147.      Display/Change current sector within track.  
  148.  
  149. CYLINDER 
  150.      Display/Change current cylinder number.  
  151.  
  152. SURFACE 
  153.      Display/Change current surface number.  
  154.  
  155.  
  156.      To use  theese gadgets just select it type the value you want and
  157. hit  enter.  The program will make the adjustments and display the new
  158. current  block.   If  you enter a value less than 0 you will get 0, if
  159. you  enter  a  value  greater than the maximum value for the drive you
  160. will  get  the  last  item.  For example the last block on a floppy is
  161. 1759 so if you enter 1800 you  will get 1759.  
  162.  
  163.      At  the  top-right  of  the  display  there  are  9 gadgets which
  164.      are...  
  165.  
  166. NEXT BLOCK 
  167.      Show  the next block.  This will wrap to 0 if you are on the last
  168.      block.  
  169.  
  170. PREV BLOCK 
  171.      Go  back  1  block.  This will wrap to the last block on the disk
  172.      if you are on block 0.  
  173.  
  174. LINK BLOCK 
  175.      If  you  are  looking  at  a  file header or data block this will
  176.      display  the  next  block  in  the  chain.  If the link is 0 then
  177.      nothing will happen.  (on FFS data blocks this is useless) 
  178.  
  179. ROOT BLOCK 
  180.      This will go directly to the ROOT block.  
  181.  
  182. JUMP 
  183.      This  gadget  will  cause the program to jump to the block number
  184.      indicated  by  the  currently  selected  (RED)  long-word  on the
  185.      display.   If  none  are  selected or the long-word is out of the
  186.      range  of  available  blocks  then  nothing will happen.  You can
  187.      select  a  long-word  in several ways, you can select the COMPUTE
  188.      HASH  menu  item  (later),  press 'S' and use the cursor keys, or
  189.      use  the  mouse  pointer  and click on the long-word you want.  A
  190.  
  191.  
  192.                                   2
  193.  
  194.  
  195. v2.01                    DEdit documentation                  02/06/90
  196.  
  197.  
  198.      double-click will select and jump at the same time.  
  199.  
  200. EDIT HEX 
  201.      Begin  editing  on the hex display at the selected long-word.  If
  202.      no  long-word  has  been selected then start at top.  See EDITING
  203.      below.  
  204.  
  205. EDIT ASCII 
  206.      Begin  editing  on  the  ascii display at the selected long-word.
  207.      If  no  long-word  has  been  selected  then  start  at top.  See
  208.      EDITING below.  
  209.  
  210. CHECKSUM 
  211.      Re-calculate  the checksum on the current block.  Don't forget to
  212.      WRITE the block back to disk.  
  213.  
  214. WRITE 
  215.      Re-write the current block to disk.  
  216.  
  217. UNDO 
  218.      Undo  all  changes to the current block.  Really all this does is
  219.      read  the  current  block  back from the disk.  In edit mode this
  220.      will undo all changes made during the edit.  
  221.  
  222.      These gadgets have keyboard equivalents which are as follows...  
  223.  
  224.                           GADGET        KEY
  225.                           -----------------
  226.                           NEXT BLOCK      N
  227.                           PREV BLOCK      P
  228.                           LINK BLOCK      L
  229.                           ROOT BLOCK      R
  230.                           JUMP            J
  231.                           EDIT HEX        H
  232.                           EDIT ASCII      A
  233.                           CHECKSUM        C
  234.                           UNDO            U
  235.  
  236.  
  237.      Across the bottom of the display are 6 gadgets which are...
  238.  
  239. HEADER
  240.      Points to current blocks file header.
  241.  
  242. EXTENSION
  243.      Points to file headers extension (file list) block.
  244.  
  245. NEXT DATA
  246.      Points to next data block in chain.
  247.  
  248. PARENT
  249.      Points to directory parent.
  250.  
  251. NEXT HASH
  252.      Points to next file header in hash chain.
  253.  
  254.  
  255.  
  256.                                   3
  257.  
  258.  
  259. v2.01                    DEdit documentation                  02/06/90
  260.  
  261.  
  262. CHECKSUM
  263.      Checksum for current block.
  264.  
  265.  
  266.      Selecting one  of  theese gadgets (except CHECKSUM) will make the
  267. displayed  block  number  the  current  block  and display it.  If the
  268. number  is  0 then nothing will happen.  The CHECKSUM gadget works the
  269. same as the CHECKSUM gadget at the top-right.  
  270.  
  271.  
  272.      Near the  bottom-right  of  the display under the heading HISTORY
  273. are  20  gadgets  which  are  a  history  of  the blocks that you have
  274. visited.  You can select one of theese to go back to that block.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.                                   4
  321.  
  322.  
  323. v2.01                    DEdit documentation                  02/06/90
  324.  
  325.  
  326.                              MENUS
  327.  
  328.  
  329.      The DRIVE  menu  is  used to select the drive you wish the editor
  330. to  use.   This  is  set  up  by  reading the AmigaDOS device list and
  331. should  have  all  disk  devices  that  you have in your system.  Just
  332. select  a drive to use and the program will find the driver, name, and
  333. size paramaters that it needs and start using that drive.  
  334.  
  335.  
  336.      The MODE  menu  is  used  to  switch  between FILE and DISK mode.
  337. When  a  FileHeader  block  is displayed you can select FILE MODE from
  338. the  menu  and your movement on the disk will be limited to the blocks
  339. in  that  file.   When you select the NEXT BLOCK gadget the next block
  340. in  the file will be displayed not the next block on the disk.  If the
  341. last  block  of the file is displayed then NEXT BLOCK will display the
  342. FileHeader.   The  string  gadgets  at the top of the display will not
  343. function in file mode.  
  344.  
  345.  
  346.      The SPECIAL  menu  has  several  functions  that  I  thought were
  347. usefull.  
  348.  
  349. SAVE BLOCK 
  350.      Copies the current block to a save area.  
  351.  
  352. COPY SAVED BLOCK 
  353.      Copies  the  saved block over the current block.  These two items
  354.      could  be used to copy a block from one drive to another for safe
  355.      keeping.  
  356.  
  357. OPEN SAVE FILE 
  358.      Brings  up a requester for You to type a file name into and opens
  359.      the   specified   file  for  BLOCK  TO  SAVE  and  FILE  TO  SAVE
  360.      operations.  
  361.  
  362. CLOSE SAVE FILE 
  363.      Closes the save file.  
  364.  
  365. BLOCK TO SAVE 
  366.      Copies  the  DATA  portion  of the current data block to the save
  367.      file.   If  the  current  block  is not a data block nothing will
  368.      happen.   If  the  drive  is  using  the FastFileSystem the whole
  369.      block  will  be  copied  to  the save file since DEdit can't tell
  370.      data blocks from free blocks on FFS.  
  371.  
  372. FILE TO SAVE 
  373.      Copies  an entire file to the save file.  If the current block is
  374.      a  data  block the save will follow the NEXT DATA link to the end
  375.      of  the  file (unless You're using FFS).  If the current block is
  376.      a  file  header  then  the save will follow the list of blocks in
  377.      the   file  header  and  extensions.   This  item  is  great  for
  378.      recovering  a  file  from  a trashed disk (works on deleted files
  379.      also).   If  You're  using  FFS  then FILE TO SAVE will only work
  380.      from a file header block.  
  381.  
  382.  
  383.  
  384.                                   5
  385.  
  386.  
  387. v2.01                    DEdit documentation                  02/06/90
  388.  
  389.  
  390. COMPUTE HASH 
  391.      Requests  a  string  computes  its  hash value and highlights the
  392.      apropriate  long-word  in the display.  If the current block is a
  393.      directory  block  use  this  item  to find an entry for a file or
  394.      directory and then select JUMP (or press 'J').  
  395.  
  396.  
  397.      The SEARCH  menu  is  used  to  search  for  strings,  files,  or
  398. directories.   each  item  has  two subitems, FROM CURRENT will search
  399. from  the current position on the disk and FROM START will search from
  400. block 0.  
  401.  
  402. FOR STRING 
  403.      Will  search  all  data  and  unused  blocks  for  the  specified
  404.      string.   If  successfull  the block the string was found in will
  405.      be displayed.  If not the screen will blink.  
  406.  
  407. FOR FILE 
  408.      Will  search  all file header and unused blocks for the specified
  409.      name.   If  successfull  the  file header block will be diplayed.
  410.      If not the screen will blink.  
  411.  
  412. FOR DIRECTORY 
  413.      Will  search  all  directory  and unused blocks for the specified
  414.      name.   If  successfull the directory block will be diplayed.  If
  415.      not the screen will blink.  
  416.  
  417.  
  418.      The reason  SEARCH looks at unused blocks is that if You delete a
  419. file  or  directory  the  file  header  or  directory block may not be
  420. identified as such.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.                                   6
  449.  
  450.  
  451. v2.01                    DEdit documentation                  02/06/90
  452.  
  453.  
  454.                             EDITING
  455.  
  456.  
  457.      There are  two  methods  for  editing displayed data, HEX mode in
  458. which  the  left  part of the display is used, and ASCII mode in which
  459. the  right part of the display is used.  In both modes the cursor keys
  460. are  active  and  can  be  used to move the cursor around the display.
  461. Pressing  <return>  or  <enter> will end the editing session.  In both
  462. modes  the  UNDO gadget at top- right will restore the block as it was
  463. before you started editing.  
  464.  
  465.  
  466.      To start  editing  in  hex  mode  select EDIT HEX gadget or press
  467. 'H'.   Only  hexadecimal  keys  (1-9  A-F) will be accepted any others
  468. will beep the screen.  
  469.  
  470.  
  471.      To start  editing in ascii mode select EDIT ASCII gadget or press
  472. 'A'.   All keys except function keys will be accepted including ALTed,
  473. SHIFTed, CNTRLed, or whatever combination.  
  474.  
  475. When  you are finished editing don't forget to write the block back to
  476. disk or it will be lost.  
  477.  
  478. ---------------------------------------------------------------------- 
  479.  
  480. Send questions or comments to...  
  481.  
  482. Mike Ruble      CompuServe ID: 71310,1237 
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.                                   7
  513.  
  514.  
  515.                           Table of Contents
  516.  
  517.  
  518. PROGRAM.........................................................    1
  519. OPERATION.......................................................    1
  520. GADGETS.........................................................    2
  521.    BLOCK........................................................    2
  522.    TRACK........................................................    2
  523.    SECTOR.......................................................    2
  524.    CYLINDER.....................................................    2
  525.    SURFACE......................................................    2
  526.    NEXT BLOCK...................................................    2
  527.    PREV BLOCK...................................................    2
  528.    LINK BLOCK...................................................    2
  529.    ROOT BLOCK...................................................    2
  530.    JUMP.........................................................    2
  531.    EDIT HEX.....................................................    3
  532.    EDIT ASCII...................................................    3
  533.    CHECKSUM.....................................................    3
  534.  
  535.    UNDO.........................................................    3
  536.    HEADER.......................................................    3
  537.    EXTENSION....................................................    3
  538.    NEXT DATA....................................................    3
  539.    PARENT.......................................................    3
  540.    NEXT HASH....................................................    3
  541.    CHECKSUM.....................................................    3
  542.    HISTORY......................................................    4
  543. MENUS...........................................................    5
  544.    DRIVE........................................................    5
  545.    MODE.........................................................    5
  546.    SPECIAL......................................................    5
  547.    SEARCH.......................................................    6
  548. EDITING.........................................................    7
  549.    HEX..........................................................    7
  550.    ASCII........................................................    7
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.                                   I
  577.  
  578.