FDD-book存储篇:block设备与VFS层,如何写一个块驱动

原创2026-11-14 09:18:261,732 阅读

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 挂载后读写文件。它们最终都汇聚到同一个策略函数——这就是块层统一抽象的威力。

FreeBSD虚拟机启动菜单:搭建块驱动开发实验环境

FDD-book 存储篇速览

存储篇对应仓库中的 chapter-27.md(简体中文译本见 translations/zh_CN/chapters/part6/chapter-27.md),全书围绕一个自包含的伪块设备 myblk 展开,结构非常清晰:

  1. Section 1–2:VFS 是什么、devfs 与 VFS 如何区分;
  2. Section 3–4:用 g_disk 注册伪磁盘,理解 GEOM 的 provider/consumer;
  3. Section 5:实现真正的读写——内存背板 + 策略函数;
  4. Section 6:newfs_ufs 格式化、mount 挂载、观察 BIO 流量;
  5. Section 7–8:持久化方案与安全的卸载/清理顺序;
  6. Section 9–10:多实例扩展、gstat/diskinfo/DTrace 等可观测性工具;
  7. 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 共享你写下的同一个块层协议。

在FreeBSD终端中验证块驱动:diskinfo、gstat等命令输出

验证工具箱:块驱动写完后查什么 🔍

命令 看什么
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 个坑 🛡️

  1. 忘记 biodone:bio 泄漏,mount 或 dd 永远挂起——这是"我的设备卡住了"的第一大来源。
  2. 持锁跨 biodone:完成回调会向上层拿锁,极易形成锁序反转死锁。先 mtx_unlock,再完成请求。
  3. 越界检查写成 offset + len > size:恶意或异常的超大 offset 会溢出绕检查,破坏内核内存。永远用减法形式。
  4. 释放顺序不对:必须先 disk_destroy(等所有在途 bio 排空)再释放背板缓冲,且拆除顺序与分配严格相反。

顺带一提:文件系统还挂载着就 kldunload,内核会礼貌地报 Device busy 拒绝卸载——这是保护机制,先 umount 再卸载即可。

安全实验环境:动手前给虚拟机拍快照

内核开发的正确打开方式是在随时可回滚的环境里犯错。FDD-book 的建议是:为驱动实验准备一台专用 FreeBSD 虚拟机,每次做高风险操作(卸载模块、挂载、压测)之前先打一个快照,panic 也无所谓,一键恢复。

FreeBSD虚拟机快照对话框:块驱动实验前的安全回滚点

如果还没有克隆本仓库,可以执行:

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、实现稳健的策略函数、守住生命周期纪律。块驱动的大门,就开在这里。

登录后查看全文
FDD-book