2. ioctl 系统调用基础：用户态与内核态交互、ioctl 函数原型、cmd 编码规则

ioctl（Input/Output Control）是 Linux 驱动中实现设备控制的核心系统调用。它允许用户态程序向设备驱动发送控制命令、传递配置参数或查询设备状态，是用户态与内核态之间最灵活的交互接口之一。理解 ioctl 的基础机制、函数原型以及命令编码规则，是实现 subdev 驱动中自定义控制逻辑的前提。

2.1 用户态与内核态的交互路径

Linux 系统将虚拟地址空间划分为用户态和内核态，以保障系统安全。用户态程序不能直接访问内核资源，必须通过系统调用陷入内核。ioctl 的完整交互路径如下：

1. 用户态发起：应用程序调用 ioctl(fd, cmd, arg)，陷入内核。
2. VFS 层分发：内核根据文件描述符 fd 找到对应的 struct file，调用其 file_operations 中的 unlocked_ioctl（或 compat_ioctl）。
3. 驱动层处理：驱动根据 cmd 编码解析命令类型和方向，通过 copy_from_user / copy_to_user 完成数据交换。
4. 结果返回：驱动处理完成后，将结果返回用户态。

2.2 ioctl 函数原型详解

ioctl 在用户态和内核态具有不同的函数原型，理解两者的对应关系是正确实现驱动接口的基础。

2.2.1 用户态原型

#include <sys/ioctl.h>

int ioctl(int fd, unsigned long request, ...);

2.2.2 内核态原型

在 Linux 2.6.36 之后，内核使用 unlocked_ioctl 替代了旧的 ioctl 接口，不再持有 BKL（大内核锁），驱动开发者需要自行保证并发安全。

#include <linux/fs.h>

long (*unlocked_ioctl)(struct file *filp, unsigned int cmd, unsigned long arg);

2.3 cmd 编码规则

Linux 内核为 ioctl 命令码定义了一套标准的编码规则，确保命令码在整个系统中具有唯一性，并携带命令方向、数据大小等元信息。编码定义在 <linux/ioctl.h> 中。

2.3.1 编码结构

一个 32 位的 ioctl 命令码被划分为 4 个字段：

2.3.2 构造与解码宏

内核提供了标准宏来构造和解码 ioctl 命令码，驱动开发者应始终使用这些宏，而非手动拼接位域。

#include <linux/ioctl.h>

// 构造命令码
#define MY_IOCTL_SET _IOW('M', 1, struct my_data)
#define MY_IOCTL_GET _IOR('M', 2, struct my_data)
#define MY_IOCTL_DO  _IO('M', 3)

// 解码命令码（在驱动处理函数中使用）
unsigned int dir  = _IOC_DIR(cmd);   // 获取方向
unsigned int size = _IOC_SIZE(cmd);  // 获取数据大小
unsigned int type = _IOC_TYPE(cmd);  // 获取魔数
unsigned int nr   = _IOC_NR(cmd);    // 获取序号

2.3.3 方向类型说明

2.4 典型实现模式

在 subdev 驱动中，ioctl 的实现通常遵循以下模式：

static long my_subdev_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
    struct my_device *dev = filp->private_data;
    struct my_data kdata;
    int ret = 0;

    // 1. 检查魔数，防止命令码冲突
    if (_IOC_TYPE(cmd) != MY_IOCTL_MAGIC)
        return -ENOTTY;

    // 2. 检查数据大小是否匹配
    if (_IOC_SIZE(cmd) != sizeof(struct my_data))
        return -ENOTTY;

    // 3. 根据方向执行数据拷贝
    switch (cmd) {
    case MY_IOCTL_SET:
        if (copy_from_user(&kdata, (void __user *)arg, sizeof(kdata)))
            return -EFAULT;
        // 处理设置逻辑
        break;

    case MY_IOCTL_GET:
        // 处理获取逻辑
        if (copy_to_user((void __user *)arg, &kdata, sizeof(kdata)))
            return -EFAULT;
        break;

    case MY_IOCTL_DO:
        // 无数据操作
        break;

    default:
        return -ENOTTY;
    }

    return ret;
}

2.5 常见错误与调试

• 命令码冲突：魔数选择不当导致与其他驱动冲突，使用 _IOC_TYPE(cmd) 检查可快速定位。
• 数据拷贝错误：未使用 copy_from_user 直接解引用用户指针，导致内核崩溃。
• 大小不匹配：用户态与内核态数据结构定义不一致（如字节对齐、字段顺序），使用 _IOC_SIZE 校验可提前发现。
• 并发问题：多个用户态进程同时调用 ioctl 时，驱动需使用互斥锁保护共享资源。