C / C++ / 系统课时

复制与重定向文件描述符

复制与重定向文件描述符

本节用一段 Linux C 程序完成标准输出重定向,并把 dup、dup2、dup3、fork 与 close-on-exec 串成一条完整链路。关键不是“复制一个整数”,而是理解多个描述符如何指向同一个 open file description,以及哪些状态会共享、哪些只属于单个描述符。

学习目标

  • 使用 dup、dup2、dup3 安全地复制文件描述符并实现标准输出重定向
  • 解释 fork 后共享文件偏移与文件状态标志的原因
  • 使用 FD_CLOEXEC 或 O_CLOEXEC 控制描述符是否跨 exec 泄漏

看清描述符背后的共享对象

进程中的文件描述符只是描述符表的索引。表项指向内核的 open file description,其中保存当前文件偏移和 O_APPEND、O_NONBLOCK 等文件状态标志。dup 系列创建的是新的描述符表项,它们仍指向同一个 open file description,因此通常共享偏移与文件状态标志。

close-on-exec 不同:FD_CLOEXEC 是文件描述符自身的标志。它决定执行 exec 时这个描述符是否自动关闭,不属于共享的 open file description。理解这一层差异,才能解释为什么两个重复描述符会“抢同一个偏移”,但可以拥有不同的 close-on-exec 设置。

dup、fork 与 exec 下的文件描述符关系

用 dup 系列完成一次重定向

dup(oldfd) 返回当前最低可用的新描述符;新描述符与 oldfd 指向同一 open file description,但新描述符的 FD_CLOEXEC 默认关闭。dup2(oldfd, newfd) 把结果精确放到 newfd,若 newfd 已打开会原子地替换它;当两者相等时直接成功返回。Linux 的 dup3 不能接受相同的两个描述符,但可以在复制时通过 O_CLOEXEC 原子设置 close-on-exec。

下面的程序先用 dup 保存原标准输出,再用 dup2 把标准输出重定向到文件,同时用 dup3 创建带 O_CLOEXEC 的描述符 100。随后 fork 子进程并执行一次 exec:重定向后的标准输出继续存在,而描述符 100 会自动关闭。父进程等待子进程结束后再通过描述符 100 追加一行,因此输出顺序稳定。

c
#define _GNU_SOURCE
#include <errno.h>
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/wait.h>
#include <unistd.h>

static void die(const char *what) {
    perror(what);
    exit(EXIT_FAILURE);
}

static void write_all(int fd, const char *text) {
    size_t len = strlen(text);
    while (len > 0) {
        ssize_t n = write(fd, text, len);
        if (n < 0) {
            if (errno == EINTR) {
                continue;
            }
            die("write");
        }
        text += n;
        len -= (size_t)n;
    }
}

int main(int argc, char **argv) {
    if (argc == 2 && strcmp(argv[1], "check-exec") == 0) {
        errno = 0;
        int rc = fcntl(100, F_GETFD);
        if (rc == -1 && errno == EBADF) {
            write_all(STDOUT_FILENO, "fd 100 closed across exec\n");
            return 0;
        }
        write_all(STDOUT_FILENO, "fd 100 unexpectedly survived exec\n");
        return 2;
    }

    int filefd = open("redirect.log",
                      O_CREAT | O_TRUNC | O_WRONLY | O_CLOEXEC,
                      0644);
    if (filefd == -1) {
        die("open");
    }

    // dup 保存原 stdout;随后把副本也设成 close-on-exec,避免子进程 exec 时泄漏。
    int saved_stdout = dup(STDOUT_FILENO);
    if (saved_stdout == -1 ||
        fcntl(saved_stdout, F_SETFD, FD_CLOEXEC) == -1) {
        die("save stdout");
    }

    if (dup2(filefd, STDOUT_FILENO) == -1) {
        die("dup2");
    }

    // fd 100 与 stdout 指向同一 open file description,但它自身带 FD_CLOEXEC。
    int extra = dup3(filefd, 100, O_CLOEXEC);
    if (extra == -1) {
        die("dup3");
    }
    int fd_flags = fcntl(extra, F_GETFD);
    if (fd_flags == -1) {
        die("F_GETFD");
    }

    write_all(STDOUT_FILENO, "before fork\n");

    pid_t pid = fork();
    if (pid == -1) {
        die("fork");
    }
    if (pid == 0) {
        execl("/proc/self/exe", "dup-demo", "check-exec", (char *)NULL);
        _exit(127);
    }

    int status;
    if (waitpid(pid, &status, 0) == -1 ||
        !WIFEXITED(status) || WEXITSTATUS(status) != 0) {
        fprintf(stderr, "child failed\n");
        exit(EXIT_FAILURE);
    }

    // 父子共享 open file description 的偏移;等待子进程后再写,结果顺序确定。
    write_all(extra, "parent via fd100\n");

    if (dup2(saved_stdout, STDOUT_FILENO) == -1) {
        die("restore stdout");
    }
    close(saved_stdout);
    close(extra);
    close(filefd);

    printf("dup3 fd 100 close-on-exec: %s\n",
           (fd_flags & FD_CLOEXEC) ? "on" : "off");

    int in = open("redirect.log", O_RDONLY);
    if (in == -1) {
        die("reopen");
    }
    char buf[256];
    ssize_t n = read(in, buf, sizeof buf);
    if (n < 0) {
        die("read");
    }
    close(in);

    puts("redirect.log:");
    fflush(stdout);
    if (write(STDOUT_FILENO, buf, (size_t)n) != n) {
        die("show log");
    }
    return 0;
}

保存为 dup_demo.c 后编译并运行:

bash
cc -std=c11 -Wall -Wextra -O2 dup_demo.c -o dup_demo
./dup_demo

预期输出:

text
dup3 fd 100 close-on-exec: on
redirect.log:
before fork
fd 100 closed across exec
parent via fd100

子进程在 exec 前继承了父进程的描述符表副本,其中的表项仍引用相同的 open file description,所以文件偏移共享。执行新程序映像时,描述符 100 因 FD_CLOEXEC 被关闭;标准输出描述符 1 是 dup2 的目标,没有 close-on-exec 标志,因此仍然指向 redirect.log。

避免重定向与继承陷阱

实现 shell 风格的重定向时,优先使用 dup2 或 dup3,不要手工写成“先 close(newfd) 再 dup(oldfd)”。后一种写法在并发信号处理或多线程环境中存在竞态:关闭后到复制前,其他代码可能抢先占用这个描述符编号,而 dup2/dup3 的替换由内核原子完成。

创建本来就不应跨 exec 存活的描述符时,也应尽量在创建阶段原子设置 close-on-exec,例如 open(..., O_CLOEXEC)、pipe2(..., O_CLOEXEC) 或 dup3(..., O_CLOEXEC)。先创建再调用 fcntl(F_SETFD) 会留下短暂窗口,多线程程序中的另一个线程可能恰好在窗口内执行 fork 与 exec。

还要区分“共享偏移”和“共享描述符表”。fork 后父子进程的描述符表彼此独立,关闭父进程中的某个描述符不会直接删除子进程中的对应表项;但只要双方的表项仍指向同一个 open file description,它们的读写就会推进同一个文件偏移。需要真正独立的偏移时,应重新 open 文件,而不是继续 dup 现有描述符。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

复制与重定向文件描述符

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通