4. 字符设备驱动基础回顾

在深入网卡 NIC 驱动开发之前，必须牢固掌握 Linux 字符设备驱动的基础框架。网卡驱动虽然属于网络子系统，但其控制面（如 ethtool、ioctl）以及某些虚拟网卡（如 tun/tap）的数据面，仍然依赖字符设备模型。本章将系统回顾 file_operations 结构体、cdev 注册流程以及用户态与内核态数据拷贝这三个核心知识点。

4.1 file_operations 结构体：驱动与 VFS 的契约

file_operations 是字符设备驱动与虚拟文件系统（VFS）之间的核心接口。每个打开的设备文件在 VFS 层都对应一个 struct file，而 struct file 中的 f_op 指针指向驱动提供的 file_operations 实例。当用户态程序调用 open()、read()、write()、ioctl() 等系统调用时，VFS 会通过该结构体找到对应的驱动函数。

以下是最常用的 file_operations 成员：

典型的 file_operations 定义示例：

// 定义一个简单的字符设备驱动操作集
static struct file_operations my_fops = {
    .owner   = THIS_MODULE,
    .open    = my_open,
    .release = my_release,
    .read    = my_read,
    .write   = my_write,
    .unlocked_ioctl = my_ioctl,
};

4.2 cdev 注册流程：从内核对象到设备节点

cdev（字符设备）是内核中表示字符设备的核心结构体。注册一个字符设备需要完成以下步骤：

1. 分配设备号：使用 alloc_chrdev_region() 动态分配，或 register_chrdev_region() 注册静态设备号。
2. 初始化 cdev：调用 cdev_init() 将 cdev 与 file_operations 关联。
3. 添加 cdev 到内核：调用 cdev_add() 将设备注册到 VFS 层。
4. 自动创建设备节点（可选）：使用 class_create() 和 device_create() 在 /dev/ 下自动生成设备文件。

以下 SVG 展示了 cdev 注册的完整流程及其与 VFS 的关系：

以下代码展示了完整的 cdev 注册过程：

#include <linux/module.h>
#include <linux/fs.h>
#include <linux/cdev.h>
#include <linux/device.h>

static dev_t my_dev_num;
static struct cdev my_cdev;
static struct class *my_class;

static int __init my_driver_init(void)
{
    int ret;

    // 1. 动态分配设备号
    ret = alloc_chrdev_region(&my_dev_num, 0, 1, "my_device");
    if (ret < 0) {
        pr_err("Failed to allocate device number\n");
        return ret;
    }

    // 2. 初始化 cdev 并关联 file_operations
    cdev_init(&my_cdev, &my_fops);
    my_cdev.owner = THIS_MODULE;

    // 3. 将 cdev 添加到内核
    ret = cdev_add(&my_cdev, my_dev_num, 1);
    if (ret < 0) {
        pr_err("Failed to add cdev\n");
        unregister_chrdev_region(my_dev_num, 1);
        return ret;
    }

    // 4. 创建 device class 和 device 节点（自动生成 /dev/my_device）
    my_class = class_create(THIS_MODULE, "my_class");
    if (IS_ERR(my_class)) {
        pr_err("Failed to create class\n");
        cdev_del(&my_cdev);
        unregister_chrdev_region(my_dev_num, 1);
        return PTR_ERR(my_class);
    }

    device_create(my_class, NULL, my_dev_num, NULL, "my_device");

    pr_info("My device driver loaded, major=%d, minor=%d\n",
            MAJOR(my_dev_num), MINOR(my_dev_num));
    return 0;
}

static void __exit my_driver_exit(void)
{
    device_destroy(my_class, my_dev_num);
    class_destroy(my_class);
    cdev_del(&my_cdev);
    unregister_chrdev_region(my_dev_num, 1);
    pr_info("My device driver unloaded\n");
}

module_init(my_driver_init);
module_exit(my_driver_exit);
MODULE_LICENSE("GPL");

4.3 用户态与内核态数据交互：copy_from/to_user

Linux 内核运行在特权级（Ring 0），用户程序运行在非特权级（Ring 3）。内核不能直接访问用户空间指针，用户空间也不能直接访问内核内存。因此，驱动中必须使用内核提供的专用 API 来安全地拷贝数据。

两个核心函数：

以下 SVG 展示了用户态与内核态数据交互的完整路径：

以下代码展示了 read 和 write 方法中如何使用这些函数：

// 驱动中的 read 实现：从内核缓冲区拷贝数据到用户空间
static ssize_t my_read(struct file *filp, char __user *buf,
                       size_t count, loff_t *f_pos)
{
    size_t available = MY_BUF_SIZE - *f_pos;
    size_t to_copy = min(count, available);
    int ret;

    if (to_copy == 0)
        return 0;  // EOF

    // 将内核数据拷贝到用户空间
    ret = copy_to_user(buf, my_kernel_buf + *f_pos, to_copy);
    if (ret) {
        pr_err("Failed to copy data to user, %d bytes remaining\n", ret);
        return -EFAULT;
    }

    *f_pos += to_copy;
    return to_copy;
}

// 驱动中的 write 实现：从用户空间拷贝数据到内核缓冲区
static ssize_t my_write(struct file *filp, const char __user *buf,
                        size_t count, loff_t *f_pos)
{
    size_t available = MY_BUF_SIZE - *f_pos;
    size_t to_copy = min(count, available);
    int ret;

    if (to_copy == 0)
        return -ENOSPC;  // 缓冲区满

    // 将用户空间数据拷贝到内核
    ret = copy_from_user(my_kernel_buf + *f_pos, buf, to_copy);
    if (ret) {
        pr_err("Failed to copy data from user, %d bytes remaining\n", ret);
        return -EFAULT;
    }

    *f_pos += to_copy;
    return to_copy;
}

4.4 本章小结

• file_operations 是驱动与 VFS 的契约，定义了设备文件的所有操作入口。
• cdev 注册 需要依次完成设备号分配、cdev 初始化、cdev 添加和设备节点创建。
• copy_from_user / copy_to_user 是用户态与内核态数据交互的唯一安全途径，驱动中必须使用，禁止直接解引用用户指针。
• 这些基础机制是网卡驱动控制面（ioctl、ethtool）和虚拟网卡数据面的基石，后续章节将在此基础上构建完整的 NIC 驱动。