3. ioctl 命令编码规范

Linux 内核中的 ioctl 命令码是一个 32 位整数，它不仅仅是一个简单的数字，而是按照严格的位域结构进行编码。这种编码规范使得内核能够对 ioctl 命令进行类型检查、权限验证和数据大小校验，从而避免错误或恶意的命令传递到驱动中。

3.1 ioctl 命令码的 32 位组成

一个标准的 ioctl 命令码被划分为 4 个位域，分别表示 类型（type）、序号（nr）、数据方向（direction） 和 数据大小（size）。其位域布局如下：

3.2 四个组成部分详解

3.3 标准宏定义：_IO / _IOR / _IOW / _IOWR

Linux 内核在 <linux/ioctl.h> 中提供了四个标准宏，用于生成符合规范的 ioctl 命令码。驱动开发者无需手动拼接位域，只需调用这些宏即可。

这些宏的第三个参数 datatype 是一个数据类型名称（如 struct my_data），宏内部通过 sizeof(datatype) 自动计算 size 字段。

3.4 宏定义源码解析

以下是内核中这些宏的核心实现逻辑（简化示意）：

// 构造 ioctl 命令码的核心宏
#define _IOC(dir, type, nr, size) \
    (((dir)  << _IOC_DIRSHIFT) | \
     ((type) << _IOC_TYPESHIFT) | \
     ((nr)   << _IOC_NRSHIFT) | \
     ((size) << _IOC_SIZESHIFT))

// 四个便捷宏
#define _IO(type, nr)          _IOC(_IOC_NONE,  (type), (nr), 0)
#define _IOR(type, nr, size)   _IOC(_IOC_READ,  (type), (nr), sizeof(size))
#define _IOW(type, nr, size)   _IOC(_IOC_WRITE, (type), (nr), sizeof(size))
#define _IOWR(type, nr, size)  _IOC(_IOC_READ|_IOC_WRITE, (type), (nr), sizeof(size))

3.5 实际驱动中的命令定义示例

假设我们编写一个字符设备驱动，设备幻数使用 'M'（0x4D），定义如下命令：

#define MY_IOCTL_MAGIC  'M'

#define MY_IOCTL_RESET      _IO(MY_IOCTL_MAGIC, 0)
#define MY_IOCTL_GET_STATUS _IOR(MY_IOCTL_MAGIC, 1, struct device_status)
#define MY_IOCTL_SET_CONFIG _IOW(MY_IOCTL_MAGIC, 2, struct device_config)
#define MY_IOCTL_EXCHANGE   _IOWR(MY_IOCTL_MAGIC, 3, struct exchange_data)

这些宏展开后，内核会自动生成唯一的 32 位命令码。例如 MY_IOCTL_GET_STATUS 的二进制表示中，direction 位为 01（读），type 为 0x4D，nr 为 1，size 为 sizeof(struct device_status)。

3.6 方向与权限检查

内核在 vfs_ioctl 路径中会检查命令码的 direction 字段，并据此决定是否需要进行读写权限验证：

• _IOC_NONE：不需要数据访问权限，仅检查文件是否已打开。
• _IOC_READ：要求文件以读权限打开（FMODE_READ）。
• _IOC_WRITE：要求文件以写权限打开（FMODE_WRITE）。
• _IOC_READ|_IOC_WRITE：要求同时具备读写权限。

3.7 编码规范最佳实践

1. 选择唯一的 type 幻数：优先使用 ASCII 字符，避免与内核已有驱动冲突。查询 Documentation/ioctl/ioctl-number.txt。
2. nr 序号从 0 开始：同一驱动内保持连续，便于维护和扩展。
3. 正确使用方向宏：只读操作使用 _IOR，只写操作使用 _IOW，双向操作使用 _IOWR，纯控制使用 _IO。
4. 避免手动构造命令码：始终使用标准宏，不要直接写 #define CMD 0x4D01 这样的魔数。
5. size 字段自动计算：宏的第三个参数传入数据类型，不要手动传入 sizeof 表达式。