3. ioctl 系统调用原型：用户态与内核态接口

ioctl 是 Linux 设备驱动中实现“非标准控制操作”的核心系统调用。用户态与内核态的原型在参数类型、返回值语义上存在显著差异，理解这些差异是正确设计 ioctl 命令集的前提。

3.1 用户态原型：int ioctl(int fd, unsigned long cmd, ...)

用户态程序通过 ioctl() 向设备文件描述符发送控制命令。其原型定义在 <sys/ioctl.h> 中：

#include <sys/ioctl.h>

int ioctl(int fd, unsigned long cmd, ...);

3.2 内核态原型：long unlocked_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)

在 Linux 2.6.36 之后，内核推荐驱动实现 unlocked_ioctl 而非旧的 ioctl 方法。新原型不再持有 BKL（大内核锁），驱动需自行保证并发安全。原型定义在 struct file_operations 中：

struct file_operations {
    // ...
    long (*unlocked_ioctl) (struct file *filp, unsigned int cmd, unsigned long arg);
    // ...
};

3.3 用户态与内核态原型对比

3.4 系统调用数据流：从用户态到内核态

下图展示了 ioctl 系统调用从用户态应用发起，经过 VFS 层，最终到达驱动 unlocked_ioctl 的完整数据流：

3.5 数据拷贝：copy_from_user 与 copy_to_user

内核态不能直接解引用用户态指针。驱动必须使用内核提供的安全拷贝函数，这些函数会检查用户态地址的合法性并处理缺页异常：

// 从用户态拷贝数据到内核态
long copy_from_user(void *to, const void __user *from, unsigned long n);

// 从内核态拷贝数据到用户态
long copy_to_user(void __user *to, const void *from, unsigned long n);

struct my_data {
    int value;
    char name[32];
};

// 写操作：从用户态接收数据
long my_ioctl_write(struct file *filp, unsigned int cmd, unsigned long arg) {
    struct my_data kdata;
    if (copy_from_user(&kdata, (void __user *)arg, sizeof(kdata)))
        return -EFAULT;
    // 使用 kdata 操作硬件...
    return 0;
}

// 读操作：向用户态返回数据
long my_ioctl_read(struct file *filp, unsigned int cmd, unsigned long arg) {
    struct my_data kdata = { .value = 42, .name = "device" };
    if (copy_to_user((void __user *)arg, &kdata, sizeof(kdata)))
        return -EFAULT;
    return 0;
}

3.6 常见错误与避坑指南

• 错误一：直接解引用用户态指针 — 内核无法保证用户态指针有效，直接访问会导致 Oops 或内核崩溃。必须使用 copy_from_user/copy_to_user。
• 错误二：忽略返回值检查 — copy_from_user 返回未拷贝的字节数，非零表示拷贝失败，应返回 -EFAULT。
• 错误三：cmd 类型不匹配 — 用户态 unsigned long 与内核态 unsigned int 在 64 位系统上长度不同，但内核会截断高位，通常不影响命令码匹配。
• 错误四：并发访问无保护 — unlocked_ioctl 不持有 BKL，多个线程可能同时调用，驱动必须使用互斥体或自旋锁保护共享数据。