1 / 4概念
Runtime: Object Model and ABI
同一个 struct 在两种编译器下可能大小不同,同一个函数在两种平台上可能从不同寄存器取参。C 标准没有规定这些细节,平台 ABI 规定了。读一份导出头文件,先回答四个问题:每个字段的偏移是多少、参数落在哪个寄存器、返回值走寄存器还是隐藏指针、变参调用前 %al 是否已设置。答不上来,跨语言调用只能靠试。
1 概念
1.1 一句话定义
ABI 是编译器、链接器、操作系统与其它语言共同遵守的二进制契约:它规定类型宽度、对齐、聚合体布局、参数与返回值的寄存器或栈位置、栈帧形状、寄存器保存责任、符号命名与变参协议。C 标准规定源码语义,ABI 规定这些语义如何落成机器码。
1.2 它解决什么问题
- 分离编译:每个目标文件可以由不同版本的编译器生成,只要 ABI 一致就能互调。
- 动态库与插件:库升级不必重编调用方,前提是 ABI 不变。
- 跨语言调用:Rust、Go、Python、Java 的 FFI 都以 C ABI 为公共底座。
- 操作系统接口:系统调用、信号处理、
setjmp/longjmp都依赖寄存器与栈约定。 - 调试与展开:gdb 按 ABI 理解栈帧,unwind 表让 backtrace 跨过库边界。
代价是源码可移植不等于二进制可移植;布局的每一处改动都可能静默破坏调用方,而链接器不会报错。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 类型宽度、填充规则、位域语义 | c-types-and-memory |
| 符号、重定位、动态装载 | c-linking-and-loading |
| 跨语言绑定与所有权映射 | c-ffi |
| C++ 的符号修饰、vtable 与异常表 | cpp-object-model-and-abi |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| ABI | 二进制层的调用与布局契约 | 不是 API |
| 对象表示 | 值占用的字节序列,含填充 | 不是值的数学含义 |
| 对齐 | 地址必须是某个 2 的幂的倍数 | 不是大小 |
| eightbyte | SysV 把聚合体切成 8 字节块的分类单位 | 不是字段 |
| 隐藏指针 | 大结构体返回时调用方传入的地址 | 不是可见参数 |
| 红区 | 叶函数可用的 rsp 以下 128 字节 | Windows x64 没有 |
| 影子空间 | Windows x64 调用方预留的 32 字节 | SysV 没有 |
| 变参 | 参数个数与类型在调用点决定 | 不是默认参数 |
| 符号修饰 | 平台在标识符外加的前后缀 | C 不做重载改名 |
2 机制
2.1 心智模型
ABI 是编译器之间的握手,源码只是草稿。 编译器把每个参数按类型分类,塞进寄存器或栈槽;调用方和被调用方必须用同一套分类规则,否则同一份声明会得到两种解释。C 编译器不做跨翻译单元的类型检查,链接器只匹配符号名,所以布局不一致不会被任何一步拦下。
2.2 机制拆解
- 对象布局:成员按声明顺序排列,每个成员的偏移是其对齐的倍数,
sizeof(struct)是最大对齐的倍数;offsetof是唯一可移植的查询方式。__attribute__((packed))与#pragma pack改变规则,代价是未对齐访问。 - 对齐值:SysV AMD64 上
char1、short2、int4、long8、long long8、float4、double8、long double对齐 16 且大小 16、指针 8;Windows x64 上long是 4、long double是 8。用_Alignof查询,用_Alignas提升。 - SysV 传参:整数与指针依次用
rdi、rsi、rdx、rcx、r8、r9,浮点用xmm0到xmm7;两类寄存器独立计数,互不占位;超出部分从右往左压栈;调用前rsp16 字节对齐,函数入口处rsp + 8是 16 的倍数。 - SysV 返回:整数在
rax(必要时rdx),浮点在xmm0(必要时xmm1);大于 16 字节或含未对齐字段的聚合体归为 MEMORY,调用方在栈上留空间并把地址放进rdi,被调用方把该地址放回rax。 - Windows x64 传参:前四个参数按位置用
rcx、rdx、r8、r9,浮点用xmm0到xmm3;调用方必须预留 32 字节影子空间;没有红区;被调用方保存rbx、rbp、rdi、rsi、r12到r15与xmm6到xmm15。 - 聚合体分类:SysV 把聚合体按 8 字节切块,逐块标成 INTEGER、SSE、SSEUP、X87、X87UP、COMPLEX_X87、MEMORY 或 NO_CLASS;任何一块是 MEMORY 就整体走内存,未对齐字段强制 MEMORY。
- 变参:SysV 要求调用方在
al中放入使用的向量寄存器个数,va_list是含gp_offset、fp_offset、overflow_arg_area、reg_save_area四个字段的结构;Windows x64 要求调用方把浮点参数同时复制进对应的整数寄存器;默认实参提升把float提升为double,小于int的整数提升为int。 _Atomic布局:C11 允许原子类型有不同的大小、对齐与表示。x86-64 上 1、2、4、8 字节自然对齐的原子通常无锁,16 字节需要cmpxchg16b;ARM 上 64 位原子往往要求 8 字节对齐。- 符号与稳定性:C 不做 name mangling,符号就是标识符本身;Mach-O 加前导下划线,ELF 不加,PE32 的
stdcall加_name@N后缀,x64 统一无修饰。平台 ABI 由 psABI 文档与 libc 固定,改字段顺序、函数签名、枚举底层类型或调用约定属性都会破坏兼容。
2.3 完整枚举
ABI 契约由十二个部分组成,缺一项跨边界就会出错:
| 组成 | 规定什么 | 违反后的现象 |
|---|---|---|
| 类型宽度 | 各整数类型的字节数与符号性 | LP64 与 LLP64 之间读错字段 |
| 对齐 | 每个类型的地址倍数 | x86 上变慢,ARM 上触发 SIGBUS |
| 聚合体布局 | 成员顺序、内部填充、尾部填充 | sizeof 不同导致数组步长错 |
| 联合体 | 大小取最大成员并对齐 | 读非活跃成员得到不确定字节 |
| 参数分类 | 聚合体切块并归入寄存器类 | 结构体落在错误寄存器 |
| 参数位置 | 整数与浮点寄存器序列、栈顺序 | 调用方与被调用方错位 |
| 返回值 | 寄存器对或隐藏指针 | 大结构体返回时写坏栈 |
| 栈帧 | 16 字节对齐、红区、影子空间、展开信息 | 调用崩溃或 backtrace 断裂 |
| 寄存器保存 | caller-saved 与 callee-saved 清单 | 被调用方破坏调用方局部值 |
| 变参 | al、va_list 形状、默认提升 | 浮点变参读成 0 或垃圾 |
| 原子类型 | 原子类型的大小、对齐与锁自由宽度 | 跨边界复制原子变量撕裂 |
| 符号与修饰 | 名字、可见性、版本节点 | 链接找不到或绑定到错误实现 |
3 实践
3.1 最小示例与追踪
三个函数分别覆盖寄存器返回、隐藏指针返回与混合类传参:
/* abi_demo.c */
#include <stdio.h>
struct pair { int a; int b; }; /* 8 字节,一个 INTEGER 块 */
struct big { long a, b, c; }; /* 24 字节,MEMORY */
struct mix { double x; int y; }; /* 16 字节,SSE + INTEGER */
struct pair make_pair(int a, int b);
struct big make_big(long a);
double sum_mix(struct mix m);
int main(void)
{
struct pair p = make_pair(1, 2);
struct big b = make_big(7);
return p.a + p.b + (int)b.a + (int)sum_mix((struct mix){2.5, 4});
}
cc -std=c17 -O2 -c abi_demo.c && objdump -d --no-show-raw-insn abi_demo.o
示例输出(clang 21,x86-64 SysV;GCC 的指令选择不同但语义一致):
make_pair: # rax = (b << 32) | a
movl %edi, %eax
shlq $32, %rsi
orq %rsi, %rax
ret
make_big: # rdi 是调用方给的隐藏目标地址
movq %rdi, %rax
movq %rsi, (%rdi)
leaq 1(%rsi), %rcx
movq %rcx, 8(%rdi)
addq $2, %rsi
movq %rsi, 16(%rdi)
ret
sum_mix: # xmm0 = x,edi = y
cvtsi2sd %edi, %xmm1
addsd %xmm1, %xmm0
ret
追踪:make_pair 的两个 int 合成一个 8 字节 INTEGER 块放进 rax,低 32 位是 a,高 32 位是 b,这个结构体在寄存器里根本没有内存形态。make_big 返回 24 字节,超过 SysV 的 16 字节上限,编译器改成 MEMORY:调用方在栈上留空间,把地址放进 rdi;函数把 rdi 原样放进 rax 作为返回。sum_mix 的 double 占一个 SSE 块走 xmm0,int 占一个 INTEGER 块走 edi,两个寄存器序列独立计数。这解释了为什么把返回大结构体的 FFI 声明写成返回值时,第一个可见参数会莫名变成指针。
3.2 选型矩阵
| 场景 | 选择 | 理由 | 风险 |
|---|---|---|---|
| 字段总宽不超过 16 字节且全为标量 | 按值传 struct | 寄存器传递,无分配 | 改字段就换分类,双方必须重编 |
| 超过 16 字节或含数组 | 传 const 指针 | 避免复制 | 调用方保证生命周期 |
| 热路径上的句柄 | 按值传 8 字节整数或指针 | 单寄存器 | 不要把指针包进 struct 再传 |
| 跨语言边界 | 固定宽度整数、指针、显式长度数组 | 各语言都实现 | 不传 long double、位域、裸 enum |
| 日志与格式化 | 导出 v 版本加 va_list | 可包装成多层 | 跨 ABI 不传变参 |
| 共享内存中的标志 | 8 字节自然对齐整数 | 保证单指令原子 | 不要跨缓存行 |
| 稳定插件接口 | 不透明指针加版本化函数表 | 布局可演进 | 需要运行期版本检查 |
3.3 决策规则
- 每个跨边界
struct都配_Static_assert(sizeof(...))与offsetof断言,放进头文件而不是测试文件。 - 不导出带位域、
long double或裸enum的结构体;必须导出时改成固定宽度字段并显式补齐。 - 导出函数一律用原型声明,编译加
-Wmissing-prototypes -Wstrict-prototypes,让无原型调用在编译期暴露。 - 需要 ABI 兼容时只增不改:新函数追加,旧函数保留,结构体只通过不透明指针暴露。
- 把布局断言纳入 CI:用两种编译器各编一次,比对
sizeof与offsetof的输出。
4 边界
4.1 典型故障
| 症状 | 根因 | 诊断 | 修复 |
|---|---|---|---|
| 调用后第二个参数变成第一个 | 声明与定义参数类型不一致,或无原型调用 | objdump -d 看调用点寄存器;-Wmissing-prototypes | 统一头文件,全部用原型 |
| 结构体大小在两台机器上不同 | 位域、枚举或 long double 参与布局 | 两边打印 sizeof 与每个 offsetof | 换固定宽度字段,显式填充并断言 |
| 调用返回大结构体的函数就段错误 | FFI 把它声明为返回值,ABI 要求隐藏指针 | 反汇编看 rdi 是否被写入 | 声明改为输出指针 |
变参函数里 double 读出来是 0 | 缺原型导致默认提升未生效,或 Windows x64 未复制到整数寄存器 | 反汇编看 al 与对应寄存器 | 提供原型;跨 ABI 不用变参 |
macOS 链接报 _foo 未定义 | Mach-O 符号带前导下划线,汇编里写了裸名 | nm 看目标文件符号 | 用 C 声明让编译器生成符号 |
_Atomic 字段跨边界后值撕裂 | 原子类型布局由实现决定,整体复制不是原子操作 | _Static_assert 加 atomic_is_lock_free | 边界上不传原子类型,先 load 成普通类型 |
| 升级库后调用方读到错误字段 | 结构体中间插入字段,ABI 被静默破坏 | abidiff 或比对 offsetof | 只在尾部追加,或改用不透明指针 |
4.2 可观测信号
布局先看 pahole(读 DWARF)与 -Wpadded,符号看 nm 与 readelf -sW,调用约定看 objdump -d 与 gdb 的 info registers,兼容性看 abidiff 对两个版本库的比较。跨语言问题时,先确认符号名,再确认参数寄存器,最后确认返回值通道,顺序不要颠倒。
4.3 安全 / 性能 / 一致性边界
- 安全:ABI 不做类型检查,伪造的函数指针可以跳到任何地址;把内部结构体布局暴露在头文件里,等于把写入偏移也告诉调用方。
- 性能:按值传大结构体产生复制,MEMORY 类走栈;
long double在 SysV 上走 x87,比 SSE 慢一个层级。 - 一致性与移植:同一 CPU 上不同操作系统的 ABI 不同,32 位与 64 位也不同;
packed、位域顺序、枚举宽度都是实现定义或扩展,跨平台代码必须显式固定。