开源项目 rr 的安装和配置指南

开源项目 rr 的安装和配置指南

rr Record and Replay Framework 项目地址: https://gitcode.com/gh_mirrors/rr/rr

1. 项目基础介绍

rr（Record and Replay Framework）是一个轻量级的工具，用于记录、重放以及调试应用程序的执行（包括进程和线程树）。它扩展了 gdb 调试器的功能，提供了非常高效的逆向执行能力。结合 gdb/x86 的硬件数据观察点等特性，可以让调试过程变得更为有趣和高效。rr 项目更多信息可以在其官网 rr-project.org 找到。

该项目主要使用 C++ 编程语言，同时也使用了 C、Python、CMake、汇编、Shell 等语言。

2. 项目使用的关键技术和框架

rr 使用了以下关键技术和框架：

• 记录和重放技术：能够记录程序的执行过程，并在之后精确重放。
• 扩展的 gdb 功能：通过逆向执行等技术，增强调试能力。
• 硬件性能计数器的虚拟化：在虚拟机中支持硬件性能计数器的虚拟化，确保功能的正确执行。

3. 项目安装和配置的准备工作

在安装 rr 之前，需要确保您的系统满足以下要求：

• 操作系统：Linux 内核版本不低于 4.7（为了支持 waitid() 中的 __WALL）。
• CPU 架构：Intel Nehalem（2010年）或更新的微架构，或者某些 AMD Zen 或更新的处理器，或者某些 AArch64 微架构。
• 虚拟机支持：如果运行在虚拟机中，需要 VM 支持硬件性能计数器的虚拟化（VMware 和 KVM 是已知支持的，Xen 不支持）。

安装步骤

1. 安装依赖项

   首先，确保您的系统中安装了以下依赖项：

   sudo apt-get update
   sudo apt-get install -y git build-essential libpfm4 lib Audit libnuma-dev
   

2. 克隆项目

   使用 git 命令克隆 rr 项目：

   git clone https://github.com/rr-debugger/rr.git
   

3. 安装 rr

   进入项目目录，然后编译并安装 rr：

   cd rr
   mkdir build && cd build
   cmake ..
   make
   sudo make install
   

4. 配置系统

   为了使用 rr，可能需要调整系统的内核参数。编辑 /etc/sysctl.conf 文件，添加以下内容：

   kernel.yama.ptrace_scope = 0
   

   然后，重新加载 sysctl 配置：

   sudo sysctl -p
   

5. 验证安装

   最后，运行 rr 命令，确认安装成功并且没有错误信息。

以上步骤为 rr 项目的详细安装和配置指南，适用于小白级用户操作。在安装过程中可能会遇到不同的问题，具体情况需要根据系统环境和版本进行调整。

rr Record and Replay Framework 项目地址: https://gitcode.com/gh_mirrors/rr/rr