home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 28 / amigaformatcd28.iso / -seriously_amiga- / programming / other / cop / cop.readme < prev    next >
Encoding:
Text File  |  1998-04-27  |  8.1 KB  |  192 lines
  1. Short:    Low Level Debugger
  2. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Type:     dev/debug
  5. Version:  1.65
  6. Requires: An Amiga or even better two. The OS version doesn't matter.
  7.  
  8. *****************************************************************************
  9. **                                                                         **
  10. ** ___________                                                             **
  11. ** \        */                                                             **
  12. **  /-----------     #######     #######    ########                       **
  13. **  |    ^ |        ##      ##  ##     ##   ##     ##                      **
  14. **  |      _\       ##          ##     ##   ##     ##  Version 1.65        **
  15. **  |      |        ##          ##     ##   ########                       **
  16. **  |    --|        ##          ##     ##   ##                             **
  17. **  +-----/         ##      ##  ##     ##   ##                             **
  18. **   |   |           #######     #######    ## (c) 1993-1998 THOR-Software **
  19. **                                                                         **
  20. **                                                                         **
  21. **              A Low Level Debugger for all Amiga Systems                 **
  22. **                                                                         **
  23. *****************************************************************************
  24.  
  25.                                     by
  26.  
  27.      _______         _____  _____           __     _
  28.         /    /    / /    / /    /         \/_/    //_/_
  29.        /    /____/ /    / /____/   ___    /  ____// /        _      __
  30.       /    /    / /    / /   \           /  /|/ /  /  /   /_/ / /\_/_/
  31.      /    /    / /____/ /    /         _/__/_/ /__/|_/_/_/ /_/_/  /_
  32.                                               /                   
  33.  
  34. _____________________________________________________________________________
  35.  
  36.             About COP
  37.  
  38. COP is a low level debugger for all amiga systems. "Low Level" means it
  39. directly plays with the hardware, does not have GUI, but is unbeatable
  40. stable. Its main purpose is to debug programs not debugable with the usual
  41. "source level" debugger, like hardware device drivers, DOS handlers in action
  42. and much more. It supports debugging by the serial port, thru a standard
  43. tty terminal (also a COP type 5 terminal is better. A terminal program
  44. for amigas is included), and a build-in terminal emulation in case no 
  45. second computer is available.
  46.  
  47. In case you want to use COP, make sure:
  48.  
  49. -that you really want it. COP is not easy to use!
  50. -that you know assembly language. It won't work without!
  51. -that you have a lot of good will!
  52.  
  53.  
  54. EMail:  thor@einstein.math.tu-berlin.de
  55.  
  56. WWW:    http://www.math.tu-berlin.de/~thor/thor/index.html
  57.  
  58.  
  59. By the way: You should read the documentation first (before trying to get
  60. COP running)!
  61.  
  62. This is even more important if you own a '060 or '040 system. Special hints
  63. can be found at the end of the COP.doc file.
  64. _____________________________________________________________________________
  65.  
  66. Changes made in 1.65:
  67.  
  68. - Fixed a bug in the 68851 detection routine. This thing is now getting
  69.   "metamagical", too. As the rest of the kernal code...
  70.   Thanks, Dennis, for letting me know.
  71. - COP RESTOREVBR restores now, too ,the Alert entry that might have been
  72.   reset by the Enforcer.
  73. - Removed a bug from the symbol hunk parser that didn't respect HUNK_DEBUGs
  74.   as it should.
  75. _____________________________________________________________________________
  76.  
  77. Changes made in 1.64:
  78.  
  79. - Fixed another set of bugs in the disassembler. The "pmove bad/bac" opcoded
  80.   did not work.
  81. - The disassembler knows now the "fnop" command.
  82. - The register saveback routine was faulty for the '020 - it tried to save
  83.   the non-existing tt0,tt1 registers.
  84. _____________________________________________________________________________
  85.  
  86. Changes made in 1.63:
  87.  
  88. - Fixed a bug in the disassembler. The 0x7100 opcode was not detected as
  89.   illegal.
  90. - Fixed memory addressing bugs in the disassembler. Did not check for
  91.   validity of addresses. 
  92. - Fixed an addressing bug in the label manager. Did not check whether an
  93.   address is valid or not.
  94. - COP does no longer run the ROM code for the '060 in case no Enforcer/060
  95.   library is installed.
  96. - Added support code for the 68851 PMMU coprocessor. Should be detected
  97.   correctly now.
  98. _____________________________________________________________________________
  99.  
  100. Changes made in 1.62:
  101.  
  102. - Neither the NOMMU nor the NOEMU command line options worked in 1.61.
  103.   Sigh.
  104. - Added MMU and EMU keywords for symmetry.
  105. - Fixed just another bug in the '060 support code, thanks to Mark for
  106.   the hints and the testing. (I guess we're at 4% now).
  107. - Added the MMU support for MOVE, FIND and FILL commands.
  108. - Improved FIND command, displays the found instructions or bytes.
  109. - Made RESTOREVBR a bit smarter.
  110. - Updated the included DDT file to contain '060 specific gurus. Thanks, 
  111.   Mark!
  112. ____________________________________________________________________________
  113.  
  114. Changes made in 1.61:
  115.  
  116. - Fixed a lot of bugs in the '060 support code. Thus, the chance that
  117.   this release operates properly on a '060 has about doubled (from 1% to
  118.   2%, to be precise...).
  119. - Added NOEMU command line switch to bypass emulator traps.
  120. - Added proper support for the '060 '040 MMU and cache.
  121. - Debugged the AbsExecBase move.l emulator for the '060. Might actually work
  122.   by now, but is untested.
  123. - Changed some details in MMU handling.
  124. - Changed minor details for COP capturing its own bugs.
  125. - Added another function to the label manager, showing the label given an
  126.   address - LABL.F command.
  127. - Fixed a bug in the memory manager that did not handle non-writable memory
  128.   in the correct way.
  129. - Fixed a bug in the set-breakpoint logic.
  130. - Enhanced the stack traceback with the new label manager. It tries to find
  131.   out the label names.
  132. _____________________________________________________________________________
  133.  
  134. Changes made in 1.60:
  135.  
  136. - Removed bugs in the breakpoint logic.
  137. - Added SegTracker support for the REGS.G and (new) SEGM commands.
  138. - Updated MMU/Enforcer support since I finally bought a real 68030.
  139. - Added the NOMMU command line switch to disable the MMU bypass.
  140. - Added the ability to pre-compile the DDT files for faster parsing
  141.   with the "PRE" command line option.
  142. - Updated the Terminal program a bit.
  143. _____________________________________________________________________________
  144.  
  145. Changes made in 1.59:
  146.  
  147. - Removed a bug in the expression evaluator that made the indirection 
  148.   operator [] unuseable.
  149. - Removed a bug in the conditional break points.
  150. - Rewrote parts of the system segment.
  151. - Added support for the CyberGuard. That's not yet tested, however!
  152. - Added more '040 instructions I forgot.
  153. - Fixed a bug in the disassembler.
  154. - The previous fix of the "NODE" command broke it even more, fixed!
  155. - Fixed plain MC68000 support that was broken since 1.56.
  156. _____________________________________________________________________________
  157.  
  158. Changes made in 1.58:
  159.  
  160. -Added two '040 instructions I wasn't aware of.
  161. -Rewrote the complete math support, an FPU is no longer required.
  162. -Enhanced the "NODE" command, it displays now all additional information
  163.  it can hold of.
  164. -Removed a stupid bug from the "NODE" command.
  165. -Added the "LABS" command to view the defined labels. Study the doc file for
  166.  details.
  167.  
  168. _____________________________________________________________________________
  169.  
  170. Changes made in 1.57:
  171.  
  172. -Added PAL/NTSC switch.
  173. -Added a check for many command that won't work in a splitted display.
  174.  
  175. _____________________________________________________________________________
  176.  
  177. Changes made in 1.56:
  178.  
  179. -Removed a bug in the printer hardware driver that caused one additional
  180.  character to be printed.
  181. -Added command to eject paper.
  182. -Added Enforcer support for the MC68020 and MC68030 CPUs.
  183. -Added partial MMU support, however no MMU related commands are available.
  184.  Enforcer must be run for this purpose.
  185. -Added IRQ CopyBack mode.
  186. -Fixed several final bugs in the 1.55 release, esp. some MC68060 related,
  187.  although the support isn't complete yet ('60 FPU support is still somewhat
  188.  broken, as the FPU part must be re-written anyways).
  189.  
  190.  
  191. Thomas,
  192.     April 1998