3. Linux内核中的ioctl实现机制：file_operations结构体、unlocked_ioctl与compat_ioctl

在Linux内核中，ioctl（Input/Output Control）是设备驱动与用户空间应用程序进行控制交互的核心系统调用。其实现机制围绕 file_operations 结构体展开，并随着内核版本的演进，从传统的 ioctl 方法演变为现代的 unlocked_ioctl 与 compat_ioctl 双接口模式。理解这一机制是编写正确、兼容的subdev驱动的基础。

3.1 file_operations结构体中的ioctl接口

file_operations 是字符设备驱动的核心数据结构，它定义了设备文件所支持的各种操作函数指针。与ioctl相关的成员经历了从单一到双接口的演变：

static const struct file_operations subdev_fops = {
    .owner          = THIS_MODULE,
    .open           = subdev_open,
    .release        = subdev_release,
    .unlocked_ioctl = subdev_unlocked_ioctl,
    .compat_ioctl   = subdev_compat_ioctl,
    .llseek         = no_llseek,
};

3.2 unlocked_ioctl：现代驱动的标准入口

unlocked_ioctl 的函数原型如下：

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

• filp：文件指针，指向打开的设备文件实例。可用于访问私有数据（filp->private_data）。
• cmd：由用户空间传入的ioctl命令码，通常使用 _IOR/_IOW/_IOWR 宏生成。
• arg：可选的参数，可以是整数、指针（需使用 copy_from_user/copy_to_user 访问）或NULL。

典型实现模板：

static long subdev_unlocked_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
    struct subdev_device *dev = filp->private_data;
    int ret = 0;

    // 使用互斥锁保护临界区
    mutex_lock(&dev->lock);

    switch (cmd) {
    case SUBDEV_GET_CONFIG:
        ret = subdev_get_config(dev, (void __user *)arg);
        break;
    case SUBDEV_SET_CONFIG:
        ret = subdev_set_config(dev, (void __user *)arg);
        break;
    default:
        ret = -ENOTTY;  // 不支持的ioctl命令
        break;
    }

    mutex_unlock(&dev->lock);
    return ret;
}

3.3 compat_ioctl：32/64位兼容的桥梁

当64位内核运行32位用户空间程序时，用户空间传入的数据结构布局可能与内核期望的不同（例如 sizeof(long) 不同、结构体对齐填充不同）。compat_ioctl 负责在调用真正的处理函数之前，将32位数据结构转换为64位版本。

触发条件：

• 内核为64位（x86_64、ARM64等）。
• 用户空间程序为32位（通过 compat_sys_ioctl 系统调用入口）。
• 驱动注册了 .compat_ioctl 方法。

实现策略对比：

// 64位原生结构体
struct subdev_config {
    __u32 mode;
    __u64 frequency;  // 64位，在32位中会8字节对齐
    __u32 flags;
};

// 32位兼容结构体（packed避免对齐填充差异）
struct subdev_config32 {
    __u32 mode;
    __u32 frequency_hi;  // 拆分为两个32位
    __u32 frequency_lo;
    __u32 flags;
} __attribute__((packed));

static long subdev_compat_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
    struct subdev_config32 kcfg32;
    struct subdev_config kcfg;
    void __user *uarg = (void __user *)arg;

    switch (cmd) {
    case SUBDEV_SET_CONFIG:
        if (copy_from_user(&kcfg32, uarg, sizeof(kcfg32)))
            return -EFAULT;
        // 转换32位结构体到64位
        kcfg.mode = kcfg32.mode;
        kcfg.frequency = ((__u64)kcfg32.frequency_hi << 32) | kcfg32.frequency_lo;
        kcfg.flags = kcfg32.flags;
        // 调用真正的处理函数
        return subdev_set_config_internal(filp->private_data, &kcfg);
    default:
        // 对于不涉及结构体的命令，直接转发给unlocked_ioctl
        return subdev_unlocked_ioctl(filp, cmd, arg);
    }
}

3.4 命令码分发与默认处理

在 unlocked_ioctl 和 compat_ioctl 内部，通常使用 switch 语句根据 cmd 进行分发。内核提供了 _IOC_TYPE(cmd)、_IOC_NR(cmd)、_IOC_DIR(cmd) 和 _IOC_SIZE(cmd) 宏来解析命令码的各个字段，便于实现更精细的分发逻辑。

最佳实践清单：

• 始终在 switch 的 default 分支返回 -ENOTTY（不适当的ioctl命令）。
• 对于 compat_ioctl，如果某个命令不涉及指针或结构体，可以直接调用 unlocked_ioctl 避免代码重复。
• 使用 __attribute__((packed)) 定义32位兼容结构体，防止编译器插入对齐填充。
• 在 compat_ioctl 中完成数据转换后，调用与 unlocked_ioctl 相同的内部处理函数，保持逻辑统一。