4. ioctl 接口原理：系统调用流程、命令码规范与数据拷贝

ioctl（Input/Output Control）是 Linux 驱动中用于实现设备特定控制命令的核心接口。与 read/write 不同，ioctl 允许用户态传递自定义命令码和任意类型的数据，是实现设备配置、状态查询、非标准 I/O 操作的首选机制。本章深入剖析 ioctl 的系统调用流程、命令码编码规范以及用户态与内核态的数据拷贝技术。

4.1 ioctl 系统调用流程

ioctl 从用户态发起，经过 VFS 层、内核通用处理，最终到达驱动注册的 unlocked_ioctl 函数。完整流程包含以下关键阶段：

1. 用户态发起： 应用程序调用 ioctl(fd, cmd, arg)，其中 fd 为设备文件描述符，cmd 为命令码，arg 为可变参数（通常为指针）。
2. 系统调用入口： 进入内核后，SYSCALL_DEFINE3(ioctl, ...) 进行权限检查、文件描述符解析。
3. VFS 层分发： 根据文件 inode 指向的 file_operations 结构，调用 unlocked_ioctl 或 compat_ioctl（32位兼容）。
4. 驱动处理： 驱动根据 cmd 执行对应的操作，通过 copy_from_user/copy_to_user 与用户态交换数据。
5. 结果返回： 驱动返回 0（成功）或负错误码，系统调用将结果传递回用户态。

4.2 命令码编码规范

Linux 内核为 ioctl 命令码定义了严格的编码规范，确保命令码在全局范围内唯一且可自解释。命令码是一个 32 位整数，由 4 个字段组成：

内核提供 4 个标准宏来构造命令码，驱动开发者应优先使用这些宏而非手动拼凑：

4.3 用户态与内核态数据拷贝

由于用户态和内核态运行在不同的地址空间，驱动不能直接解引用用户态指针。必须使用内核提供的专用拷贝函数，这些函数会进行地址合法性检查、权限验证和缺页处理。

4.3.1 核心拷贝函数

4.3.2 驱动中的典型用法

以下代码展示了在 unlocked_ioctl 中如何安全地使用拷贝函数：

// 驱动头文件定义
#define MY_DEVICE_TYPE 'M'
#define CMD_GET_STAT  _IOR(MY_DEVICE_TYPE, 1, struct dev_stat)
#define CMD_SET_CFG   _IOW(MY_DEVICE_TYPE, 2, struct dev_cfg)

// 驱动 ioctl 实现
long my_dev_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
    struct my_dev *dev = filp->private_data;
    int ret = 0;

    // 检查命令码的 type 字段是否匹配
    if (_IOC_TYPE(cmd) != MY_DEVICE_TYPE) {
        pr_err("ioctl: invalid type\n");
        return -ENOTTY;
    }

    // 检查命令码的 nr 是否在有效范围内
    if (_IOC_NR(cmd) > MY_DEVICE_MAX_NR) {
        pr_err("ioctl: invalid nr\n");
        return -ENOTTY;
    }

    switch (cmd) {
    case CMD_GET_STAT: {
        struct dev_stat stat;
        // 读取设备状态到内核缓冲区
        stat.value = dev->current_value;
        stat.flags = dev->flags;
        // 拷贝到用户态
        if (copy_to_user((void __user *)arg, &stat, sizeof(stat))) {
            ret = -EFAULT;
            break;
        }
        ret = 0;
        break;
    }
    case CMD_SET_CFG: {
        struct dev_cfg cfg;
        // 从用户态拷贝配置数据
        if (copy_from_user(&cfg, (void __user *)arg, sizeof(cfg))) {
            ret = -EFAULT;
            break;
        }
        // 验证配置合法性
        if (cfg.mode > MAX_MODE) {
            ret = -EINVAL;
            break;
        }
        // 应用配置
        dev->mode = cfg.mode;
        dev->threshold = cfg.threshold;
        ret = 0;
        break;
    }
    default:
        ret = -ENOTTY;  // 未知命令
        break;
    }
    return ret;
}

4.3.3 安全注意事项

• 指针验证： 永远不要直接解引用用户态指针。使用 copy_from_user/copy_to_user 或 get_user/put_user（用于简单类型）。
• 大小检查： 使用 _IOC_SIZE(cmd) 宏获取命令码中编码的大小，与 sizeof 比较，防止缓冲区溢出。
• 方向检查： 使用 _IOC_DIR(cmd) 宏获取方向，结合 _IOC_READ/_IOC_WRITE 位掩码验证操作权限。
• 并发保护： 在 unlocked_ioctl 中访问共享资源（如设备状态）时，必须使用互斥锁或自旋锁保护。
• 部分拷贝： 如果 copy_from_user 返回非零，表示部分拷贝失败，此时内核缓冲区内容可能不完整，应返回 -EFAULT 并避免使用部分数据。

4.4 本章小结