4、命令码生成与解析：使用宏生成命令码、内核中解析命令码

在 Linux 内核驱动中，ioctl 命令码是一个 32 位整数，它编码了设备类型、命令序号、数据传输方向和参数大小。本章将深入讲解如何使用标准宏生成命令码，以及内核如何解析这些命令码以实现控制通路。

4.1 命令码的位域结构

Linux 内核将 32 位命令码划分为四个位域，每个位域承载特定的控制信息。下表列出了各字段的位宽与用途：

4.2 使用宏生成命令码

Linux 内核在 <linux/ioctl.h> 中提供了一组宏，用于在驱动头文件中生成标准命令码。开发者无需手动拼接位域，只需调用以下宏：

// 核心构造宏
_IOC(dir, type, nr, size)       // 通用构造
_IO(type, nr)                   // 无数据传输
_IOR(type, nr, size)            // 用户态读取（驱动写入）
_IOW(type, nr, size)            // 用户态写入（驱动读取）
_IOWR(type, nr, size)           // 双向数据传输

典型用法示例：

#include <linux/ioctl.h>

#define MY_DEVICE_TYPE  'K'          // 设备类型标识符
#define MY_CMD_GET_STATUS  _IOR(MY_DEVICE_TYPE, 0x01, struct my_status)
#define MY_CMD_SET_CONFIG  _IOW(MY_DEVICE_TYPE, 0x02, struct my_config)
#define MY_CMD_RESET       _IO(MY_DEVICE_TYPE, 0x03)
#define MY_CMD_EXCHANGE    _IOWR(MY_DEVICE_TYPE, 0x04, struct my_data)

4.3 命令码生成流程

下图展示了从宏调用到最终 32 位命令码的生成流程：

4.4 内核中解析命令码

当用户态调用 ioctl() 系统调用后，内核 VFS 层将命令码传递给驱动的 unlocked_ioctl 函数。驱动内部使用以下宏解析命令码的各个位域：

// 解析宏定义（位于 <linux/ioctl.h>）
_IOC_DIR(cmd)    // 提取方向位
_IOC_TYPE(cmd)   // 提取设备类型
_IOC_NR(cmd)     // 提取命令序号
_IOC_SIZE(cmd)   // 提取参数大小

典型解析示例：

static long my_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
    int dir  = _IOC_DIR(cmd);
    int type = _IOC_TYPE(cmd);
    int nr   = _IOC_NR(cmd);
    int size = _IOC_SIZE(cmd);

    // 1. 检查设备类型是否匹配
    if (type != MY_DEVICE_TYPE)
        return -ENOTTY;

    // 2. 检查参数大小是否合法
    if (size > sizeof(struct my_config))
        return -EINVAL;

    // 3. 根据命令序号分发
    switch (nr) {
    case 0x01:
        // 处理 GET_STATUS
        break;
    case 0x02:
        // 处理 SET_CONFIG
        break;
    case 0x03:
        // 处理 RESET
        break;
    default:
        return -ENOTTY;
    }

    return 0;
}

4.5 方向位解析与内存拷贝

内核在调用驱动之前，会根据 _IOC_DIR 自动完成用户态与内核态之间的内存拷贝。方向位的取值与对应行为如下：

4.6 命令码解析流程图

下图展示了内核从接收系统调用到驱动解析命令码的完整控制通路：

4.7 常见错误与调试技巧

• 命令码不匹配：用户态与内核态使用不同的 type 或 nr 定义，导致 _IOC_TYPE 校验失败，返回 -ENOTTY。
• 数据结构大小不一致：用户态与内核态的结构体定义存在差异（如字节对齐、字段顺序），导致 _IOC_SIZE 不匹配。
• 方向位错误：使用 _IO 宏定义需要数据传输的命令，导致内核不执行内存拷贝，驱动访问无效指针。
• 调试方法：在驱动中使用 printk 打印 cmd 的十六进制值，结合 _IOC_DIR、_IOC_TYPE、_IOC_NR、_IOC_SIZE 解析宏定位问题。