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