最近在阅读musl libc源码时，发现其mmap的实现非常精妙，特分享给大家。
一、代码整体结构
这段代码实现了__mmap函数，并通过weak_alias导出为mmap。这是典型的musl libc风格——提供弱符号以便用户可以重写。
weak_alias(__mmap, mmap);
二、关键宏定义解析
#define UNIT SYSCALL_MMAP2_UNIT // 通常为4096（页大小） #define OFF_MASK ((-0x2000ULL << (8*sizeof(syscall_arg_t)-1)) | (UNIT-1))
OFF_MASK的作用：用于检查offset是否对齐到页边界。
UNIT-1：低12位全1（4095 = 0xFFF）- 高位全1：确保offset的高位不会溢出
三、三道安全检查
1️⃣ Offset对齐检查
if (off & OFF_MASK) { errno = EINVAL; return MAP_FAILED; }
防止未对齐的offset导致未定义行为。
2️⃣ 长度检查
if (len >= PTRDIFF_MAX) { errno = ENOMEM; return MAP_FAILED; }
防止长度过大导致指针运算溢出。
3️⃣ MAP_FIXED特殊处理
if (flags & MAP_FIXED) { __vm_wait(); }
当使用MAP_FIXED时，等待可能存在的异步操作完成。__vm_wait默认为空函数（弱别名），可被用户实现。
四、系统调用适配
#ifdef SYS_mmap2 ret = __syscall(SYS_mmap2, start, len, prot, flags, fd, off/UNIT); #else ret = __syscall(SYS_mmap, start, len, prot, flags, fd, off); #endif
mmap vs mmap2的区别：
表格
| 系统调用 | offset单位 | 适用场景 |
|---|---|---|
| mmap | 字节 | 通用 |
| mmap2 | 页（4KB） | 32位系统节省参数空间 |
五、最精彩的Bug修复
if (ret == -EPERM && !start && (flags&MAP_ANON) && !(flags&MAP_FIXED)) ret = -ENOMEM;
修复了Linux内核的一个历史Bug：
当匿名映射（MAP_ANON）且start=NULL时，某些内核版本会错误返回EPERM而不是ENOMEM。这个补丁将其修正为ENOMEM，符合POSIX标准。
六、设计亮点总结
表格
| 特性 | 说明 |
|---|---|
| ✅ 可移植性 | 同时支持mmap和mmap2 |
| ✅ 安全性 | 严格的参数校验 |
| ✅ 可扩展性 | weak_alias支持用户自定义 |
| ✅ 鲁棒性 | 修复内核Bug |
| ✅ 性能 | 直接系统调用，无额外开销 |
七、学习建议
这段代码虽然只有60行，但涵盖了：
- 系统调用封装技巧
- 弱符号的使用
- 位运算的巧妙应用
- 内核兼容性处理
推荐阅读：
- musl libc官方文档
- Linux man page:
mmap(2)
标签：#musl #libc #mmap #系统编程 #源码分析 #Linux内核
参考：musl libc 1.2.4 src/mmap/mmap.c
💬 你在项目中遇到过mmap的哪些坑？欢迎评论区讨论！
⭐ 觉得有帮助的话，点赞收藏不迷路~
