C / C++ / 系统课时

访问设备与 ioctl 接口

访问设备与 ioctl 接口

Linux 把设备暴露成可打开的文件描述符,但设备控制并不等于普通文件读写。本课用终端设备演示 open 与 ioctl 的完整调用路径,说明字符设备、块设备的用户态差异,以及请求码、参数 ABI 和可移植性边界。

学习目标

  • 解释字符设备、块设备节点与内核驱动之间的关系。
  • 使用 ioctl 读取终端窗口大小,并正确处理返回值与 errno。
  • 判断设备控制代码的可移植性风险,避免硬编码请求码或错误解释第三个参数。

设备文件是驱动的入口

/dev 下的设备节点不是设备数据本身,而是用户态进入内核驱动的一种命名入口。进程对设备节点调用 open 后得到文件描述符,之后的 read、write、mmap 或 ioctl 会经过 VFS 分派到对应驱动实现。

字符设备通常提供字节流、消息或事件式接口,例如终端和串口;块设备面向可寻址的数据块,并接入内核块层,例如磁盘分区。两者都可能支持 ioctl,但具体请求完全由设备子系统和驱动定义,不能因为接口名相同就假设语义一致。

用户态通过文件描述符访问设备与 ioctl 的调用路径

用 ioctl 读取终端窗口大小

终端是适合练习 ioctl 的字符设备,因为查询窗口行列数不会修改设备状态。下面程序打开控制终端 /dev/tty,再用 TIOCGWINSZ 读取 struct winsize。把代码保存为 tty_size.c。

c
#define _GNU_SOURCE

#include <fcntl.h>
#include <stdio.h>
#include <string.h>
#include <sys/ioctl.h>
#include <unistd.h>

int main(void) {
    int fd = open("/dev/tty", O_RDONLY | O_CLOEXEC);
    if (fd == -1) {
        perror("open /dev/tty");
        return 1;
    }

    struct winsize ws = {0};

    /* request 决定第三个参数的类型与读写方向,这里要求传入 winsize 指针。 */
    if (ioctl(fd, TIOCGWINSZ, &ws) == -1) {
        perror("ioctl TIOCGWINSZ");
        close(fd);
        return 1;
    }

    printf("rows=%u cols=%u\n",
           (unsigned)ws.ws_row, (unsigned)ws.ws_col);

    if (close(fd) == -1) {
        perror("close");
        return 1;
    }
    return 0;
}

在交互式终端中编译运行:

bash
cc -std=c11 -Wall -Wextra -O2 tty_size.c -o tty_size
./tty_size

预期输出中的数值取决于当前终端尺寸:

text
rows=<VALUE> cols=<VALUE>

<VALUE> 是动态值,实际可能是 24、80 之外的任意有效行列数。如果程序运行在没有控制终端的服务、某些 CI 环境或后台会话中,open("/dev/tty", ...) 可能失败;这时错误本身就是环境条件,而不是 ioctl 语法错误。

ioctl 的核心是请求码与参数 ABI

ioctl 的形式是 ioctl(fd, request, ...)。第二个参数选择具体控制操作,第三个参数是否存在、是整数还是指针、指向什么结构体,都由该请求定义。调用者必须使用对应内核头文件中的常量和结构体,不能凭经验猜测。

Linux 中很多较新的 ioctl 请求使用 _IO、_IOR、_IOW、_IOWR 系列宏构造请求码,用来编码类型、编号以及数据方向等信息;但历史接口并不都遵循统一编码,因此用户程序不应通过“拆 request 数字”来推断全部语义。最可靠的依据仍是设备子系统的 UAPI 头文件和文档。

失败时首先检查返回值是否为 -1,再读取 errno。ENOTTY 常表示这个文件描述符不支持该请求,EINVAL 常表示参数或请求不适用;权限类操作还可能返回 EACCES 或 EPERM。不同驱动可以定义更多错误条件,不能把某一个 errno 当成所有设备的通用结论。

字符设备和块设备不要混用假设

字符设备常允许顺序读写、事件等待或设备专用控制;块设备则通常具有块寻址、容量、队列和缓存等语义。对块设备做原始写入可能直接破坏文件系统或分区数据,所以实验时不要随意对真实磁盘节点执行写操作。

如果程序要求“必须是某类设备”,可以在 open 后调用 fstat,用 S_ISCHR(st.st_mode) 或 S_ISBLK(st.st_mode) 检查文件描述符对应对象的类型。这个检查适合发现配置错误,但它并不能证明某个特定 ioctl 一定受支持;最终仍要以实际调用结果为准。

可移植性和安全边界

设备 ioctl 通常比普通 POSIX 文件接口更依赖 Linux 版本、CPU ABI、驱动版本和硬件能力。编写可移植程序时,应优先使用稳定的标准接口或成熟用户态库;只有缺少更高层接口时,再直接调用设备专用 ioctl。

不要把请求码写成神秘十六进制常量,也不要向内核传递未初始化结构体。若 UAPI 定义了 size、version 或保留字段,应按文档初始化;指针参数必须指向正确大小和布局的对象。某些危险操作还需要特权能力,具体可能涉及 CAP_SYS_ADMIN、CAP_SYS_RAWIO 或设备节点权限,必须按对应驱动文档判断,而不是给程序无条件提升权限。

把 ioctl 理解为“文件描述符上的驱动专用控制通道”最稳妥:先确认设备和请求的契约,再按它要求的 ABI 传参,并把不支持、权限不足和版本差异当作正常的边界条件处理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

访问设备与 ioctl 接口

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通