4. 用户态ioctl调用：open/ioctl/close流程、cmd与arg参数传递、返回值处理与errno设置

用户态程序通过标准系统调用接口与内核驱动交互。ioctl 的完整调用链路涉及 open → ioctl → close 三个步骤，每一步都承载着特定的资源管理职责。本章深入剖析用户态视角下的 ioctl 调用规范，包括文件描述符的获取、命令码与参数的传递方式、返回值的语义解读以及 errno 错误码的设置规则。

4.1 标准调用流程：open → ioctl → close

用户态程序操作设备文件时，必须遵循以下三步流程：

1. open()：获取文件描述符 fd，建立用户态与内核驱动的通信通道。
2. ioctl()：通过 fd 发送命令码 cmd 并携带参数 arg，触发内核驱动的对应处理逻辑。
3. close()：释放文件描述符，通知驱动清理资源。

4.1.1 调用流程SVG图

4.2 cmd 与 arg 参数传递机制

ioctl 系统调用的核心签名如下：

#include <sys/ioctl.h>

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

第三个参数在标准 C 中为变参，实际使用时通常传递 unsigned long arg。cmd 和 arg 的传递遵循以下规则：

4.2.1 cmd 编码结构

Linux 内核使用 _IO、_IOR、_IOW、_IOWR 宏构造命令码，编码格式如下：

| 31 ... 30 | 29 ... 16 | 15 ... 8 | 7 ... 0 |
|  direction |    size   |   type   |  number |

4.2.2 arg 参数传递方式

arg 参数可以承载三种类型的数据：

• 整型值：直接传递整数，适用于简单配置项（如设置波特率、开关标志）。
• 用户态指针：指向用户态内存缓冲区，用于传输结构体数据。内核驱动必须使用 copy_from_user / copy_to_user 安全拷贝。
• NULL：不传递额外数据，仅通过 cmd 触发动作（如复位、刷新）。

4.3 返回值处理与 errno 设置

ioctl 系统调用的返回值语义如下：

4.3.1 常见 errno 错误码

4.3.2 用户态错误处理示例

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

#define MY_IOCTL_TYPE  'K'
#define MY_IOCTL_GET  _IOR(MY_IOCTL_TYPE, 1, int)
#define MY_IOCTL_SET  _IOW(MY_IOCTL_TYPE, 2, int)

int main(void) {
    int fd;
    int value;
    int ret;

    /* 1. 打开设备 */
    fd = open("/dev/mydevice", O_RDWR);
    if (fd < 0) {
        fprintf(stderr, "open failed: %s\n", strerror(errno));
        return EXIT_FAILURE;
    }

    /* 2. 执行 ioctl 读取 */
    ret = ioctl(fd, MY_IOCTL_GET, &value);
    if (ret < 0) {
        fprintf(stderr, "ioctl GET failed: %s (errno=%d)\n",
                strerror(errno), errno);
        close(fd);
        return EXIT_FAILURE;
    }
    printf("GET value: %d\n", value);

    /* 3. 执行 ioctl 写入 */
    value = 42;
    ret = ioctl(fd, MY_IOCTL_SET, &value);
    if (ret < 0) {
        fprintf(stderr, "ioctl SET failed: %s (errno=%d)\n",
                strerror(errno), errno);
        close(fd);
        return EXIT_FAILURE;
    }

    /* 4. 关闭设备 */
    close(fd);
    return EXIT_SUCCESS;
}

4.4 完整调用流程SVG图

4.5 常见错误与避坑指南

4.6 本章小结

• 用户态 ioctl 调用必须遵循 open → ioctl → close 的完整流程，缺一不可。
• cmd 命令码由 direction、size、type、number 四部分编码构成，用户态与内核态必须使用一致的宏定义。
• arg 参数可以是整型值、用户态指针或 NULL，内核驱动必须使用安全拷贝函数访问用户态数据。
• ioctl 返回值 0 或正数表示成功，-1 表示失败，需通过 errno 获取具体错误原因。
• 常见 errno 包括 EBADF、EFAULT、EINVAL、ENOTTY、ENOMEM、EPERM，分别对应不同的失败场景。
• 用户态程序必须检查每次 ioctl 的返回值，并在失败时正确处理，避免数据损坏或程序崩溃。