DESCRIPTION
The Parrot debuggerSYNOPSIS
parrot_debugger programfile
parrot_debugger --script scriptfile programfile
COMMANDS
- "disassemble"
-
Disassemble the bytecode.
Use this if you have a PBC file but not the PASM.
- "load"
- Load a source code file.
- "list" or "l"
- List the source code file.
- "run" or "r"
- Run the program.
- "break" or "b"
-
Add a breakpoint at the line number given or the current line if none is given.
(pdb) b Breakpoint 1 at pos 0 (pdb) b 10 Breakpoint 1 at pos 10
- "watch" or "w"
- Add a watchpoint.
- "delete" or "d"
-
Given a number n, deletes the n-th breakpoint. To delete the first breakpoint:
(pdb) d 1 Breakpoint 1 deleted
- "disable"
- Disable a breakpoint.
- "enable"
- Reenable a disabled breakpoint.
- "continue" or "c"
- Continue the program execution.
- "next" or "n"
- Run the next instruction
- "eval" or "e"
- Run an instruction.
- "trace" or "t"
- Trace the next instruction. This is equivalent to printing the source of the next instruction and then executing it.
- "print" or "p"
-
Print an interpreter register. If a register I0 has been used, this
would look like:
(pdb) p I0 2
If no register number is given then all registers of that type will be printed. If the two registers I0 and I1 have been used, then this would look like:
(pdb) p I I0 = 2 I1 = 5
It would be nice if ``p'' with no arguments printed all registers, but this is currently not the case.
- "stack" or "s"
- Examine the stack.
- "info"
- Print interpreter information relating to memory allocation and garbage collection.
- "gcdebug"
- Toggle garbage collection debugging mode. In gcdebug mode a garbage collection cycle is run before each opcocde, which is the same as using the gcdebug core.
- "quit" or "q"
- Exit the debugger.
- "help" or "h"
- Print the help.
Debug Ops
You can also debug Parrot code by using the "debug_init", "debug_load" and "debug_break" ops in ops/debug.ops.- "int main(int argc, char *argv[])"
- Reads the PIR, PASM or PBC file from argv[1], loads it, and then calls Parrot_debug().
- "static void PDB_run_code(PARROT_INTERP, int argc, char *argv[])"
- Run the code, catching exceptions if they are left unhandled.
- "static void PDB_printwelcome(void)"
- Prints out the welcome string.
HISTORY
- Initial version by Daniel Grunblatt on 2002.5.19.
-
Start of rewrite - leo 2005.02.16
The debugger now uses it's own interpreter. User code is run in Interp* debugee. We have:
debug_interp->pdb->debugee->debugger ^ | | v +------------- := -----------+
Debug commands are mostly run inside the "debugger". User code runs of course in the "debugee".
TODO
- Check the user input for bad commands, it's quite easy to make it bang now, try listing the source before loading or disassembling it.
- Print the interpreter info.
- Make the user interface better (add comands history/completion).
- Some other things I don't remember now because it's late.
HISTORY
Renamed from pdb.c on 2008.7.15