4. EINTR 错误详解

EINTR（Error Interrupted）是 POSIX 标准中定义的一个关键错误码，表示系统调用在执行过程中被信号中断。理解 EINTR 的产生机制与正确处理方式，是编写健壮系统程序的基础。

4.1 EINTR 的定义与宏值

在 Linux 头文件 <errno.h> 中，EINTR 被定义为整数常量 4（x86 架构）。其宏定义如下：

#define EINTR 4   /* Interrupted system call */

当系统调用因信号中断而提前返回时，内核会将 errno 设置为 EINTR，并返回 -1。应用程序通过检查 errno == EINTR 来判断是否发生了信号中断。

4.2 EINTR 的产生场景

EINTR 主要发生在慢速系统调用（slow system call）中。这类调用可能阻塞进程无限期等待，例如：

• 文件 I/O：read()、write() 在操作管道、终端设备、网络套接字等“慢速”文件描述符时
• 进程同步：wait()、waitpid() 等待子进程状态变化
• 信号等待：pause()、sigsuspend()、sigwaitinfo()
• 文件锁：flock()、fcntl() 的 F_SETLKW 操作
• 消息队列：mq_receive()、mq_send()
• Socket 操作：connect()、accept()、recv()、send()

4.3 read/write 被信号中断的典型流程

以下 SVG 图展示了 read() 系统调用被信号中断的完整生命周期：

4.4 POSIX 标准对 EINTR 的规定

POSIX.1-2001 及后续版本对 EINTR 有明确规范：

• 慢速系统调用：如果系统调用被信号处理函数中断，且信号处理函数没有使用 SA_RESTART 标志，则系统调用应返回 EINTR。
• 自动重启：使用 sigaction() 注册信号处理函数时，若设置 sa_flags |= SA_RESTART，内核会自动重启某些被中断的系统调用（如 read()、write()、wait()），应用程序不会看到 EINTR。
• 不可重启的系统调用：部分系统调用即使设置了 SA_RESTART 也不会自动重启，例如 select()、poll()、epoll_wait()、sleep()、pause() 等。

4.5 EINTR 与信号处理函数的交互

以下 SVG 图展示了信号处理函数、SA_RESTART 标志与系统调用返回三者之间的关系：

4.6 典型代码模式：正确处理 EINTR

以下代码展示了在 read() 调用中正确处理 EINTR 的标准模式：

#include <unistd.h>
#include <errno.h>

ssize_t safe_read(int fd, void *buf, size_t count) {
    ssize_t ret;
    
    do {
        ret = read(fd, buf, count);
    } while (ret == -1 && errno == EINTR);
    
    return ret;
}

对于需要读取指定字节数的场景，更健壮的模式如下：

ssize_t readn(int fd, void *buf, size_t count) {
    size_t nleft = count;
    ssize_t nread;
    char *ptr = (char *)buf;
    
    while (nleft > 0) {
        nread = read(fd, ptr, nleft);
        
        if (nread == -1) {
            if (errno == EINTR) {
                continue;   /* 被信号中断，重试 */
            } else {
                return -1;  /* 真正的错误 */
            }
        } else if (nread == 0) {
            break;          /* EOF */
        }
        
        nleft -= nread;
        ptr += nread;
    }
    
    return count - nleft;
}

4.7 EINTR 与多线程

在多线程程序中，EINTR 的处理需要额外注意：

• 线程信号：使用 pthread_kill() 向特定线程发送信号时，只有目标线程中的系统调用会返回 EINTR。
• 异步信号安全：信号处理函数中只能调用异步信号安全函数（async-signal-safe functions），如 write()、sig_atomic_t 操作。
• 线程池场景：如果线程池中的工作线程被信号中断，应确保 EINTR 处理逻辑不会破坏共享状态。