Repository files navigation

rr is a lightweight tool for recording, replaying and debugging execution of applications (trees of processes and threads).Debugging extends gdb with very efficient reverse-execution, which in combination with standard gdb/x86 features like hardware data watchpoints, makes debugging much more fun. More information about the project, including instructions on how to install, run, and build rr, is athttps://rr-project.org. The best technical overview is currently the paperEngineering Record And Replay For Deployability: Extended Technical Report.

Or go directly to theinstallation and building instructions.

Please contribute! Make sure to review thepull request checklist before submitting a pull request.

If you find rr useful, pleaseadd a testimonial.

rr development is sponsored byPernosco and was originated byMozilla.

• Linux kernel >= 4.7 (for support of__WALL inwaitid())
  • rr 5.6.0 worked with kernel 3.11 (requiringPTRACE_SETSIGMASK)
• rr currently requires either:
  • An Intel CPU withNehalem (2010) or later microarchitecture.
  • Certain AMD Zen or later processors (seehttps://github.com/rr-debugger/rr/wiki/Zen)
  • Certain AArch64 microarchitectures (e.g. ARM Neoverse N1 or the Apple Silicon M-series)
• Running in a VM guest is supported, as long as the VM supports virtualization of hardware performance counters. (VMware and KVM are known to work; Xen does not.)