2. Linux 内核驱动基础回顾：模块加载与卸载、file_operations 结构体、字符设备驱动框架

在深入安全驱动开发之前，必须牢固掌握 Linux 内核驱动的基础骨架。本章聚焦于三个核心支柱：模块生命周期管理、文件操作接口以及字符设备驱动框架。这些是构建任何内核态安全通道（包括 OP-TEE 驱动）的基石。

2.1 内核模块的加载与卸载

Linux 内核模块允许在运行时动态扩展内核功能，无需重新编译整个内核。每个模块都包含两个强制入口点：module_init() 和 module_exit()。

2.1.1 模块加载流程

1. insmod / modprobe：用户态工具将 .ko 文件加载到内核空间。
2. 内核模块加载器：执行重定位、解析符号依赖、调用 module_init() 注册的函数。
3. 初始化函数：分配资源、注册设备、创建 /dev 节点。
4. 模块状态：从 MODULE_STATE_COMING 转换为 MODULE_STATE_LIVE。

2.1.2 模块卸载流程

1. rmmod：用户态请求卸载模块。
2. 内核检查：确认模块引用计数为 0，无进程正在使用。
3. 清理函数：调用 module_exit() 注册的函数，释放所有资源。
4. 模块状态：转换为 MODULE_STATE_GOING，最终从内核中移除。

2.1.3 模块参数与许可证

// 最小安全模块示例
#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/fs.h>

static int __init safe_driver_init(void)
{
    pr_info("Safe Driver: Module loaded successfully\n");
    // 安全实践：检查返回值，确保资源分配成功
    return 0;
}

static void __exit safe_driver_exit(void)
{
    pr_info("Safe Driver: Module unloaded\n");
    // 安全实践：确保所有资源已被释放，无内存泄漏
}

module_init(safe_driver_init);
module_exit(safe_driver_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Security Expert");
MODULE_DESCRIPTION("A minimal safe driver template");

2.2 file_operations 结构体

file_operations 是字符设备驱动的核心接口，它将用户空间的系统调用（如 open、read、write、ioctl）映射到内核驱动的具体实现函数。每个字段都是一个函数指针，指向驱动开发者提供的回调。

2.2.1 关键成员与安全职责

// file_operations 结构体定义示例
static struct file_operations safe_fops = {
    .owner   = THIS_MODULE,
    .open    = safe_driver_open,
    .release = safe_driver_release,
    .read    = safe_driver_read,
    .write   = safe_driver_write,
    .unlocked_ioctl = safe_driver_ioctl,
};

2.2.2 用户空间与内核空间的数据拷贝

安全驱动开发中最常见的漏洞来源之一就是用户空间与内核空间之间的数据交换。必须使用内核提供的专用 API，而不是直接解引用用户空间指针。

• copy_from_user()：从用户空间拷贝数据到内核空间。必须检查返回值（未拷贝的字节数），如果非零则说明拷贝失败。
• copy_to_user()：从内核空间拷贝数据到用户空间。同样需要检查返回值。
• access_ok()：在拷贝前验证用户空间地址范围是否合法（现代内核中 copy_from_user 内部已包含此检查，但显式调用可增加防御深度）。

2.3 字符设备驱动框架

字符设备是 Linux 中最基本的设备类型，以字节流方式访问。注册一个字符设备需要三个核心步骤：分配设备号、初始化 cdev 结构体、将设备添加到系统。

2.3.1 完整注册流程

1. 分配设备号：使用 alloc_chrdev_region()（动态分配）或 register_chrdev_region()（静态指定）。
2. 初始化 cdev：调用 cdev_init() 并将 file_operations 结构体关联到 cdev。
3. 添加设备：调用 cdev_add() 将设备注册到内核 VFS 层。
4. 创建设备节点：在 /dev 下创建设备文件（通常通过 device_create() 配合类实现）。

// 字符设备驱动框架核心代码
#include <linux/fs.h>
#include <linux/cdev.h>
#include <linux/device.h>

#define DEVICE_NAME "safe_char_dev"
#define CLASS_NAME  "safe_class"

static int major_num;
static struct class *safe_class = NULL;
static struct device *safe_device = NULL;
static struct cdev safe_cdev;

static int __init safe_char_init(void)
{
    dev_t dev_num;

    // 1. 动态分配设备号
    if (alloc_chrdev_region(&dev_num, 0, 1, DEVICE_NAME) < 0) {
        pr_err("Failed to allocate device number\n");
        return -1;
    }
    major_num = MAJOR(dev_num);
    pr_info("Allocated major number: %d\n", major_num);

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

    // 3. 添加 cdev 到内核
    if (cdev_add(&safe_cdev, dev_num, 1) < 0) {
        pr_err("Failed to add cdev\n");
        unregister_chrdev_region(dev_num, 1);
        return -1;
    }

    // 4. 创建类并在 /dev 下创建设备节点
    safe_class = class_create(THIS_MODULE, CLASS_NAME);
    if (IS_ERR(safe_class)) {
        pr_err("Failed to create class\n");
        cdev_del(&safe_cdev);
        unregister_chrdev_region(dev_num, 1);
        return PTR_ERR(safe_class);
    }

    safe_device = device_create(safe_class, NULL, dev_num, NULL, DEVICE_NAME);
    if (IS_ERR(safe_device)) {
        pr_err("Failed to create device\n");
        class_destroy(safe_class);
        cdev_del(&safe_cdev);
        unregister_chrdev_region(dev_num, 1);
        return PTR_ERR(safe_device);
    }

    pr_info("Safe char device registered successfully\n");
    return 0;
}

static void __exit safe_char_exit(void)
{
    dev_t dev_num = MKDEV(major_num, 0);

    // 逆序释放资源
    device_destroy(safe_class, dev_num);
    class_destroy(safe_class);
    cdev_del(&safe_cdev);
    unregister_chrdev_region(dev_num, 1);

    pr_info("Safe char device unregistered\n");
}

module_init(safe_char_init);
module_exit(safe_char_exit);

2.3.2 字符设备驱动架构图

下图展示了用户空间应用程序通过 VFS 层与内核字符设备驱动交互的完整路径，以及安全边界所在的位置。

2.4 关键安全实践总结