home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 1 / FishNMoreVol1.bin / more / disks / better_pd / utilities_1 / docs / disasm.doc < prev    next >
Encoding:
Text File  |  1986-09-20  |  3.2 KB  |  99 lines
  1.  
  2.             Instructions for Amiga memory disassembler
  3.                   Copyright 1986 by LMR Software
  4.  
  5.                            8663 Ida Lane
  6.                           Sandy, UT 84092
  7.                            (801) 974-0992
  8.  
  9. This program is begining distrubuted as is to anyone who wants it.  Any 
  10. comments would be appreciated. Donations ($15) would be appreciated if
  11. you think this is useful to you. I would like to fix this up and make
  12. it more useful, any encouragement would be helpful.
  13.  
  14. Comments can be left on the Techni-Soft bulliten board at (801)
  15. 264-8290 or by call me at the above number.
  16.  
  17. Type disassem to enter the program.  No paramaters are required.
  18.  
  19. Valid commands are listed in the table below. Commands may be specified
  20. by their full names or any portion thereof.
  21.  
  22. The minimum that can be entered is the characters that are in upper case
  23. in the table. The command table can be listed with the Help command.
  24.  
  25. Commands are:
  26. Help   print command formats
  27. EXIT   exit  to 
  28. Mem   dump memory contents in hex and ascii
  29. List   list disassemble instruction from memory
  30. DUAL   open a second channel for dual output
  31.  
  32. Display commands (mem/list) may have optional parameters.
  33. Options are starting address followed by either a count or end address.
  34. Preceede a count value with a +.  
  35. These commands may be continued from where they stop by giving the command
  36. again or simply by hitting the space bar. These are repeat type commands.
  37.  
  38. Dual is used to open a second output channel so that the data can be
  39. saved for later use. 
  40.  
  41. Example: dual ram:dis.out
  42.  
  43.    will open a file on the ram disk called dis.out and send a copy
  44.    of the output there. The output can be turned off by entering
  45.    dual off. It can be turned on later with just a dual on command.
  46.    This can be done while you look around for more interesting
  47.    stuff to save. Commands are not written to the output.
  48.  
  49. For some reason the prt: device cannot be open for the second channel.
  50. So for now use a disk file and then print it.
  51.  
  52. If you use a disk file you can also edit it and add comments before
  53. you print it.
  54.  
  55. Comments can also be sent to the output file by preceding the line
  56. with a semicolon.
  57.  
  58. I have included a sample output from the disassembler in file "exec.lvo".
  59. This file has all of the LVO jump's for Amiga exec program. It also
  60. has all the data from the ExecBase structure.
  61.  
  62. All input numbers default to hex.
  63.  
  64. To specify a decimal number preceede it with a . (decimal point)
  65.  
  66. Valid numbers are as follows:
  67.    $nn - $ symbol for hex number ala assembly 
  68.    0xnn - 0x for hex number ala 'C'
  69.    .nn - preceding decimal point for decimal numbers
  70.    'cc' - ascii char inside single quotes
  71. any numbers not preceded by one of the above must start with a digit(0-9)
  72.  
  73.  
  74. Numbers may be a complex expression if desired, with parenthesis and the
  75. following operators:
  76. | - bitwise OR
  77. & - bitwise AND
  78. ^ - bitwise XOR
  79. + - sum
  80. - - difference
  81. * - multiply
  82. / - divide
  83. % - modulo
  84. - - unary minus
  85. ~ - unary not
  86. * - unary pointer( uses number at expression )
  87.  
  88. All operators obey normal precedence rules as defined by 'C'
  89.  
  90. example: m *(*4+114) 
  91.  
  92. will display the memory for the task control block of the currently
  93. running task.
  94.  
  95. I hope you find this program useful...
  96.  
  97.          Lee M. Robertson
  98.  
  99.