Debugging protips

Protips both for debugging rr and tracees.

Debugging rr

Debug logging: all .cc files (should) have a line near the top that looks like

//#define DEBUGTAG "Sched"

Uncomment the definition and you'll get full, verbose, debug-level logging output.

Debugging tracees

Use assert_exec() to launch a gdbserver: if you want to debug a tracee t, add a call like the following assert_exec(t, false, ""). A gdbserver will launch for t with a message like

[EMERGENCY] (file:line:function: errno: None) (task X (rec:Y) at trace line Z)
 -> Assertion `false' failed to hold: '
(rr debug server listening on :X)

A gdb tracee-program then (gdb) target remote :X will attach to the gdbserver.

Lookup a Task: whose (recorded!) tid you know*: in a debugger (gdb) p Task::find([tid]).

Launch a gdbserver for arbitrary tasks at arbitrary times: sometimes there's not a single point at which you want to launch the gdbserver. You can do this by attaching a debugger to rr and then manually starting a gdbserver for a given task

$ gdb -p $(pidof rr)
...
(gdb) p 'Task::find'([tid])
$1 = (Task *) 0x818c1c8
(gdb) call emergency_debug($1)
(rr debug server listening on :X)

Then in another shell, follow the instructions above for attaching to a tracee.