前言

glibc 庞大而复杂，musl 以小著称。但 musl 的 _INTERNAL_SYSCALL_H 这个头文件，密度极高，设计极为精巧。

今天逐行拆透它，你会看到：零运行时开销的可变参数分发、三层 ABI 兼容、以及对 Linux 历史包袱的优雅处理。

---

一、先看调用链路

用户写：

syscall(SYS_write, fd, buf, len);

展开后：

syscall(...)
→ __syscall_ret(__syscall(...))
→ __SYSCALL_DISP(__syscall, SYS_write, fd, buf, len)
→ __syscall4(SYS_write, fd, buf, len)
→ 真正的 syscall 指令
→ __syscall_ret() 转换错误码

全程编译期展开，没有任何函数调用开销。

---

二、可变参数宏 —— 全书最精彩的 10 行

#define __SYSCALL_NARGS_X(a,b,c,d,e,f,g,h,n,...) n
#define __SYSCALL_NARGS(...) __SYSCALL_NARGS_X(__VA_ARGS__,7,6,5,4,3,2,1,0,)
#define __SYSCALL_CONCAT(a,b) a##b
#define __SYSCALL_DISP(b,...) __SYSCALL_CONCAT(b,__SYSCALL_NARGS(__VA_ARGS__))(__VA_ARGS__)

原理：__SYSCALL_NARGS_X 有 9 个命名参数。调用时：

__SYSCALL_NARGS(a, b, c)
→ __SYSCALL_NARGS_X(a, b, c, 7,6,5,4,3,2,1,0,)
→ __VA_ARGS__ 匹配到 "c,7,6,5,4,3,2,1,0"，取最后一个命名参数 n = 3

然后 __SYSCALL_CONCAT(__syscall, 3) → __syscall3。

对比 glibc：glibc 用 INLINE_SYSCALL 宏，也是类似思路，但 musl 的实现更简洁，没有嵌套 ifdef。

---

三、三层 ABI 兼容

这个头文件处理了 三层兼容性：

层级	问题	解决方式
32 vs 64 位	SYS_stat vs SYS_stat64	#ifdef SYS_stat64 重定向
time64	2038 年溢出	所有时间系调用默认指向 _time64 版本
socketcall	历史遗留	__alt_socketcall 优先原生，失败回退

关键代码：

#ifdef SYS_stat64
#undef SYS_stat
#define SYS_stat SYS_stat64
#endif

#ifndef SYS_clock_gettime
#define SYS_clock_gettime SYS_clock_gettime64
#endif

用户代码永远写 SYS_stat，musl 自动选对。

---

四、__syscall_ret —— 错误码转换的细节

Linux 返回 -4095 ~ -1 表示错误，POSIX 要求返回 -1 并设 errno。

hidden long __syscall_ret(unsigned long r)
{
    // r 在 -4095~-1 时，转换为 -1~-4095
    return r > -4096UL ? r : -r;  // 实际有更复杂的位运算
}

这就是为什么 musl 的 syscall() 永远返回 -1 或正值，从不返回 -38 这种原始错误码。

---

五、syscall_cp —— 多线程的 cancellation point

#define syscall_cp(...) __syscall_ret(__syscall_cp(__VA_ARGS__))

_cp = cancellation point。在 pthread_cancel 生效的位置，这些调用允许线程被安全取消。

read()、write()、wait()、sigsuspend() 等都有 _cp 版本。

---

六、open / pause / wait4 的兼容性处理

函数	旧内核	新内核
open	SYS_open	SYS_openat(AT_FDCWD, ...)
pause	SYS_pause	SYS_ppoll(NULL, 0, NULL, NULL)
wait4	SYS_wait4	__emulate_wait4() 模拟

#ifdef SYS_open
#define __sys_open2(x,pn,fl) __syscall2(SYS_open, pn, (fl)|O_LARGEFILE)
#else
#define __sys_open2(x,pn,fl) __syscall3(SYS_openat, AT_FDCWD, pn, (fl)|O_LARGEFILE)
#endif

---

七、为什么 musl 能这么小

对比 glibc 的系统调用层：

特性	glibc	musl
可变参数	INLINE_SYSCALL 宏	__SYSCALL_NARGS 宏
ABI 兼容	大量 ifdef 分散在各处	集中在这个头文件
错误处理	__syscall_error	__syscall_ret
代码量	~5000 行	~600 行

musl 的哲学：把差异集中在一层，上层代码完全无感知。

---

总结

_INTERNAL_SYSCALL_H 是 musl 最值得细读的头文件之一。它证明了一件事：

C 宏在设计得当时，可以实现接近零开销的抽象，同时保持极强的可移植性。

如果你在写需要跨架构的底层库，这个文件的宏设计值得反复学习。

---

参考：

• musl 源码：https://git.musl-libc.org/cgit/musl/tree/src/internal/syscall.h
• Linux man 2 syscall
• LWN: The 64-bit time_t problem (https://lwn.net/Articles/795225/)

---