Linux proc_pid_fdinfo 怎样查看 epoll 监听项

排查 Linux 事件循环时，可以直接读取目标进程的 /proc//fdinfo/。其中每一行 tfd 是被该 epoll 实例监听的目标文件描述符，events 是十六进制事件掩码，data 是注册监听时关联的用户数据。先找到 epoll 自身的 fd，再读对应的 fdinfo，最后用 /proc//fd/ 做对象映射。

官方地址：https://man7.org/linux/man-pages/man5/proc_pid_fdinfo.5.html

先理解 fdinfo：文件名就是 fd 编号

/proc//fdinfo/ 是一个按文件描述符编号组织的目录。普通文件或目录的条目通常包含 pos、flags、mnt_id 和 ino；不同类型的 fd 会追加自己的字段。epoll fd 的条目则会列出它正在监视的目标。

这个目录不是全局事件数据库。手册明确说明，条目通常只有进程所有者可读，因此使用其他用户的 PID 时，不能把权限错误误判为“没有监听项”。以下命令是排查路径示意：

pid=1234

# 先列出目标进程持有的 fd，按链接目标寻找 epoll 实例。
for fd in /proc/$pid/fd/*; do
    target=$(readlink "$fd")
    case "$target" in
        anon_inode:\[eventpoll\]) printf 'epoll fd: %s\n' "${fd##*/}" ;;
    esac
done

# 把上一步找到的数字替换为实际 epoll fd，再读取其登记信息。
epoll_fd=7
cat "/proc/$pid/fdinfo/$epoll_fd"

图 1 用静态结构图表示“进程 fd 表—epoll fd—fdinfo 条目”的对应关系。它是理解字段归属的说明图，不是某台机器的运行截图。

读取 epoll 条目：tfd、events、data 各自表示什么

当某个 fd 是 epoll 实例时，fdinfo 中会出现多行 tfd。例如下面的文本只用于说明字段格式：

tfd:        9 events:       19 data: 74253d2500000009
tfd:        7 events:       19 data: 74253d2500000007

tfd 是被监视的目标 fd 编号，仍属于同一个目标进程的 fd 表；它不是独立的 PID，也不是 inode。events 用十六进制掩码表达监听的事件组合，需要结合 epoll_ctl 注册时传入的 struct epoll_event.events 解码。data 是注册时保存的用户数据，可能是整数、指针或其他由程序约定的标识，不能仅凭数值猜测业务含义。

因此，看到一行记录只能确认“这个 epoll 实例登记了一个 tfd 及其兴趣事件”，不能直接推出该事件此刻已经就绪。就绪结果仍来自 epoll_wait 返回值和程序日志。

把 tfd 映射回文件、管道或套接字

拿到 tfd 后，可以查看同一 PID 下的 fd 符号链接，把数字映射为更容易理解的对象。映射动作与读取 fdinfo 使用同一个 pid，否则会把不同进程的 fd 表混在一起：

pid=1234
tfd=9

# tfd 是目标进程自己的描述符编号，不能替换成当前 shell 的 fd。
if [ -e "/proc/$pid/fd/$tfd" ]; then
    # readlink 只展示内核暴露的对象标识，socket/pipe 可能没有普通路径。
    readlink "/proc/$pid/fd/$tfd"
else
    # 目标 fd 可能已被关闭，或在两次读取之间被复用。
    printf 'tfd %s is no longer present\n' "$tfd" >&2
fi

普通文件通常能看到路径，管道和套接字则可能显示 pipe:[inode] 或 socket:[inode]。这一步只负责对象关联，不等于已经验证事件循环业务正确；如果进程正在关闭和重建连接，映射结果应与同一时刻的日志或进程状态一起判断。

图 2 把 tfd、目标对象、events 掩码和 data 关联到同一条静态关系上，便于区分“监听对象”和“就绪结果”。

常见误区与排查顺序

推荐顺序是：确认 PID 和权限，定位 epoll fd，保存同一时刻的 fdinfo 内容，再逐行读取 tfd 的链接目标，最后回到程序的 epoll_ctl 注册参数和 epoll_wait 处理逻辑。这样能避免把 proc 文件系统中的静态登记信息误当成实时运行结果。

常见问题

为什么 fdinfo 里没有普通文件路径？

epoll fdinfo 重点描述监听关系；真正的目标对象要通过同一 PID 下的 /proc//fd/ 查看。管道和套接字本身也可能只暴露 inode 标识。

events: 19 应该怎样理解？

它是十六进制掩码，具体含义取决于程序注册的 epoll 事件常量。应结合注册代码解码，不要把这一行当成某次 epoll_wait 的返回结果。

读取期间进程退出会怎样？

PID 对应的 proc 目录可能消失，或者目标 fd 已被关闭和复用。把 fdinfo、fd 链接和应用日志放在接近的时间点采集，才能减少跨时刻关联造成的误判。