reattach-to-user-namespace 项目技术文档

1. 安装指南

1.1 编译安装

首先，从本仓库中编译 reattach-to-user-namespace 程序，并将其添加到你的 PATH 中：

make reattach-to-user-namespace
cp reattach-to-user-namespace ~/bin

1.2 使用 MacPorts 或 Homebrew 安装

你也可以通过 MacPorts 或 Homebrew 安装：

port install tmux-pasteboard

或

brew install reattach-to-user-namespace

2. 项目的使用说明

2.1 配置 tmux

在 .tmux.conf 文件中配置 tmux，使其使用 reattach-to-user-namespace 包装程序启动每个新窗口的 shell：

set-option -g default-command "reattach-to-user-namespace -l zsh"

2.2 重启 tmux 服务器

重启 tmux 服务器以应用更改：

tmux kill-server

2.3 使用说明

配置完成后，你可以在新的 shell 窗口中使用 pbpaste 和 pbcopy 等命令。

3. 项目API使用文档

3.1 reattach-to-user-namespace 命令

reattach-to-user-namespace 是一个包装程序，用于重新附加到用户命名空间，并执行指定的程序。

3.1.1 基本用法

reattach-to-user-namespace program args...

3.1.2 选项

• -l：重写执行程序的 argv[0]，使其以 - 开头，表示启动为“登录” shell。

示例：

exec reattach-to-user-namespace -l "$SHELL"

3.2 诊断程序

test 程序用于测试和诊断与 daemon(3) 和私有“vproc”函数相关的功能。

示例：

./test daemon=sys system=pbpaste

4. 项目安装方式

4.1 手动编译安装

通过以下命令手动编译并安装：

make reattach-to-user-namespace
cp reattach-to-user-namespace ~/bin

4.2 使用包管理器安装

通过 MacPorts 或 Homebrew 安装：

port install tmux-pasteboard

或

brew install reattach-to-user-namespace

通过以上步骤，你可以成功安装并配置 reattach-to-user-namespace 项目，使其在 tmux 中正常使用 pbpaste 和 pbcopy 等命令。