ShadowMountPlus 挂载后端深入指南:LVD 与 MD 设备、BFS 快速路径的 I/O 加速机制
ShadowMountPlus 挂载后端深入指南:LVD 与 MD 设备、BFS 快速路径的 I/O 加速机制
ShadowMountPlus 是一款面向越狱 PS5 的自动化后台挂载(Auto-Mounter)payload,能自动检测并挂载 UFS、exFAT、PFS 及嵌套压缩 PFS 游戏备份。它的 I/O 性能核心在于两套挂载后端设备 LVD 与 MD,以及仅由 LVD 提供的 BFS 快速路径批量 I/O 加速。本文将带你彻底搞懂这些机制与开启条件。
ShadowMountPlus 挂载体系速览
ShadowMountPlus 把磁盘上的镜像文件(如 .ffpkg、.exfat)"挂"成虚拟块设备,再由系统内核把该设备挂载为文件系统,游戏就能像读取实体光盘/存储一样直接读档。整个链路上有三个角色:
| 角色 | 说明 | 示例 |
|---|---|---|
| 镜像文件 | 游戏备份本体,放在内盘或外置存储 | /data/homebrew/PPSA12345.ffpkg |
| 虚拟块设备 | 由后端创建,把文件映射为"磁盘" | /dev/lvdN、/dev/mdN |
| 挂载点 | 设备挂载后的游戏内容目录 | /mnt/shadowmnt/<image_name>_<hash> |
后端的选择由配置项决定,每种文件系统格式(exFAT / UFS)可独立选择:
# /data/shadowmount/config.ini
exfat_backend=lvd
ufs_backend=lvd
支持的后端与格式对应关系见 config.ini.example 的注释:
| 扩展名 | 文件系统 | 后端 | 备注 |
|---|---|---|---|
.ffpkg |
UFS | LVD 或 MD | 推荐格式 |
.exfat |
exFAT | LVD 或 MD | 兼容/外盘风格游戏用 |
.ffpfs / .ffpfsc |
PFS | LVD | 实验性 |
LVD 与 MD:两大挂载后端设备有什么区别
LVD 后端(/dev/lvdctl → /dev/lvdN)
LVD 是 LUN Virtual Device 的缩写,也是 ShadowMountPlus 所有格式的默认后端。它的 attach 流程(见 attach_lvd_backend_as)大致是:
- 打开控制设备
/dev/lvdctl; - 构造一个单层(V0)attach 请求,声明源文件路径、设备大小、逻辑扇区大小(
sector_size)、映射单元(secondary_unit)与图像类型(image_type); - 通过
SCE_LVD_IOC_ATTACH_V0ioctl 提交,内核返回一个设备单元号,生成/dev/lvdN节点; - ShadowMount 把
/dev/lvdN挂载到/mnt/shadowmnt/<image>_<hash>。
LVD 的优势在于图像类型(image type)丰富:内核提供 Dfl、Sv、Trp、Dwl、AcI/AcO 等类型,不同类型对应不同的 I/O 分发策略。这正是后文 BFS 快速路径能存在的前提——完整类型与标志定义见 sm_mount_defs.h。
MD 后端(/dev/mdctl → /dev/mdN)
MD 是通用磁盘镜像(MDISC)后端,attach 时固定使用 AUTOUNIT | ASYNC(可选 MDONLY/MD_READONLY)选项,逻辑扇区可配置(exFAT 默认 512 字节,UFS 默认 4096 字节,见 get_md_attach_options)。它把镜像当作传统"虚拟磁盘"直通读写,实现简单、兼容性好,但没有 LVD 的图像类型机制,因此无法走 BFS sdimg 批量路径。
如何选择:一张表看懂
| 对比项 | LVD | MD |
|---|---|---|
| 控制设备 | /dev/lvdctl |
/dev/mdctl |
| 生成的设备 | /dev/lvdN |
/dev/mdN |
| 图像类型 | 支持(0~12,如 Sv、Dwl) | 不支持 |
| BFS sdimg 批量加速 | ✅(type 5 + 条件满足时) | ❌ |
| 适用场景 | 默认、追求最大吞吐 | 兼容性回退 |
设备单元的生命周期管理(attach 后跟踪节点、detach 后确认释放、防止单元号被复用误删)由 detach_attached_unit / wait_for_attached_unit_release 一族函数完成;启动时还会等待系统保留的 /dev/lvd2 释放后再开始自己的挂载,见 wait_for_lvd_release。
BFS 快速路径:LVD type-5 的批量 I/O 加速机制
它到底加速了什么
PS5 内盘文件系统是 BFS。当 .exfat 镜像直接存放在内盘 BFS 上、且 LVD attach 使用 img_type=5 (Sv) 时,内核的 LVD 工作线程(lvd_worker)会启用 BFS sdimg 批量路径(bfs_iosession_rw_sdimg/BfsSdimg):
- 只接收长度恰好 64 KiB、且源文件偏移 64 KiB 对齐的请求;
- 将首个请求与队列中最多 30 个同类请求合并(共 31 个)一次性提交给 BFS;
- 不符合条件的请求(元数据、小 I/O、未对齐 I/O)自动回落到常规 vnode 路径,不会报错。
简单说:这是块 I/O 批处理(batching),减少大量小请求的内核开销,对顺序读取游戏资源的场景收益最大。注意它不是 exFAT 缓存也不是解压加速——sm_mount_defs.h 中对这条路径的注释写得非常明确。
开启 BFS 快速路径的完整条件清单
以下条件缺一不可(摘自 README 的 "LVD type-5 / BFS fast-path requirements"):
| # | 条件 | 说明 |
|---|---|---|
| 1 | exfat_backend=lvd |
默认值;MD 后端没有 type-5 与 BFS 批处理 |
| 2 | 镜像位于内盘 /data/... 或 /user/... |
外盘/USB/UFS/exFAT/PFS 上的源文件走普通路径 |
| 3 | exFAT 以 64 KiB 分配单元格式化 | 小簇会明显掉速,官方脚本已固定 64 KiB |
| 4 | lvd_exfat_sector_size 保持默认 512 |
512 是逻辑扇区;65536 是 exFAT 簇与 LVD secondary_unit,两者别混淆 |
| 5 | 镜像大小是 64 KiB 的整数倍 | 官方镜像脚本自动按 1 MiB 向上取整 |
| 6 | 建议整段顺序拷贝进 BFS | 非硬性条件,但可减少支撑文件碎片化 |
如何验证快速路径是否生效
开启 debug=1(默认开启)后,观察 /data/shadowmount/debug.log。attach 请求日志中若出现:
[IMG][LVD] attach try: ver=0 sec=512 sec2=65536 ... img=5
即表示 img=5 sec=512 sec2=65536(type 5 + 512 字节逻辑扇区 + 64 KiB 映射单元)的优化画像已生效,最终是否启用批量仍由内核做平台与存储模式检查。相关调试输出在 attach_lvd_backend_as 中。
关键配置参数速查(sector_size 与 secondary_unit)
这两个几何参数是理解挂载性能的钥匙(定义见 sm_mount_defs.h):
| 参数 | 默认值 | 含义 |
|---|---|---|
sector_size(逻辑扇区) |
exFAT 512 / UFS、PFS 4096 | 由 /dev/lvdN 导出,控制 BIO 对齐,不是文件系统分配块 |
secondary_unit(映射单元) |
优化画像固定 64 KiB | LVD 映射/切分粒度;type-5 BFS 路径要求恰为 64 KiB |
lvd_exfat_sector_size |
512 | BFS 快速路径下不要改成 65536 |
lvd_ufs_sector_size |
4096 | UFS 逻辑扇区 |
md_exfat_sector_size / md_ufs_sector_size |
512 / 4096 | MD 后端逻辑扇区 |
各格式对应的 LVD 优化画像(仅当源路径在 /data 或 /user 下):
| 镜像 | image_type | 说明 |
|---|---|---|
.exfat |
5(Sv) | direct + BFS sdimg 批处理 |
.ffpkg(UFS) |
5(Sv) | direct + BFS sdimg 批处理 |
独立 .ffpfs |
5(Sv) | direct |
外层 .ffpfsc |
9(AcO) | 分层包外层 |
嵌套 .ffpfs |
8(AcI) | 分层包内层 |
其他路径(外盘等)回退到 1.6 兼容画像:exFAT 用 type 0、UFS 用 type 7(Download Data,偏 HDD 队列隔离),见 get_lvd_image_type。
常见误区排查清单
- 把 65536 当成逻辑扇区去设置:
image_sector=xxx.exfat:65536不会开启快速路径,反而会破坏对齐。65536 只属于 exFAT 分配单元与 LVDsecondary_unit。 - 用了 MD 后端还期望加速:
/dev/mdctl没有图像类型,BFS sdimg 批处理对 MD 完全不可用。 - 镜像放在外置存储:快速路径只认内盘 BFS 上的普通文件;放在 USB/UFS/exFAT/PFS 或压缩 PFS 容器内的 exFAT 镜像走普通路径(速度本身也受外盘限制)。
- 用小簇手工制作了 exFAT 镜像:请用官方脚本 mkexfat.sh(Linux)、mkexfat_macos.sh(macOS)或 make_image.bat(Windows),它们固定 64 KiB 分配单元并自动计算镜像大小。
- 挂载失败后设备未释放:新版对异步 LVD/MD detach 做了状态跟踪(节点身份 + 单元号),避免误删被复用的设备单元,机制见 sm_mount_device.c。
相关源码与配置文件索引
- 挂载画像与 LVD 几何定义:include/sm_mount_defs.h
- LVD/MD attach 与画像选择:src/sm_image.c
- 设备节点等待、detach 与单元复用防护:src/sm_mount_device.c、include/sm_mount_device.h
- 后端与扇区配置模板(含快速路径注释):config.ini.example
- 快速路径要求原文:README
- 1.7 版本挂载画像更新说明:RELEASE_NOTES_1.7.md
总结
ShadowMountPlus 的 I/O 加速不是玄学,而是一条清晰的链路:LVD type-5 + 64 KiB secondary_unit + 内盘 BFS 上的 64 KiB 簇 exFAT 镜像,三者齐备时内核把 31 个对齐的 64 KiB 请求批量提交给 BFS。保持默认 exfat_backend=lvd 与 lvd_exfat_sector_size=512,用官方脚本制作镜像,再在 debug.log 里确认 img=5 sec=512 sec2=65536,你就获得了内盘镜像挂载的最大吞吐。🚀