如何从manpage直接获知Linux系统调用errno的触发顺序？

问题描述 #

我正在为libc实现系统调用包装器，需要为其添加单元测试。目前主要通过man手册了解系统调用的预期返回值及errno，实际测试中发现errno有时不符合预期：比如下面这段代码：

unsigned long page_size = sysconf(_SC_PAGESIZE);
void * page = mmap(nullptr, page_size, PROT_READ | PROT_WRITE,
                                  MAP_ANONYMOUS | MAP_PRIVATE, -1, 0);
EXPECT_THAT(mlock(holder.addr, negative_size), Fails(EINVAL));

按照POSIX标准的预期，这个系统调用包装器应该返回EINVAL，但在ulimit -l 16384的受限环境下实际返回了ENOMEM——原因是内核会先检查权限与资源限制，再检查地址溢出。另外，不同来源的man手册中errno的列表顺序完全不同，想问有没有不用每次查看内核代码就能获知预期errno的简洁方法？

可行的简洁方法 #

• 重点查看man手册的NOTES/BUGS章节：多数系统调用的man页会明确标注Linux与POSIX标准的差异，以及不同场景下可能返回的errno优先级，比如mlock的手册通常会说明资源限制触发ENOMEM的情况，以及检查顺序导致的errno返回逻辑。
• 参考errno(3)的标准化说明：errno(3)会区分POSIX标准定义的errno和Linux特有的扩展，同时明确哪些errno在特定场景下会被优先返回。
• 借鉴成熟libc的测试套件：glibc、musl等主流libc的测试用例已经覆盖了各种边界场景（包括资源受限、参数非法等）的errno情况，直接参考它们的测试逻辑即可，比如glibc的mlock测试用例会分别处理ENOMEM和EINVAL的不同触发条件。
• 用strace直接验证：在目标环境下通过strace执行测试代码，能直接观察内核返回的errno，这是最直观的方式，无需翻阅内核代码就能获取真实环境下的准确返回值。

内容的提问来源于stack exchange，提问作者Schrodinger ZHU