C / C++ / 系统课时
看懂系统调用失败信息
看懂系统调用失败信息
系统调用失败时,真正有用的信息通常不在函数名本身,而在返回值与 errno。本文用一次必然失败的 open 调用,演示如何立即保存错误码,再用 perror 和 strerror 输出可定位的原因,并说明哪些写法会读到过期错误。
学习目标
- 能根据系统调用返回值判断操作是否失败。
- 能正确读取和保存
errno,避免错误信息被后续调用干扰。 - 能选择
perror或strerror输出便于排查的失败原因。
先判断返回值,再读取 errno
Linux 下很多系统调用在失败时返回 -1,同时把失败原因写入线程自己的 errno。例如 open 成功时返回文件描述符,失败时返回 -1。正确顺序始终是先检查返回值,确认失败后再读取 errno,而不是先看 errno 猜测操作是否成功。
errno 不会在每次成功调用后自动清零。即使它当前非零,也不代表刚执行的函数失败。因此,只有函数文档明确说明失败时会设置 errno,并且返回值已经表明失败时,这个值才有诊断意义。
下面的程序尝试打开一个不存在的 /proc 路径,并在失败后立即保存错误码:
#include <errno.h>
#include <fcntl.h>
#include <stdio.h>
#include <string.h>
#include <unistd.h>
int main(void) {
const char *path = "/proc/anystack-no-such-entry/file";
int fd = open(path, O_RDONLY);
if (fd == -1) {
// 先保存失败时的 errno,避免后续库函数改变诊断依据。
int saved_errno = errno;
// perror 读取当前 errno,因此显式恢复为刚才保存的错误码。
errno = saved_errno;
perror("open");
fprintf(stderr, "strerror: %s\n", strerror(saved_errno));
fprintf(stderr, "is ENOENT: %s\n",
saved_errno == ENOENT ? "yes" : "no");
return 1;
}
close(fd);
return 0;
}编译并运行:
gcc -Wall -Wextra -O2 error_demo.c -o error_demo
./error_demo
printf 'exit=%d\n' $?预期输出,在常见英文 Linux 环境中类似:
open: No such file or directory
strerror: No such file or directory
is ENOENT: yes
exit=1错误文本受系统语言环境影响,因此中文或其他语言环境中的文字可能不同;真正稳定、适合程序逻辑判断的是 ENOENT 这样的错误码宏。
perror 和 strerror 分别解决什么问题
perror 适合在失败现场快速打印诊断信息。它读取当前 errno,把调用者提供的前缀、冒号和错误说明输出到标准错误流。例如 perror("open") 可以直接指出是哪个操作失败。
strerror 接收一个错误码并返回对应的说明文本,更适合把错误信息组合进自己的日志格式。前面的示例传入的是保存后的 saved_errno,因此即使中间执行了其他函数,也不会失去最初失败的原因。
如果程序需要根据错误类型决定后续行为,应比较错误码宏,而不是比较错误文本。例如 errno == ENOENT 可以表示路径不存在,errno == EACCES 通常表示权限不足。错误文本主要给人阅读,不适合作为程序分支条件。
最容易写错的几个位置
不要在调用成功后依据残留的 errno 报错。下面这种思路是错误的:先执行 open,却不检查返回值,只判断 errno != 0。之前某次失败留下的错误码可能仍然存在。
也不要在失败后执行一串可能修改 errno 的操作,再去调用 perror。需要跨越其他函数调用保存错误原因时,应像主示例一样先执行 int saved_errno = errno。
实际排障时,可以把系统调用返回值看成“是否失败”的第一层证据,把保存后的 errno 看成“为什么失败”的第二层证据。先确认失败,再解释原因,才能避免被过期错误码误导。