FDD-book存储篇:block设备与VFS层,如何写一个块驱动
FDD-book存储篇:block设备与VFS层,如何写一个块驱动
FreeBSD 设备驱动开源教程 FDD-book 的存储篇(第 27 章)手把手带你走完 块设备驱动 的完整开发路径:从理解 VFS 虚拟文件系统层与 GEOM 块层框架,到用 g_disk 注册伪磁盘、实现 bio 策略函数,最后用 newfs_ufs 格式化并挂载自己的块设备。本文面向新手,带你快速抓住写一个块驱动的核心脉络。
为什么块驱动不是"大号字符驱动"
写字符驱动(比如串口)时,你直接面对一个个 read/write 调用;而存储驱动生活的世界完全不同——用户把磁盘插入后,几乎从不裸读字节流,而是挂载文件系统,让磁盘"消失"在 VFS、缓存和 GEOM 之后。
请求从进程到你的驱动,要穿过这样一条栈:
| 层级 | 职责 |
|---|---|
| 用户进程 / 系统调用 | open、read、write |
| VFS | 统一所有文件系统的路径与 vnode 抽象 |
| 文件系统(UFS/ZFS/NFS…) | 把"文件"翻译成"块" |
| buffer cache | 缓存最近用过的块,写脏块延迟回写 |
| GEOM | 以 struct bio 为单位路由请求,支持分区/镜像/加密组合 |
| 你的块驱动 | disk_strategy 处理 bio,把块请求变成真实 I/O |
两个新手最容易混淆的点,先在这里说清:
- devfs ≠ VFS。
devfs是挂载在/dev下的一个文件系统;VFS 是所有文件系统(包括 devfs)共同接入的抽象框架。 - 块驱动的
/dev节点不是你创建的。字符驱动用make_dev自己造节点,而块驱动只要向 GEOM 发布 provider,内核会自动生成/dev/myblk0。
同一条 bio 路径有两条入口:用户用 dd 裸读写 /dev/myblk0,或者 UFS 挂载后读写文件。它们最终都汇聚到同一个策略函数——这就是块层统一抽象的威力。
FDD-book 存储篇速览
存储篇对应仓库中的 chapter-27.md(简体中文译本见 translations/zh_CN/chapters/part6/chapter-27.md),全书围绕一个自包含的伪块设备 myblk 展开,结构非常清晰:
- Section 1–2:VFS 是什么、devfs 与 VFS 如何区分;
- Section 3–4:用
g_disk注册伪磁盘,理解 GEOM 的 provider/consumer; - Section 5:实现真正的读写——内存背板 + 策略函数;
- Section 6:
newfs_ufs格式化、mount挂载、观察 BIO 流量; - Section 7–8:持久化方案与安全的卸载/清理顺序;
- Section 9–10:多实例扩展、
gstat/diskinfo/DTrace 等可观测性工具; - Hands-On Labs:探索 GEOM、测量块大小、竞态测试等实验。
配套驱动源码不到 200 行,完整可用:examples/part-06/ch27-storage-vfs/myfirst_blk.c,构建脚本见 examples/part-06/ch27-storage-vfs/Makefile。
三步写出你的第一个块驱动 🧱
第 1 步:用 g_disk 注册伪磁盘
g_disk 是内核为"磁盘形"驱动准备的高层 API,替你搞定 GEOM class、provider、devstat 计数和 /dev 节点。核心代码只有几行:
sc->disk = disk_alloc();
sc->disk->d_name = "myblk"; /* + unit=0 → /dev/myblk0 */
sc->disk->d_strategy = myblk_strategy;
sc->disk->d_sectorsize = 512;
sc->disk->d_mediasize = 32ULL * 1024 * 1024;
sc->disk->d_drv1 = sc; /* 回调里取回 softc */
disk_create(sc->disk, DISK_VERSION);
kldload 之后,/dev/myblk0 就出现了——没有任何 make_dev 调用。
第 2 步:实现策略函数(驱动的心脏)
策略函数就是一个 switch (bp->bio_cmd):
switch (bp->bio_cmd) {
case BIO_READ: memcpy(bp->bio_data, sc->backing + offset, len); break;
case BIO_WRITE: memcpy(sc->backing + offset, bp->bio_data, len); break;
case BIO_DELETE: memset(sc->backing + offset, 0, len); break;
case BIO_FLUSH: break; /* 内存背板永远"已落盘" */
default: bp->bio_error = EOPNOTSUPP;
bp->bio_flags |= BIO_ERROR;
}
biodone(bp); /* 每条 bio 必须且只能完成一次 */
三条黄金纪律:
- 防御性边界检查:用
len > sc->backing_size - offset而不是offset + len > size,避免算术溢出; biodone恰好一次:漏掉它,调用方会永久挂起;- 先解锁,再完成:不要在持有锁的状态下调用
biodone,防死锁。
第 3 步:格式化、挂载、验证
# newfs_ufs /dev/myblk0
# mount /dev/myblk0 /mnt/myblk
# echo "hello from myblk" > /mnt/myblk/hello.txt
# cat /mnt/myblk/hello.txt
# umount /mnt/myblk
能挂载、能写文件、能读回、能干净卸载——你的块驱动已经是一个"一等公民":UFS 和 dd 共享你写下的同一个块层协议。
验证工具箱:块驱动写完后查什么 🔍
| 命令 | 看什么 |
|---|---|
diskinfo -v /dev/myblk0 |
扇区大小、介质容量是否与设计一致 |
geom disk list myblk0 |
Mode: r0w0e0 访问计数,判断设备是否被占用 |
gstat -I 1 -f myblk0 |
实时 ops/s、吞吐、读写延迟 |
dd if=/dev/myblk0 of=/dev/null |
裸路径读写的端到端正确性 |
vmstat -m | grep myblk |
模块内存分配,卸载后是否归零(查漏) |
dmesg |
加载/卸载日志与内核告警 |
书中还配了可直接运行的实验脚本:探索 GEOM 拓扑的 lab01-explore-geom/explore.sh、测量块大小的 lab11-measure-blocksize/measure.sh、以及压测竞态的 lab12-race-test/race.sh。
新手最常踩的 4 个坑 🛡️
- 忘记
biodone:bio 泄漏,mount或dd永远挂起——这是"我的设备卡住了"的第一大来源。 - 持锁跨
biodone:完成回调会向上层拿锁,极易形成锁序反转死锁。先mtx_unlock,再完成请求。 - 越界检查写成
offset + len > size:恶意或异常的超大 offset 会溢出绕检查,破坏内核内存。永远用减法形式。 - 释放顺序不对:必须先
disk_destroy(等所有在途 bio 排空)再释放背板缓冲,且拆除顺序与分配严格相反。
顺带一提:文件系统还挂载着就 kldunload,内核会礼貌地报 Device busy 拒绝卸载——这是保护机制,先 umount 再卸载即可。
安全实验环境:动手前给虚拟机拍快照
内核开发的正确打开方式是在随时可回滚的环境里犯错。FDD-book 的建议是:为驱动实验准备一台专用 FreeBSD 虚拟机,每次做高风险操作(卸载模块、挂载、压测)之前先打一个快照,panic 也无所谓,一键恢复。
如果还没有克隆本仓库,可以执行:
git clone https://gitcode.com/gh_mirrors/fd/FDD-book
延伸阅读路线 📚
- 章节正文:content/chapters/part6/chapter-27.md(含 10 个 Section + 全套实验)
- 示例驱动:examples/part-06/ch27-storage-vfs/myfirst_blk.c(可直接编译的 Section 5 最终版)
- 内核源码参考:
/usr/src/sys/geom/geom_disk.c(g_disk 实现)、/usr/src/sys/dev/md/md.c(生产级内存盘,多背板类型 + 工作线程)、/usr/src/sys/geom/zero/g_zero.c(约 145 行的最小 GEOM class,看清 g_disk 替你隐藏了什么)
从 200 行的 myblk 到真实的 SATA/NVMe 驱动,模式完全一致:填好 struct disk、实现稳健的策略函数、守住生命周期纪律。块驱动的大门,就开在这里。


