# 分享一个开源小工具CAdapt

**URL:** <https://sysec.cc/t/topic/41>\
**Category:** Linux/Unix\
**Created:** [2026 年10 月 26 日 05:42 UTC](https://sysec.cc/t/topic/41 "2026-10-26T05:42:27Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![EBK](https://sysec.cc/user_avatar/sysec.cc/ebk/32/7_2.png) [@EBK](https://sysec.cc/u/EBK)\
发布日期： [2026 年10 月 26 日 05:42 UTC](https://sysec.cc/t/topic/41/1 "2026-10-26T05:42:27Z")

</div>

# 作用简述

**将已编译的 Linux 可执行程序与某个 GLIBC 版本进行兼容**  
**将已编译的 Linux 驱动程序强行适配某个内核版本**  
**关于使用局限性及仓库地址见文章末尾**

# 背景

早期在向低版本glibc环境部署工具链时，总是会遇到找不到高版本glibc符号的问题  
于是就只能在低版本环境从源码构建出高版本glibc  
然后用`LD_LIBRARY_PATH`、`LD_PRELOAD`指向它或者用`patchelf`工具批量修改二进制文件的`rpath`和新的动态链接器路径

但这个方法太麻烦了，让我不由得产生一个疑问，既然报错的符号名称一致，为什么动态链接器非要匹配指定版本的符号？  
既然它能知道elf文件所需的版本，那么这个版本肯定被记录在elf文件中了，那么能不能像修改文本文件一样，把版本调低呢？

# CAdapt【2022】

于是就从网上找elf文件格式资料、相关源码  
果珍，让我找到了一个很久以前别人用c实现的代码  
然后就是编译验证，成功后就是古法分析、注解，然后改造了  
由此，我的第一版[CAdapt](https://github.com/KongQBin/CAdapt)就诞生了  
当然在后面使用过程中也暴露出一些问题，后续又进行了一些修复

# UpModule（2025）

[UpModule](https://github.com/KongQBin/UpModule) 的起因也很简单  
就是因为后面做驱动开发时遇到了类似的问题  
有时内核只是更新了一个小版本，原本正常的驱动就装载不上了  
随后举一反三，既然以前做CAdapt可以直接修改已编译好的elf文件达到兼容的目的  
那么同样修改已经编译好的驱动文件，是否也能达到此类目的呢  
于是便尝试让Ai仿照着CAdapt的做法，输出一套用于内核模块硬兼容的代码  
但不知道是Ai出于对于我这种行为的排斥，还是对内核代码并不了解，一直劝退我，导致最终未果  
后面依旧是扒内核源码，分析内核模块装载时的校验逻辑，然后在代码中反向操作得以实现

# Merge（26.10.02）

国庆节闲来无事，突然想到既然两者都属于同一类型的小工具，为何不合并成一个  
后面再有类似需求再逐渐追加功能，慢慢发展成类似`patchelf`那种的实用工具呢  
虽说现在Ai工具盛行导致工具廉价，但总能节省点token吧  
于是使用gemini对两者进行了合并

# Fix（26.10.12）

开始使用codex，刚好用这种小项目练习一下  
于是便让他检查代码质量、以及有没有bug  
结果这世界上又多了个`回车战士`……

# 注意事项

说了这么多，讲讲局限性吧  
对于glibc的适配：

- 要保证没有用到高版本glibc中特有的符号
  - 例如有些时间相关的……

- 要确定被修改的这个符号使用的一些数据结构没有发生改变，否则即使提示修改成功，实际运行也会崩溃
  - 比如某个结构体在低版本glibc中时32字节，高版本中变成了64字节，即便符号版本被降级成功，依旧ABI版本不兼容

以上两种情况对 kmod 也适用，同时对于启用了 CONFIG\_MODVERSIONS 的内核模块，还需要获取目标内核导出符号对应的 CRC 信息  
如果找不到对应的信息，就需要从系统中已安装的驱动中提取，如果提取到的符号覆盖了你驱动中使用的符号，那么就可以成功，反之失败  
所以在编写驱动之初，就应该限制使用的函数数量以及更多的使用常用内核函数，这样的话再配合当前的工具就能在一定程度上提高驱动的兼容性  
还有一点虽然不常见但也要注意，对于启用了强制模块签名校验的系统，修改后的模块还需要满足相应的签名要求。

# 仓库地址

[CAdapt](https://github.com/KongQBin/CAdapt) - GLIBC & KMOD 符号版本适配工具  
[UpModule](https://github.com/KongQBin/UpModule) - 原内核模块适配项目（已合并归档）
