C / C++ / 系统课时
访问设备与 ioctl 接口
访问设备与 ioctl 接口
Linux 把设备暴露成可打开的文件描述符,但设备控制并不等于普通文件读写。本课用终端设备演示 open 与 ioctl 的完整调用路径,说明字符设备、块设备的用户态差异,以及请求码、参数 ABI 和可移植性边界。
学习目标
- 解释字符设备、块设备节点与内核驱动之间的关系。
- 使用
ioctl读取终端窗口大小,并正确处理返回值与errno。 - 判断设备控制代码的可移植性风险,避免硬编码请求码或错误解释第三个参数。
设备文件是驱动的入口
/dev 下的设备节点不是设备数据本身,而是用户态进入内核驱动的一种命名入口。进程对设备节点调用 open 后得到文件描述符,之后的 read、write、mmap 或 ioctl 会经过 VFS 分派到对应驱动实现。
字符设备通常提供字节流、消息或事件式接口,例如终端和串口;块设备面向可寻址的数据块,并接入内核块层,例如磁盘分区。两者都可能支持 ioctl,但具体请求完全由设备子系统和驱动定义,不能因为接口名相同就假设语义一致。

用 ioctl 读取终端窗口大小
终端是适合练习 ioctl 的字符设备,因为查询窗口行列数不会修改设备状态。下面程序打开控制终端 /dev/tty,再用 TIOCGWINSZ 读取 struct winsize。把代码保存为 tty_size.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;
}在交互式终端中编译运行:
cc -std=c11 -Wall -Wextra -O2 tty_size.c -o tty_size
./tty_size预期输出中的数值取决于当前终端尺寸:
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 传参,并把不支持、权限不足和版本差异当作正常的边界条件处理。