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 系列完成一次重定向
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 追加一行,因此输出顺序稳定。
#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 后编译并运行:
cc -std=c11 -Wall -Wextra -O2 dup_demo.c -o dup_demo
./dup_demo预期输出:
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 现有描述符。