Translation pending. This page is currently available in Chinese.
用户接口与 devfs¶
A20OS 的 driver class 是内核内部接口,但 class publication 同时驱动动态 devfs/sysfs 视图。char、block、audio 自动生成通用节点;net、input、display 不自动生成同名动态 devfs 节点,分别由内核消费者或既有聚合 ABI 使用。
当前数据路径¶
userspace read/ioctl
-> VFS vfile_ops
-> devfs 动态 class 节点或固定聚合节点
-> endpoint/class 引用和 active-call 准入
-> typed class_ops(device_t *, kernel buffer)
-> drv_priv / hardware
kernel/fs/devfs/devfs.c 的 g_nodes[] 仍定义 /dev/fb0、/dev/event0、tty、loop 等固定服务节点。除此之外,根目录 lookup/readdir 会查询 class registry,为在线的 char、block、audio 实例动态构造 /dev/charN、/dev/diskN、/dev/audioN。打开文件持有 publication 引用;核心先 offline,已登记的 execution stop 在排空前安全解决请求,随后 quiesce/drain/remove。后续操作返回 ENODEV,旧文件不跟随重绑。
所有 class 还动态出现在 /sys/class/{char,block,net,input,display,audio}/<name>/dev;dev 内容是该 class device 的 major:minor。既有 /sys/class/drm 和 /sys/block/loopN 兼容视图独立保留。
用户 buffer 边界¶
read/write 的 VFS/ABI 路径负责用户地址检查和复制,class ops 接收内核 buffer。ioctl 尚未完全统一:dynamic block 的 GET_CAPACITY/GET_SECTOR_SZ 和 audio 通用 ioctl 在适配器中 usercopy;未知 block ioctl 与 char ioctl 当前把原始 arg 继续传给 class op。新增自定义 ioctl 不能假定该指针已验证,也不能在硬件驱动中直接解引用;应先补通用封送层。这个已知边界不改变 read/write 的内核 buffer 契约。
新节点怎么做¶
当前没有让硬件驱动自选任意节点名的 devfs_register_device(name, dev, ops) API。不要从硬件驱动直接修改 g_nodes 或持有 vnode。选择顺序应是:
- char、block、audio 注册 class 后直接获得动态通用节点。
- input/display 注册 class 后由固定
/dev/event0、/dev/fb0聚合或选择。 - 若是内核子系统消费者,例如 network,注册 class 后由 lwIP 消费,不需要
/dev。 - 无合适 class 的内核服务可发布独立原生协议;确需用户入口时,在 Native broker/通用 ABI adapter 中定义权限、封送和等待,再决定 devfs 或 handle 的表达,不为每个可选功能增加 class。
- 单一厂商调试接口应优先放 debug/proc 通道,不要把不稳定寄存器操作发布为长期 ioctl ABI。
新增 devfs ABI 必须规定节点命名、多实例编号、open 时如何绑定 device_t、权限、read/write 单位、阻塞、poll、ioctl 结构版本和 remove 后已打开 fd 的行为。
Display¶
/dev/fb0 每次 ioctl/mmap/刷新捕获默认 GPU 的一次 scoped access,身份与 ops 属于同一绑定;open 不固定一个专属设备。RAM scanout 优先由 owning VMO snapshot/VMA 保留,支持 fork/split;旧 get_fb 物理分支仍借用 backing,没有通用撤销协议。DRM open 则固定 publication,GEM/FB/上下文按 publication 与文件归属管理;退出在安全 stop/退休和 call drain 之后交还实例。详见 Display 与请求执行。
Input¶
/dev/event0 是聚合器,不是严格的一设备一节点 evdev。它枚举 DEV_CLASS_INPUT(例如 USB HID class)并合并 VirtIO input 事件。新 input 类驱动实现 read/poll 即可被发现。事件必须是完整 struct input_event;class read 在无事件时返回 -EAGAIN,不得让适配器依赖硬件私有 getter。
Audio¶
每个 DEV_CLASS_AUDIO 实例自动发布一个 /dev/audioN。devfs 只负责断开检查、用户 buffer 转换,并把通用 ioctl/close 交给 audio_core;它不包含 HDA、virtio-sound、PC Speaker 或其他硬件策略。客户端必须先查询 capability;PCM fd 的正常 close 会先 drain,立即中止则使用 STOP。完整 ABI 见 音频子系统。
Block 与 network¶
network 由 lwip_stack.c 枚举 DEV_CLASS_NET,没有网卡字符节点。每个 block class 实例有动态 /dev/diskN,文件系统也可直接枚举 class 接入挂载请求;驱动只实现 class ops,不创建私有节点或 getter。
ABI 设计检查¶
- 用户结构使用固定宽度整数,不使用裸指针或随架构变化的
long,除非已是兼容 ABI。 - 结构带
size/version或预留字段,输出先清零,防止泄漏内核栈。 - 所有长度、offset、count 做溢出检查;未知 flags 拒绝。
- 非阻塞语义统一用
-EAGAIN,未知 ioctl 用-ENOTTY。 - remove 后操作返回
-ENODEV,不得访问已释放drv_priv。 - 用户映射必须定义 cache 属性、共享/复制语义、fork 行为和撤销策略。
从具体硬件驱动里直接创建或修改 devfs 节点,会让节点生命周期和硬件 remove 脱节:open 的 fd 可能在设备释放后仍然指向已释放 drv_priv,造成 use-after-free。