reptyr 项目技术文档

1. 安装指南

1.1 系统要求

reptyr 支持 Linux 和 FreeBSD 操作系统。对于 Linux 系统，reptyr 可以在 i386、x86_64 和 ARM 架构上运行。对于 FreeBSD，部分功能可能不可用，特别是 reptyr -T 选项。

1.2 安装步骤

1. 从源码安装：

   • 克隆项目仓库：

     git clone https://github.com/nelhage/reptyr.git
     

   • 进入项目目录：

     cd reptyr
     

   • 编译并安装：

     make
     sudo make install
     

2. Ubuntu 系统上的特殊配置：

   • 由于 Ubuntu Maverick 及更高版本默认禁用了 ptrace 系统调用，需要手动启用：

     sudo echo 0 > /proc/sys/kernel/yama/ptrace_scope
     

   • 若要永久启用，可以编辑 /etc/sysctl.d/10-ptrace.conf 文件。

2. 项目的使用说明

2.1 基本用法

reptyr 的主要功能是将一个正在运行的程序附加到一个新的终端上。使用方法如下：

reptyr PID

其中 PID 是目标进程的进程 ID。执行该命令后，目标进程将切换到当前终端，并从该终端接收输入和输出。

2.2 典型使用模式

1. 启动长时运行进程：例如 top。
2. 将进程放入后台：按 CTRL-Z。
3. 恢复后台进程：输入 bg。
4. 查看后台进程：使用 jobs -l，输出示例：

   [1]+  4711 Stopped (signal)        top
   

5. 从当前父进程中移除任务：使用 disown top。
6. 启动终端复用器：例如 tmux。
7. 重新附加到后台进程：使用 reptyr 4711。
8. 分离终端复用器并关闭 SSH 会话。
9. 重新连接 SSH 并附加到终端复用器：例如 tmux attach。

2.3 与 screenify 的区别

reptyr 相比 screenify 有以下优势：

• 不会保留旧终端的输入输出。
• 支持窗口大小调整。
• 支持在新的终端中使用 ^C 和 ^Z。

3. 项目 API 使用文档

reptyr 主要通过命令行接口进行操作，没有提供额外的 API。其核心功能是通过 ptrace 系统调用实现的，用户无需直接调用底层 API。

4. 项目安装方式

4.1 从源码安装

如前所述，用户可以通过克隆 GitHub 仓库并编译安装 reptyr。

4.2 依赖项

• 编译 reptyr 需要 make 和 gcc 等基本开发工具。
• 在 Ubuntu 系统上，可能需要手动启用 ptrace 系统调用。

4.3 安装路径

默认情况下，reptyr 会被安装到 /usr/local/bin 目录下。

---

通过以上文档，用户可以了解如何安装、使用 reptyr，并掌握其基本工作原理。