home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / languages / elisp / packages / xdb.help < prev    next >
Encoding:
Text File  |  1992-12-12  |  12.6 KB  |  225 lines
  1.                       XDB SYMBOLIC DEBUGGER ON-LINE HELP   
  2.  
  3. Setting breakpoints:   
  4. b [location] [\count] [commands]   Set breakpoint.  
  5. ba [address] [\count] [commands]   Set breakpoint at code address. 
  6. bb [depth] [\count] [commands]     Set breakpoint at procedure beginning. 
  7. bi expr.proc [\count] [commands]   Set an instance breakpoint. 
  8. bi [-c|-C] expr [commands]         Set an instance breakpoint. 
  9. bp [commands]                      Set procedure breakpoints. 
  10. bpc [-c|-C] class [commands]       Set a class breakpoint. 
  11. bpo [[class]::]proc [commands]     Set breakpoints on overloaded functions. 
  12. bpt [commands]                     Set procedure trace breakpoints.
  13. bpx [commands]                     Set procedure exit breakpoints. 
  14. bt [(depth | proc)] [\count] [commands]      Trace procedure. 
  15. bu [depth] [\count] [commands]     Set up-level breakpoint. 
  16. bx [depth] [\count] [commands]     Set breakpoint at procedure exit. 
  17. bpg [commands]                     Set paragraph breakpoints.       (MPE-only) 
  18. tpg [commands]                     Set paragraph trace breakpoints. (MPE-only)
  19.    
  20. View and modify breakpoint status:   
  21. lb                            List all breakpoints. 
  22. db [number | *]               Delete one or all breakpoints.  
  23. dp                            Delete procedure breakpoints. 
  24. Dpx                           Delete procedure exit breakpoints. 
  25. Dpt                           Delete procedure trace breakpoints.
  26. dpg                           Delete paragraph [trace] breakpoints.(MPE-only)
  27. ab [number | *]               Activate one or all breakpoints. 
  28. sb [number | *]               Suspend one or all breakpoints. 
  29. tb                            Toggle overall breakpoints state. 
  30. abc commands                  Global breakpoint commands.  
  31. dbc                           Delete global breakpoint commands.  
  32. bc number expr                Set a breakpoint count.  
  33.    
  34. i expr {commands} [{commands}]     Conditionally execute commands.  (Also: if)
  35. { }                           Group commands. 
  36. ;                             Separate commands. 
  37. Q                             Quiet breakpoint reporting. 
  38.  "any string"                 Print string. 
  39.    
  40. View and modify data:   
  41. p expr [\format]              Print value of expression using format.  
  42. p expr?format                 Print address of expression using format.  
  43. p -[\format]                  Print value of prev memory location using format.  
  44. p +[\format]                  Print value of next memory location using format.  
  45. p class::                     Print static members of class. 
  46. l [[class]::][proc[:depth]]   List all parameters and locals of proc.
  47. t [depth]                     Trace stack. 
  48. T [depth]                     Trace stack and show local variables. 
  49. lr [string]                   List all (or matching) registers. 
  50. lc [string]                   List all (or matching) commons. (PA-RISC only) 
  51. lg [string]                   List all (or matching) globals. 
  52. ls [string]                   List all (or matching) special variables. 
  53. mm [string]                   Show memory-map of all (or matching) loaded
  54.                               shared-libraries
  55. f ["printf-style-format"]     Set address printing format. 
  56. disp item [\format]           Display Cobol data item value using format.(MPE- 
  57.                               only) 
  58. move val to item              Move value "val" to cobol data item "item" (MPE- 
  59.                               only) 
  60. pq <<same as p>>              Print quietly.  Evaluate without printing. 
  61. ll [string]                   List all (or matching) labels.
  62. lz                            List all signals. 
  63. z [number] [i][r][s][Q]       Toggle flags (ignore, report, stop, Quiet) for  
  64.                               signal.  
  65. Process control:   
  66. r [arguments]                 Run child process with arguments.  
  67. R                             Run child process with no arguments.  
  68. c [location]                  Continue from breakpoint with no signal, set
  69.                               temporary breakpoint at location.
  70. C [location]                  Continue with current signal, set temporary
  71.                               breakpoint at location.
  72. s [number]                    Single step, follow procedure calls.  
  73. S [number]                    Single step, step over procedure calls.  
  74. g (line | #label)             Go to line in current procedure.  
  75. g (+|-) [lines]               Go forward/back 1 or given number of lines.  
  76. k                             Kill child process, if any.  
  77.    
  78. Source viewing:   
  79. L                             Show current location and its source line.  
  80. v [location]                  View source at location in source window.  
  81. va [address]                  View address in disassembly window. 
  82. V [depth]                     View procedure at depth in source window.
  83. top                           View procedure at top of stack.
  84. up [number]                   View procedure number levels higher in stack.
  85. down [number]                 View procedure number levels lower in stack.
  86. +[number]                     Move forward in sourcefile.  
  87. -[number]                     Move backward in sourcefile.  
  88. /[string]                     Search forwards in sourcefile for string.  
  89. ?[string]                     Search backwards for string.  
  90. n                             Repeat previous search.  
  91. N                             Repeat previous search in opposite direction.  
  92. apm old_path [new_path]       Add (prefix) path map for source files.  
  93. dpm [index | *]               Delete path map(s) for source files.  
  94. lpm                           List path maps in order of precedence.  
  95. D "dir"                       Add a directory search path for source files.  
  96. ld                            List all directories. 
  97. lf [string]                   List all (or matching) files. 
  98. lp [[class]::][string]        List all (or matching) procedures. 
  99. lo [[class]::][string]        List all (or matching) overloaded functions.
  100.    
  101. Screen modes:   
  102. am                            Activate more (turn on pagination). 
  103. sm                            Suspend more (turn off pagination). 
  104. w number                      Set size of source window.  
  105. td                            Toggle disassembly mode.
  106. ts                            Toggle split-screen mode.
  107. fr                            Display floating point registers.
  108. gr                            Display general registers.
  109. tf                            Toggle float register display precision (PA-RISC
  110.                               only).
  111. sr                            Display special registers.      (PA-RISC only)
  112. u                             Update screen.  
  113. U                             Refresh source & location windows on screen.  
  114. +r                            Scroll floating point registers forward. 
  115. -r                            Scroll floating point registers backward. 
  116.    
  117. Assertions:   
  118. a commands                    Create a new assertion with a command list.  
  119. aa (number | *)               Activate one or all assertions. 
  120. da (number | *)               Delete one or all assertions.  
  121. la                            List all assertions. 
  122. sa (number | *)               Suspend one or all assertions. 
  123. ta                            Toggle overall assertions state. 
  124. x [expr]                      Exit assertion mode, possibly aborting the 
  125.                               assertion command list. 
  126. Macros:   
  127. def name [replacement-text]   Define a macro name.  
  128. lm [string]                   List all (or matching) macros. 
  129. tm                            Toggle the macro substitution mechanism. 
  130. undef (name | *)              Remove the macro definition for name or all.  
  131.    
  132. Record and playback:   
  133. tr [@]                        Toggle the record [record-all] mechanism. 
  134. < file                        Playback from file.  
  135. << file                       Playback from file with single stepping.  
  136. > file                        Record commands to file.  
  137. >> file                       Append commands to file.  
  138. >@ file                       Record-all debugger commands & output to file.  
  139. >>@ file                      Append all debugger commands & output to file.  
  140.                    ">>" is equivalent to ">" for the next four commands.   
  141. >                             Show status of current recording file.  
  142. >@                            Show status of current record-all file.  
  143. >(t | f | c)                  Turn recording on (t), or off (f), or close the  
  144.                               recording file (c).  
  145. >@(t | f | c)                 Turn record-all on (t), or off (f), or close the  
  146.                               record-all file (c).  
  147.    
  148. Misc:   
  149. ss file                       Save (breakpoint, macro, assertion) state.
  150. tc                            Toggle case sensitivity in searches. 
  151. <carriage-return>             Repeat previous command.  
  152. ~                             Repeat previous command.  
  153. ! [command-line]              Execute shell (with or without commands).  
  154. q                             Quit debugger.  
  155. $addr                         Unary operator, address of object.  
  156. $sizeof                       Unary operator, size of object.  
  157. $in                           Unary boolean operator, execution in procedure.  
  158. # [text]                      A comment.  
  159. I                             Print debugger status. 
  160. M [(t | c) [expr [; expr ...]]]    Print or set (text or core) maps. 
  161.    
  162. VARIABLES   
  163. var                                     Search current procedure and globals.   
  164. class::var                              Search class for variable.   
  165. [[class]::]proc:[class::]var            Search procedure for variable.   
  166. [[class]::]proc:depth:[class::]var      Search procedure at depth on stack.   
  167. :var or ::var                           Search for global variable only.   
  168. .                                       Shorthand for last thing you looked at.   
  169. $var                                    Define or use special variable.   
  170.    
  171. $result                       Return value of last cmd line procedure call.  
  172. $signal                       Current child process signal number. 
  173. $lang                         Current language for expression evaluation.  
  174. $depth                        Default stack depth for local variables.  
  175. $print                        Display mode for character data.  
  176. $line                         Current source line number.  
  177. $malloc                       Debugger memory allocation (bytes).  
  178. $step                         Instr. count in non-debug before free-run.  
  179. $cplusplus                    C++ feature control flags.  
  180. $regname                      Hardware registers. 
  181. $fpa                          Treat fpa sequence as one instruction.(S300 only) 
  182. $fpa_reg                      Address register for fpa sequences.   (S300 only)
  183.    
  184. LOCATIONS   
  185. line                                    source line & code address (if any)   
  186. #label                                  "   
  187. file[:line]                             "   
  188. [file:]proc[:proc[...]][:line|#label]   "   
  189. [class]::proc[:line|#label]             "   
  190. proc#line                               code address (if any)   
  191. [class]::proc#line                      "   
  192. name@shared_lib                         Address of name in shared library   
  193.    
  194. FORMATS   
  195.           A format has the form [count]formchar[size].  formchar's are:   
  196.  a                  Address of first byte of string.   
  197. (b | B)             Byte in decimal (either way).   
  198. (c | C)             (Wide) character.   
  199. (d | D)             (Long) decimal.   
  200. (e | E)             E floating point notation (as double).   
  201. (f | F)             F floating point notation (as double).   
  202. (g | G)             G floating point notation (as double).   
  203.  i                  Machine instruction (disassembly).   
  204. (k | S)             Formatted structure display.   
  205.      K              Formatted structure display with base classes.   
  206.  n                  "Normal" format, based on type.   
  207. (o | O)             (Long) octal.   
  208.  p                  Print name of procedure containing address.   
  209.  s                  String.   
  210.  t                  Print type of object.   
  211.      T              Print type of object with base classes.   
  212. (u | U)             (Long) unsigned decimal.   
  213.  w                  Wide character string.   
  214.      W              Address of wide character string.   
  215. (x | X)             (Long) hexadecimal.   
  216. (z | Z)             (Long) binary.   
  217.           Size can be a number or one of the following:   
  218.  b                 1 byte (char)   
  219.  s                 2 bytes (short)   
  220.  l                 4 bytes (long)   
  221.  D                 8 bytes (double - floating point formats only)   
  222.  L                 16 bytes (long double - floating point only)   
  223.  
  224. @(#) A.08.07   HP-UX SYMBOLIC DEBUGGER (xdb.help)   $Revision: 70.1 $
  225.