devguide icon indicating copy to clipboard operation
devguide copied to clipboard

Guide for using RR with CPython

Open colesbury opened this issue 1 year ago • 0 comments

rr is a record & replay debugging tool. I've found it particularly helpful for debugging multiprocessing issues, free-threading bugs, and non-deterministic crashes.

@ericsnowcurrently suggested adding a devguide entry for how to use rr specifically for CPython development. That seems like a good idea to me.

Here are some topics I think are worth covering:

  • How to install rr? The OS provided packages (e.g., Ubuntu) are often out-of-date and may not work well with some CPython test suites or new CPUs. The latest release on GitHub is much better: https://github.com/rr-debugger/rr/releases/
  • How to use rr for multiprocessing? (rr replay -p pid or rr replay -f pid)
  • How to use rr for multi-threading issues?
  • How to use rr to track down intermittent crashes? (Roughly, record lots of traces until you find a crasher).

colesbury avatar Mar 01 '24 17:03 colesbury