home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / program / szadbbin / differ.doc next >
Encoding:
Text File  |  1990-02-21  |  2.0 KB  |  64 lines
  1.  
  2.     Sozobon ADB
  3.     Debugger for Sozobon C on the Atari ST
  4.     Authors: Johann Ruegg and Don Dugger
  5.  
  6. Introduction
  7. ------------
  8.  
  9. This debugger is designed to be used with the Sozobon C compiler.
  10. It is modeled after the 'adb' command on UNIX systems.  Thus it
  11. is a machine language debugger - not a source level debugger.
  12.  
  13.  
  14. Differences verses the UNIX adb
  15. -------------------------------
  16.  
  17. 1) Szadb can only be used to control a running process - it cannot be
  18. used to look at executables or core files.  Therefore '/' and '?'
  19. commands both refer to memory.  The usage for szadb is
  20.     szadb exec-file
  21. The 'exec-file' is Pexec'ed immediately.  Compile with the '-t' flag
  22. to get symbols in the 'exec-file'.  Symbols are adjusted to reflect
  23. the relocation of the program.
  24.  
  25. 2) Expressions handles by szadb are a little simpler
  26.     - no floating point numbers
  27.     - '+', '^' and '"' are not valid values
  28.     - variables within routines are not understood
  29.     - the unary operand '*' fetches 4 bytes, while '@' fetches
  30.        2 bytes (from memory)
  31.     - the dyadic operator '#' is not supported
  32.  
  33. 3) There is not concept of a map - all addresses refer to memory.
  34. Thus the '*' modifier to '/' and '?' is not used and there is no
  35. '?m' or '/m' command.
  36.  
  37. 4) The following format characters are not supported
  38.     q Q u U f F C Y
  39.  
  40. 5) The '/l' command is missing 
  41.  
  42. 6) There is no shell escape '!' command.
  43.  
  44. 7) The following '$' commands are missing
  45.     $>file $<file $f $a $w $v $m
  46.  
  47. 8) These '$' commands are added
  48.     $p - print the process base page
  49.  
  50. 9) The following ':' commands are missing
  51.     :r (use :s or :c instead - put any parameters to be passed on
  52.         the first :s or :c)
  53.     :k (exit the debugger and start over instead)
  54.  
  55. 10) Breakpoints do not have repeat counts or associated commands
  56.  
  57. 11) There are no internal variables
  58.  
  59. 12) Szadb uses its own window so as not to interfere with the program
  60. being debugged.  Use cntl-w to view the program's window.  Type any
  61. character to switch back.
  62.  
  63. 13) Online help is available.  Use the 'help' key.
  64.