2. Linux 内核 mmap 接口实现：struct vm_area_struct 与 file_operations 回调

在 Linux 内核中，mmap 驱动的核心在于两个关键要素：内存区域描述符 struct vm_area_struct 和 文件操作回调 file_operations 中的 .mmap 方法。用户态调用 mmap() 后，内核通过缺页中断和 VMA 操作，将物理内存映射到用户空间。本章深入剖析这两个核心结构，为后续 DMA 缓冲区共享打下基础。

2.1 struct vm_area_struct：虚拟内存区域描述符

struct vm_area_struct（简称 VMA）描述进程地址空间中一段连续的虚拟内存区域。每个 VMA 对应一个独立的映射，具有相同的权限和后备对象。内核使用红黑树 + 链表管理进程的所有 VMA。

2.1.1 核心字段解析

2.1.2 VMA 标志位（vm_flags）

标志位决定了 VMA 的访问权限和映射类型。驱动在 .mmap 回调中应检查用户传入的标志是否合法。

2.1.3 VMA 操作结构体 vm_operations_struct

驱动可以自定义 VMA 的操作行为，最常用的是 .fault 和 .open / .close。

struct vm_operations_struct {
    void (*open)(struct vm_area_struct *vma);
    void (*close)(struct vm_area_struct *vma);
    vm_fault_t (*fault)(struct vm_fault *vmf);
    vm_fault_t (*huge_fault)(struct vm_fault *vmf, unsigned int order);
    void (*map_pages)(struct vm_fault *vmf, pgoff_t start_pgoff, unsigned long nr_pages);
    unsigned long (*pagesize)(struct vm_area_struct *vma);
};

• open/close：VMA 引用计数增减时调用，用于管理共享资源的生命周期。
• fault：缺页处理核心函数，驱动在此分配物理页并插入页表。
• map_pages：批量映射优化接口，减少缺页次数。

2.2 file_operations 中的 .mmap 回调

驱动通过实现 file_operations 结构体中的 .mmap 方法，拦截用户态的 mmap() 系统调用。该回调是驱动建立用户虚拟地址与设备物理内存映射的入口。

2.2.1 回调原型与参数

int (*mmap)(struct file *filp, struct vm_area_struct *vma);

2.2.2 标准实现流程

1. 检查映射标志：验证 vma->vm_flags 是否包含 VM_SHARED（DMA 共享要求）。
2. 设置 VMA 标志：添加 VM_IO | VM_DONTEXPAND | VM_DONTDUMP。
3. 设置 vm_ops：将自定义的 vm_operations_struct 赋值给 vma->vm_ops。
4. 设置私有数据：将设备结构体或 DMA 缓冲区描述符存入 vma->vm_private_data。
5. 预映射或延迟映射：调用 remap_pfn_range() 立即建立页表，或依赖 .fault 按需映射。

static int my_mmap(struct file *filp, struct vm_area_struct *vma)
{
    struct my_device *dev = filp->private_data;
    unsigned long pfn = virt_to_phys(dev->dma_buf) >> PAGE_SHIFT;
    unsigned long size = vma->vm_end - vma->vm_start;

    // 1. 检查标志
    if (!(vma->vm_flags & VM_SHARED))
        return -EINVAL;

    // 2. 设置 VMA 标志
    vma->vm_flags |= VM_IO | VM_DONTEXPAND | VM_DONTDUMP;

    // 3. 设置 vm_ops
    vma->vm_ops = &my_vm_ops;

    // 4. 设置私有数据
    vma->vm_private_data = dev;

    // 5. 立即建立映射（适用于固定物理地址的 DMA 缓冲区）
    if (remap_pfn_range(vma, vma->vm_start, pfn, size, vma->vm_page_prot))
        return -EAGAIN;

    return 0;
}

2.3 VMA 与 .mmap 回调的协作流程

下图展示了用户态 mmap() 调用到驱动回调完成映射的完整路径：

2.4 关键差异对比：remap_pfn_range vs. fault 缺页

2.5 驱动开发避坑指南

• 检查 VM_SHARED：DMA 缓冲区共享必须要求共享映射，私有映射会导致 COW 破坏物理地址一致性。
• 设置 VM_IO：防止内核对该区域进行非 I/O 相关的优化（如 swap、core dump）。
• 避免 vm_ops 为空：如果未设置 vm_ops，内核使用默认缺页处理，可能导致错误映射。
• 注意页对齐：vm_start 和 vm_end 自动页对齐，驱动无需额外处理，但物理地址必须页对齐。
• 引用计数管理：在 vm_ops->open 中增加设备引用计数，close 中减少，防止设备在映射期间被释放。