2. ioctl 系统调用原理：用户态与内核态通信机制、命令码编码规则

在帧缓冲驱动中，标准文件操作（open、read、write、mmap）只能提供有限的设备控制能力。要实现对显示参数（分辨率、位深、刷新率）的精细调节、硬件加速指令下发或私有寄存器读写，必须依赖 ioctl 系统调用。本章深入剖析 ioctl 的用户态-内核态通信机制与命令码编码规范，为后续自定义扩展命令打下坚实基础。

2.1 ioctl 系统调用概述

ioctl（Input/Output Control）是一个通用的设备控制接口，允许用户态程序向设备驱动程序发送控制命令并携带参数。其原型如下：

#include <sys/ioctl.h>

int ioctl(int fd, unsigned long request, ...);
// fd: 打开的设备文件描述符
// request: 驱动程序定义的命令码（32 位无符号整数）
// ...: 可选参数，通常为 unsigned long 或指针

内核中对应的驱动接口：

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

当用户态调用 ioctl 时，系统经历以下关键路径：

1. 系统调用入口：VFS 层根据文件描述符找到对应的 file 结构体。
2. 命令码检查：内核根据命令码的编码方向（读/写）决定是否需要进行用户态内存访问权限检查。
3. 驱动分发：调用 file_operations 中的 unlocked_ioctl 或 compat_ioctl 指针。
4. 参数传递：arg 参数直接传递，若为指针则需使用 copy_from_user / copy_to_user 安全访问。

2.2 用户态与内核态通信机制

由于用户态和内核态运行在不同的虚拟地址空间，ioctl 的参数传递必须经过严格的安全检查。下图展示了完整的通信流程：

2.3 ioctl 命令码编码规则

Linux 内核将 ioctl 命令码编码为一个 32 位无符号整数，分为四个字段。这种编码方式使得内核可以在不调用驱动的情况下，自动判断命令是否需要数据传输以及传输方向。

内核提供四个标准宏来构造命令码：

#include <asm/ioctl.h>

// 无数据传输（纯控制）
#define _IO(type, nr)           _IOC(_IOC_NONE,  (type), (nr), 0)

// 用户态写入数据到内核（写方向）
#define _IOW(type, nr, size)    _IOC(_IOC_WRITE, (type), (nr), sizeof(size))

// 用户态从内核读取数据（读方向）
#define _IOR(type, nr, size)    _IOC(_IOC_READ,  (type), (nr), sizeof(size))

// 双向数据传输
#define _IOWR(type, nr, size)   _IOC(_IOC_READ|_IOC_WRITE, (type), (nr), sizeof(size))

2.4 命令码编码实例分析

以帧缓冲驱动中常见的 FBIOPUT_VSCREENINFO 和 FBIOGET_VSCREENINFO 为例，分析其命令码构成：

// 定义在 include/uapi/linux/fb.h

#define FBIOGET_VSCREENINFO  0x4600
#define FBIOPUT_VSCREENINFO  0x4601

// 实际内核中推荐使用宏定义：
#define FBIOGET_VSCREENINFO  _IOR('F', 0x00, struct fb_var_screeninfo)
#define FBIOPUT_VSCREENINFO  _IOW('F', 0x01, struct fb_var_screeninfo)

分解 FBIOPUT_VSCREENINFO 命令码：

2.5 命令码解码与验证

内核提供辅助宏用于在驱动中解码命令码：

// 解码宏
_IOC_DIR(cmd)    // 获取方向
_IOC_TYPE(cmd)   // 获取幻数
_IOC_NR(cmd)     // 获取序号
_IOC_SIZE(cmd)   // 获取数据大小

// 典型驱动中的命令分发示例
static long fb_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
{
    struct fb_info *info = file->private_data;

    // 检查幻数是否匹配
    if (_IOC_TYPE(cmd) != FB_IOC_MAGIC)
        return -ENOTTY;

    // 检查序号是否在合法范围内
    if (_IOC_NR(cmd) > FB_IOC_MAXNR)
        return -ENOTTY;

    switch (cmd) {
    case FBIOGET_VSCREENINFO:
        // 读方向：内核→用户
        if (copy_to_user((void __user *)arg, &info->var,
                         sizeof(struct fb_var_screeninfo)))
            return -EFAULT;
        return 0;

    case FBIOPUT_VSCREENINFO:
        // 写方向：用户→内核
        if (copy_from_user(&info->var, (void __user *)arg,
                           sizeof(struct fb_var_screeninfo)))
            return -EFAULT;
        return 0;

    default:
        return -ENOTTY;
    }
}

2.6 命令码编码规则总结

下表对比了四种宏的使用场景和注意事项：

下图展示了命令码的位域布局与宏构造关系：