ShadowMountPlus 挂载后端深入指南:LVD 与 MD 设备、BFS 快速路径的 I/O 加速机制

原创2026-10-21 14:03:412,262 阅读

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)大致是:

  1. 打开控制设备 /dev/lvdctl;
  2. 构造一个单层(V0)attach 请求,声明源文件路径、设备大小、逻辑扇区大小(sector_size)、映射单元(secondary_unit)与图像类型(image_type);
  3. 通过 SCE_LVD_IOC_ATTACH_V0 ioctl 提交,内核返回一个设备单元号,生成 /dev/lvdN 节点;
  4. 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。

常见误区排查清单

  1. 把 65536 当成逻辑扇区去设置:image_sector=xxx.exfat:65536 不会开启快速路径,反而会破坏对齐。65536 只属于 exFAT 分配单元与 LVD secondary_unit。
  2. 用了 MD 后端还期望加速:/dev/mdctl 没有图像类型,BFS sdimg 批处理对 MD 完全不可用。
  3. 镜像放在外置存储:快速路径只认内盘 BFS 上的普通文件;放在 USB/UFS/exFAT/PFS 或压缩 PFS 容器内的 exFAT 镜像走普通路径(速度本身也受外盘限制)。
  4. 用小簇手工制作了 exFAT 镜像:请用官方脚本 mkexfat.sh(Linux)、mkexfat_macos.sh(macOS)或 make_image.bat(Windows),它们固定 64 KiB 分配单元并自动计算镜像大小。
  5. 挂载失败后设备未释放:新版对异步 LVD/MD detach 做了状态跟踪(节点身份 + 单元号),避免误删被复用的设备单元,机制见 sm_mount_device.c。

相关源码与配置文件索引

总结

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,你就获得了内盘镜像挂载的最大吞吐。🚀

登录后查看全文
ShadowMountPlus