1. ioctl 基础概念

ioctl（Input/Output Control）是 Linux 驱动中用于设备控制的系统调用，它允许用户态程序向内核态设备驱动发送控制命令并交换数据。与 read/write 的流式接口不同，ioctl 提供的是“命令-响应”式的双向控制通道，是驱动开发中最灵活也最容易出错的接口之一。

1.1 ioctl 系统调用原理

用户态调用 ioctl(fd, cmd, arg) 后，系统通过 VFS 层进入内核，最终调用驱动注册的 unlocked_ioctl 或 compat_ioctl 回调函数。整个调用链如下：

1.2 用户态与内核态交互模型

ioctl 的数据交互遵循“用户态发起 → 内核态处理 → 结果返回”的闭环模型。根据 arg 参数的使用方式，可分为三种典型模式：

结构体指针模式是最常用也最复杂的交互方式，驱动必须使用 copy_from_user 和 copy_to_user 进行安全的数据拷贝：

// 用户态定义
struct my_ioctl_data {
    __u32 cmd_id;
    __u32 value;
    __u8  buffer[64];
};

// 内核态处理
static long mydev_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
    struct my_ioctl_data data;
    int ret;

    // 从用户空间安全拷贝数据到内核
    if (copy_from_user(&data, (void __user *)arg, sizeof(data)))
        return -EFAULT;

    // 处理数据...

    // 将结果拷贝回用户空间
    if (copy_to_user((void __user *)arg, &data, sizeof(data)))
        return -EFAULT;

    return 0;
}

1.3 cmd 命令码组成结构

ioctl 命令码（cmd）是一个 32 位整数，Linux 内核通过 _IO、_IOR、_IOW、_IOWR 宏来构造和解析命令码。其位域结构如下：

命令码的构造宏定义在 <linux/ioctl.h> 中，驱动开发中应始终使用这些宏来生成命令码：

// 定义驱动魔数（type），每个驱动使用唯一值
#define MYDEV_MAGIC  'M'

// 定义命令码
#define MYDEV_CMD_RESET    _IO(MYDEV_MAGIC, 0)       // 无数据，复位设备
#define MYDEV_CMD_GET_STAT _IOR(MYDEV_MAGIC, 1, int) // 读，获取状态
#define MYDEV_CMD_SET_CFG  _IOW(MYDEV_MAGIC, 2, struct my_cfg) // 写，设置配置
#define MYDEV_CMD_RW_DATA  _IOWR(MYDEV_MAGIC, 3, struct my_data) // 读写，交换数据

// 内核中解析命令码
static long mydev_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
    // 校验驱动魔数
    if (_IOC_TYPE(cmd) != MYDEV_MAGIC)
        return -ENOTTY;

    // 校验序号范围
    if (_IOC_NR(cmd) >= MYDEV_CMD_MAX)
        return -ENOTTY;

    // 校验数据方向（可选）
    if (_IOC_DIR(cmd) & _IOC_READ)
        // 需要从内核读数据到用户

    switch (cmd) {
    case MYDEV_CMD_RESET:
        // 复位逻辑
        break;
    case MYDEV_CMD_GET_STAT:
        // 获取状态
        break;
    // ...
    }
    return 0;
}

1.4 命令码校验流程

一个健壮的 ioctl 实现应在进入 switch 分支前完成三层校验：

1. 魔数校验：使用 _IOC_TYPE(cmd) 检查是否属于本驱动，防止误调用。
2. 序号校验：使用 _IOC_NR(cmd) 检查是否在有效范围内，防止越界访问。
3. 大小校验：使用 _IOC_SIZE(cmd) 检查数据大小是否匹配，防止缓冲区溢出。