Guide for using RR with CPython
Open
@colesbury is already working on this.
Since Mar 1, 2024.
type-feature
- Dominant language
- Python
- Stars
- 2.1k
- Forks
- 1k
- Avg merge
- 2d 12h
- Merged PRs (30d)
- 12
Description
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
rrfor multiprocessing? (rr replay -p pid or rr replay -f pid) - How to use
rrfor multi-threading issues? - How to use
rrto track down intermittent crashes? (Roughly, record lots of traces until you find a crasher).
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.