3. procfs核心数据结构

在 procfs 驱动开发中，理解其核心数据结构是编写正确、高效代码的前提。本章深入剖析三个关键结构体：struct proc_dir_entry（目录项描述符）、struct proc_fops（传统文件操作接口）以及内核 5.6 引入的 struct proc_ops（现代文件操作接口）。掌握这些结构体的字段含义、生命周期与使用场景，是构建可靠 proc 文件系统的基石。

3.1 struct proc_dir_entry：proc 文件系统的目录项

struct proc_dir_entry 是 procfs 中每个文件或目录在内核中的抽象表示。无论是通过 proc_create() 创建的文件，还是通过 proc_mkdir() 创建的目录，都会在内核中分配一个 proc_dir_entry 实例。该结构体记录了文件/目录的名称、权限、所有者、操作函数集以及父子关系等元数据。

3.2 struct proc_fops：传统文件操作接口

在 Linux 内核 5.6 之前，proc 文件系统复用 VFS 层的 struct file_operations 来定义文件操作回调。但 proc 文件系统有其特殊性：它不需要 llseek、mmap 等复杂操作，且 read/write 的语义与普通文件不同。为此，内核社区在 5.6 版本引入了专用的 struct proc_ops，但 struct proc_fops（本质是 file_operations 的别名）在旧内核中仍广泛使用。

传统 proc_fops 中驱动最常实现的两个回调：

• read：当用户态读取 proc 文件时触发。驱动需将数据从内核空间拷贝到用户空间缓冲区。
• write：当用户态写入 proc 文件时触发。驱动从用户空间接收数据并解析。

// 传统方式：使用 file_operations（内核 < 5.6）
static ssize_t mydev_read(struct file *filp, char __user *buf,
                          size_t count, loff_t *ppos)
{
    // 实现读取逻辑
    return 0;
}

static ssize_t mydev_write(struct file *filp, const char __user *buf,
                           size_t count, loff_t *ppos)
{
    // 实现写入逻辑
    return count;
}

static const struct file_operations mydev_fops = {
    .read  = mydev_read,
    .write = mydev_write,
};

// 创建 proc 文件
static int __init mydev_init(void)
{
    struct proc_dir_entry *entry;
    entry = proc_create("mydev_info", 0444, NULL, &mydev_fops);
    if (!entry)
        return -ENOMEM;
    return 0;
}

3.3 struct proc_ops：内核 5.6+ 的现代接口

内核 5.6 引入的 struct proc_ops 是 procfs 专用的文件操作结构体。与 file_operations 相比，它精简了 proc 文件系统不需要的字段（如 llseek、mmap、flush 等），并增加了 proc_open、proc_release 等专有回调。这使得结构体更小、语义更清晰，也减少了驱动开发者的心智负担。

// 现代方式：使用 proc_ops（内核 5.6+）
static ssize_t mydev_proc_read(struct file *filp, char __user *buf,
                               size_t count, loff_t *ppos)
{
    // 实现读取逻辑
    return 0;
}

static ssize_t mydev_proc_write(struct file *filp, const char __user *buf,
                                size_t count, loff_t *ppos)
{
    // 实现写入逻辑
    return count;
}

static const struct proc_ops mydev_proc_ops = {
    .proc_read  = mydev_proc_read,
    .proc_write = mydev_proc_write,
};

// 创建 proc 文件（接口不变）
static int __init mydev_init(void)
{
    struct proc_dir_entry *entry;
    entry = proc_create("mydev_info", 0444, NULL, &mydev_proc_ops);
    if (!entry)
        return -ENOMEM;
    return 0;
}

3.4 数据结构关系与生命周期

理解这三个结构体之间的协作关系，是正确管理 proc 文件生命周期的关键。下图展示了从创建到移除的完整数据流：

1. 创建阶段：proc_create() 分配 proc_dir_entry，并将 proc_ops（或 file_operations）指针赋值给 entry->proc_fops。
2. 访问阶段：用户态打开 proc 文件时，VFS 层通过 proc_dir_entry 找到对应的 proc_ops，调用其中的 proc_open、proc_read 等回调。
3. 移除阶段：remove_proc_entry() 根据名称和父目录找到 proc_dir_entry，将其从目录树中摘除并释放内存。

3.5 实战对比：proc_fops vs proc_ops 代码迁移

为了帮助你在实际项目中快速迁移，下表总结了两种接口的关键差异：