使用cheri-gdb调试CheriBSD代码报错：unsupported relocation type 0xe802

API 探路者

2026-7-17

解决Cheri-gdb中"BFD: unsupported relocation type 0xe802"错误

原因排查与修复步骤

确保工具链版本严格匹配
CheriBSD的clang/llvm编译器、cheri-gdb调试器必须版本完全对应，版本不兼容是触发该错误的常见原因。执行以下命令检查版本一致性：
```
clang --version
cheri-gdb --version
```
若版本不匹配，用包管理器更新到兼容版本：
```
pkg update && pkg upgrade cheri-gdb llvm cheribsd-toolchain
```
（注：llvm版本号需对应当前CheriBSD分支，比如llvm17可能是部分分支的最新适配版本）
重新编译时明确指定Cheri目标与调试符号
编译时必须生成完整调试符号，并指定纯能力模式的Cheri目标架构，避免工具链混淆：
```
clang -g -target cheri-unknown-freebsd14 -mabi=purecap your_code.c -o your_program
```
其中-g生成调试符号，-target和-mabi=purecap确保输出纯能力模式的可执行文件，与cheri-gdb的调试目标匹配。
更新适配Cheri的BFD库
错误来自BFD（Binary File Descriptor）库，cheri-gdb依赖的BFD库需支持Cheri特有的重定位类型。检查当前binutils版本：
```
pkg info binutils
```
若不是CheriBSD适配版本，执行更新：
```
pkg upgrade binutils
```
清理旧文件后重新编译
残留的旧目标文件或调试缓存可能导致解析冲突，清理后重新构建：
```
rm -f your_program *.o
# 若使用Makefile，需执行清理
make clean
```
之后重新用正确参数编译代码。
验证可执行文件格式
用file命令确认生成的程序是Cheri纯能力格式：
```
file your_program
```
正常输出应包含pure-capability CheriABI字样，若未出现，说明编译参数有误，需重新检查。