2. ioctl 系统调用基础：用户态与内核态交互、命令码格式与宏

ioctl（Input/Output Control）是 Linux 驱动中用于设备控制的核心系统调用，它提供了用户态应用程序与内核态驱动程序之间传递控制命令与数据的通用通道。在 V4L2 驱动中，绝大多数控制逻辑（如设置分辨率、切换输入源、请求缓冲区）都通过 ioctl 接口实现。理解 ioctl 的底层机制、命令码编码规则以及标准宏，是设计安全校验的前提。

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

ioctl 系统调用的本质是一个多路复用器：用户态通过文件描述符（fd）发起请求，内核根据命令码（cmd）将请求路由到对应驱动注册的 unlocked_ioctl（或 compat_ioctl）回调函数。整个交互过程分为三个阶段：

1. 用户态发起：应用程序调用 ioctl(fd, cmd, arg)，其中 cmd 为命令码，arg 为可选参数指针。
2. 内核路由：VFS 层根据 fd 找到对应的 file_operations 结构，调用驱动注册的 ioctl 回调。
3. 驱动处理：驱动解析命令码，执行对应操作，并通过 copy_from_user / copy_to_user 完成数据交换。

2.2 ioctl 命令码格式

Linux 内核将 ioctl 命令码编码为一个 32 位整数，分为四个字段，用于唯一标识命令并携带类型、方向、大小等信息。这种编码机制使得内核可以在不调用驱动的情况下，对命令进行初步合法性检查。

2.3 标准构造宏：_IO / _IOR / _IOW / _IOWR

Linux 内核提供四个标准宏，用于根据方向、幻数、序号和参数类型自动生成 ioctl 命令码。驱动开发者应始终使用这些宏，而不是手动拼接位域。

宏的第三个参数是数据类型（结构体类型名），宏内部通过 sizeof(type) 自动计算大小字段。例如：

/* V4L2 核心命令定义示例 */
#define VIDIOC_QUERYCAP   _IOR('V',  0, struct v4l2_capability)
#define VIDIOC_S_FMT      _IOW('V',  5, struct v4l2_format)
#define VIDIOC_REQBUFS    _IOWR('V',  8, struct v4l2_requestbuffers)
#define VIDIOC_STREAMON   _IO('V', 18)

2.4 内核辅助宏与校验机制

内核提供一组辅助宏，用于在驱动中解析和校验命令码：

• _IOC_DIR(cmd)：提取方向字段，返回 _IOC_NONE、_IOC_READ、_IOC_WRITE 或 _IOC_READ|_IOC_WRITE。
• _IOC_TYPE(cmd)：提取幻数字段，用于校验设备类型是否匹配。
• _IOC_NR(cmd)：提取序号字段，用于命令分发。
• _IOC_SIZE(cmd)：提取大小字段，用于缓冲区长度校验。

在 V4L2 框架中，video_ioctl2 内部已经实现了命令码的幻数校验和方向匹配，驱动开发者只需关注具体命令的处理逻辑。但自定义 ioctl 命令时，必须手动调用上述宏进行安全校验。

2.5 V4L2 命令码实例分析

以 VIDIOC_S_FMT 为例，分析其命令码构成：

/* 定义 */
#define VIDIOC_S_FMT _IOW('V', 5, struct v4l2_format)

/* 展开后的 32 位命令码 */
/* 方向: _IOC_WRITE = 1 (01b) → 位 31-30 = 01 */
/* 大小: sizeof(struct v4l2_format) = 200 (0xC8) → 位 29-16 = 0x00C8 */
/* 幻数: 'V' = 0x56 → 位 15-8 = 0x56 */
/* 序号: 5 → 位 7-0 = 0x05 */
/* 最终命令码: 0x40085605 */