1. ioctl 概述
在 Linux 设备驱动开发中，ioctl（Input/Output Control）是用户空间与内核空间进行控制类交互的核心系统调用。它弥补了标准文件操作（read/write）在设备控制能力上的不足，是驱动开发者必须掌握的关键接口。
1.1 ioctl 系统调用的作用
ioctl 系统调用允许用户程序向设备驱动程序发送控制命令，并携带参数数据，从而实现设备配置、状态查询、硬件控制等操作。其原型定义在 <sys/ioctl.h> 中：
#include <sys/ioctl.h>
int ioctl(int fd, unsigned long request, ...);
参数说明：
| 参数 | 类型 | 描述 |
|---|---|---|
fd |
int |
通过 open() 获得的设备文件描述符 |
request |
unsigned long |
设备驱动定义的命令码，编码了命令类型、方向、大小等信息 |
... |
可变参数 | 通常为 void *argp，指向用户空间的数据缓冲区 |
关键理解： ioctl 的第三个参数是可变参数，但实际使用时几乎总是传递一个指针。驱动通过命令码解析该指针指向的数据，完成特定操作。
1.2 ioctl 与 read/write 的区别
传统的 read() 和 write() 系统调用设计用于数据流传输，而 ioctl 专为设备控制而生。下表从多个维度对比三者的差异：
| 对比维度 | read() / write() | ioctl() |
|---|---|---|
| 核心用途 | 数据块传输（流式 I/O） | 设备控制、配置、状态查询 |
| 操作语义 | 顺序、流式、面向数据 | 随机、命令式、面向控制 |
| 参数结构 | 固定：buf, count | 灵活：命令码 + 任意结构指针 |
| 命令扩展性 | 无（仅传输数据） | 强（驱动自定义命令集） |
| 典型场景 | 读取传感器数据、写入显示帧缓冲 | 设置波特率、启动马达、查询固件版本 |
| 内核实现 | file_operations 中的 read/write 回调 | file_operations 中的 unlocked_ioctl 回调 |
核心原则： 如果操作涉及设备状态的改变或查询，而不是单纯的数据搬运，就应该使用 ioctl。例如：设置串口波特率、切换摄像头模式、查询磁盘健康状态。
1.3 ioctl 的典型应用场景
ioctl 在嵌入式系统和 Linux 驱动中无处不在，主要覆盖以下三大类场景：
- 设备配置： 修改设备的工作参数或运行模式。例如：设置网络接口的 IP 地址、调整音频设备的采样率、配置 GPIO 的输入/输出方向。
- 设备控制： 执行特定的硬件操作或状态切换。例如：启动/停止电机、触发摄像头拍照、复位硬件模块。
- 状态查询： 获取设备的当前状态或诊断信息。例如：读取设备温度、查询固件版本号、获取缓冲区使用情况。
以下 SVG 图展示了 ioctl 在用户空间与内核空间之间的典型交互流程：
注意事项： ioctl 的第三个参数在用户空间和内核空间之间传递数据时，必须使用
copy_from_user() 和 copy_to_user() 等安全拷贝函数，避免直接解引用用户空间指针导致内核崩溃或安全漏洞。
1.4 命令码的编码结构
Linux 内核为 ioctl 命令码定义了标准编码规范，包含以下字段：
| 位域 | 宽度 | 名称 | 描述 |
|---|---|---|---|
| 31-30 | 2 bits | 方向 (Direction) | 00: 无数据；01: 写（用户→内核）；10: 读（内核→用户）；11: 读写 |
| 29-16 | 14 bits | 大小 (Size) | 参数数据结构的字节大小 |
| 15-8 | 8 bits | 类型 (Type / Magic Number) | 设备类型标识符（幻数），用于区分不同设备 |
| 7-0 | 8 bits | 序号 (Number / Function) | 设备内部的命令序号 |
内核提供了辅助宏来构建和解析命令码：
// 定义命令码宏
#define MY_IOCTL_SET _IOW('M', 1, struct my_data) // 写命令
#define MY_IOCTL_GET _IOR('M', 2, struct my_data) // 读命令
#define MY_IOCTL_BOTH _IOWR('M', 3, struct my_data) // 读写命令
// 解析命令码
_IOC_DIR(cmd) // 获取方向
_IOC_TYPE(cmd) // 获取类型
_IOC_NR(cmd) // 获取序号
_IOC_SIZE(cmd) // 获取大小
最佳实践： 始终使用内核提供的
_IO、_IOR、_IOW、_IOWR 宏来定义命令码，而不是手动拼装整数值。这能确保命令码的唯一性和可移植性，避免与其他设备驱动冲突。