2. ioctl 系统调用原型：用户态与内核态接口定义、参数解析（fd, cmd, arg）

ioctl 是 Linux 驱动开发中最灵活、也最容易出错的系统调用之一。理解其用户态与内核态的双面接口定义，以及三个参数 fd、cmd、arg 的完整传递路径，是编写安全、规范 ioctl 命令的基石。本章从原型出发，逐层拆解参数语义、传递机制与校验要点。

2.1 用户态接口原型

用户态程序通过 glibc 封装的 ioctl() 函数发起系统调用，其原型定义在 <sys/ioctl.h> 中：

#include <sys/ioctl.h>

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

2.2 内核态接口原型

在内核驱动中，ioctl 通过 struct file_operations 中的 unlocked_ioctl 或 compat_ioctl 方法实现：

#include <linux/fs.h>

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

2.3 参数传递路径与数据流

从用户态 ioctl(fd, cmd, arg) 到内核态 unlocked_ioctl(filp, cmd, arg)，参数经历以下传递路径：

1. 用户态调用：glibc 将 fd、cmd、arg 放入寄存器（x86-64 为 rdi, rsi, rdx），触发 syscall 指令。
2. 系统调用入口：内核 sys_ioctl() 根据 fd 查找 struct file，获取 filp 对象。
3. VFS 分发：调用 filp->f_op->unlocked_ioctl(filp, cmd, arg)。
4. 驱动处理：驱动根据 cmd 解析命令，通过 arg 访问用户态数据。

2.4 参数语义深度解析

2.4.1 fd：文件描述符

• 来源：由 open("/dev/xxx", O_RDWR) 返回，指向设备文件。
• 内核映射：通过 fd 查找当前进程的文件描述符表，获取 struct file *filp。
• 校验点：驱动应通过 filp->private_data 验证设备是否已正确打开，避免未初始化状态下的 ioctl 调用。

2.4.2 cmd：命令码

cmd 是 ioctl 的核心，编码了操作的全部元信息。Linux 内核推荐使用 _IO、_IOR、_IOW、_IOWR 宏构造命令码：

#include <linux/ioctl.h>

#define MY_IOCTL_MAGIC  'M'

#define MY_IOCTL_GET   _IOR(MY_IOCTL_MAGIC, 1, struct my_data)
#define MY_IOCTL_SET   _IOW(MY_IOCTL_MAGIC, 2, struct my_data)
#define MY_IOCTL_RW    _IOWR(MY_IOCTL_MAGIC, 3, struct my_data)

2.4.3 arg：参数指针

arg 的语义由 cmd 决定，常见用法包括：

• 无参数命令：arg 被忽略，驱动直接执行操作。
• 整数参数：arg 直接作为整数值传递（如设置波特率），驱动通过 (int)arg 转换。
• 指针参数：arg 指向用户态缓冲区，驱动通过 copy_from_user / copy_to_user 安全访问。
• 结构体指针：arg 指向用户态结构体，驱动需校验结构体大小与字段合法性。

2.5 安全校验清单

2.6 完整示例：安全 ioctl 实现框架

static long my_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
    struct my_device *dev = filp->private_data;
    struct my_data kdata;
    int ret = 0;

    /* 1. 检查设备状态 */
    if (!dev || !dev->initialized)
        return -ENODEV;

    /* 2. 检查 cmd 魔数 */
    if (_IOC_TYPE(cmd) != MY_IOCTL_MAGIC)
        return -ENOTTY;

    /* 3. 检查 cmd 序号范围 */
    if (_IOC_NR(cmd) < MY_IOCTL_MIN || _IOC_NR(cmd) > MY_IOCTL_MAX)
        return -ENOTTY;

    /* 4. 检查数据方向与大小 */
    if (_IOC_DIR(cmd) & _IOC_READ)
        ret = !access_ok(VERIFY_WRITE, (void __user *)arg, _IOC_SIZE(cmd));
    else if (_IOC_DIR(cmd) & _IOC_WRITE)
        ret = !access_ok(VERIFY_READ, (void __user *)arg, _IOC_SIZE(cmd));
    if (ret)
        return -EFAULT;

    switch (cmd) {
    case MY_IOCTL_GET:
        /* 安全读取内核数据到用户态 */
        if (copy_to_user((void __user *)arg, &dev->data, sizeof(dev->data)))
            return -EFAULT;
        break;

    case MY_IOCTL_SET:
        /* 安全从用户态写入内核 */
        if (copy_from_user(&kdata, (void __user *)arg, sizeof(kdata)))
            return -EFAULT;
        /* 校验数据合法性 */
        if (!my_validate_data(&kdata))
            return -EINVAL;
        dev->data = kdata;
        break;

    default:
        return -ENOTTY;
    }

    return 0;
}

2.7 用户态与内核态接口对比总结