A20OS 文件系统一致性模型¶
本文档规范 A20OS 文件系统层的一致性模型、事务语义与故障恢复保证。
A20OS 采用统一的 VFS 架构驱动多类存储后端,涵盖磁盘文件系统(FAT32、ext4)、只读存储(ISO9660、NTFS 只读解析)、内存文件系统(RAMFS、tmpfs)与伪文件系统(procfs、sysfs、devfs)。本文梳理各后端在元数据操作、数据写入、同步(fsync/fdatasync)以及崩溃恢复场景下的行为保证与语义边界。
1. 范围¶
覆盖的后端:
kernel/fs/diskfs/fat32.c:FAT32 块设备文件系统kernel/fs/diskfs/ext4.c:ext4 块设备文件系统kernel/fs/diskfs/ramfs.c:内存文件系统(rootfs、/dev/shm、tmpfs)kernel/fs/devfs/devfs.c:设备特殊文件树(/dev)kernel/fs/procfs/procfs.c:进程 / 合成文件树(/proc)kernel/fs/sysfs.c:系统对象树(/sys)kernel/fs/pipe.c:匿名 pipe 实现kernel/fs/anonfd.c:匿名 fd 安装 helper
覆盖的 VFS 横切行为:
- permission 检查(
kernel/fs/vfs/stat_perm.c、kernel/fs/vfs.c) - path resolution(
kernel/fs/vfs/path_resolution.c) - mount-point 处理(
kernel/fs/vfs/mount_ops.c、kernel/fs/vfs/mount.c) - dcache invalidation(
kernel/fs/vfs/dcache.c) - xattr 存储(
kernel/fs/xattr.c)
2. 图例¶
| 列 | 含义 |
|---|---|
| Op | VFS vnode 操作或高层 syscall 行为 |
| Support | 只描述当前代码路径,不编码测试结论;具体取值见下表 |
| Errno | 不支持或错误路径返回的 errno(来自代码,不是意图) |
| Ordering / Atomicity | 当前代码实际提供的保证 |
| Linux ABI gap | 测试必须编码的 Linux 差异 |
| Support 值 | 含义 |
|---|---|
Y |
对应实现路径存在;不表示已在任一架构、后端组合或崩溃场景运行验证 |
partial |
只实现操作的子集,或实现带有说明栏列出的功能/持久化限制 |
N |
当前不支持;Errno 栏记录实际拒绝结果 |
- |
对该后端或对象不适用 |
3. 各后端矩阵¶
3.1 FAT32(kernel/fs/diskfs/fat32.c)¶
FAT32 从 virtio-blk block cache 挂载。superblock 由 fat32_sb_t.lock 保护。per-inode metadata(mode、uid、gid)保存在按 cluster number 索引的全局 RAM 表 g_fat32_meta 中(fat32.c)。
| Op | Support | Errno | 说明 / 代码引用 |
|---|---|---|---|
| lookup | Y | — | fat32_lookup(fat32_vn.c)。支持 . 和 ..。大小写不敏感的 8.3 + LFN。 |
| create | Y | — | fat32_vn_create(fat32_vn.c)。分配一个 cluster,写入 8.3 short entry。 |
| mkdir | Y | — | fat32_vn_mkdir(fat32_vn.c)。创建 ./.. entry。 |
| unlink | Y | — | fat32_vn_unlink(fat32_vn.c)。释放 cluster chain。目录返回 -EISDIR。 |
| rmdir | Y | — | fat32_vn_rmdir(fat32_vn.c)。检查 fat32_dir_is_empty(统计 active entry > 2)。 |
| rename | Y | — | fat32_vn_rename(fat32_vn.c)。创建新目录项并删除旧项;移动目录时改写其 .. entry。支持 RENAME_NOREPLACE;替换目标。 |
| link | N | -ENOSYS |
g_fat32_vnode_ops 中没有 .link op。vfs_link 返回 -ENOSYS(kernel/fs/vfs.c)。 |
| symlink | N | -ENOSYS |
没有 .symlink/.readlink ops。vfs_symlink 返回 -ENOSYS(kernel/fs/vfs.c)。 |
| readlink | N | -EINVAL |
symlink vnode 不可能存在;vfs_readlinkat 返回 -EINVAL(kernel/fs/vfs.c)。 |
| stat | Y | — | fat32_stat(fat32_vn.c)。st_nlink 硬编码为 1。st_blocks 按 512 向上取整。 |
| truncate | Y | — | fat32_vn_truncate(fat32_vn.c)。size 0 会重新分配单个 cluster。 |
| chmod | Y | — | fat32_vn_chmod(fat32_vn.c)。只存储在 RAM meta table 中。 |
| chown | Y | — | fat32_vn_chown(fat32_vn.c)。只存储在 RAM meta table 中;清除 suid/sgid bit。 |
| read/write/lseek | Y | — | g_fat32_fops(fat32_file.c)。每次 open 有一个带 cluster cache 的 fat32_fctx_t。 |
| readdir | Y | — | fat32_freaddir(fat32_file.c)。返回 DT_DIR/DT_REG;无 DT_LNK。 |
| ioctl | N | -ENOTTY |
.ioctl 为 NULL;vfs_ioctl 落到 -ENOTTY。 |
| fsync | partial | — | vfs_fsync 同步共享脏映射、vnode page cache 和 mount block cache(kernel/fs/vfs/file.c),但 FAT32 没有显式 inode log。 |
| xattr | partial | — | 无 FAT32 后端 hook;reg/dir 的值由全局 (mnt, ino) RAM 表提供,unmount/reboot 后丢失。 |
FAT32 的顺序保证:
- 整个文件系统由
sb->lock串行化(fat32.c)。 - 目录项更新和 FAT 更新之间不是原子的。unlink 先把目录项标记为删除,再立即释放 cluster chain,或在 vnode 仍被引用时把释放推迟到最后一个引用消失;如果在目录项删除后、chain 释放前崩溃,已不可达的 cluster 可能泄漏。
- 文件大小只在 close 时写回目录项(
fat32_fclose,fat32_file.c)。close 前断电会丢失 size。 - block cache 是 write-back;
vfs_fsync和 unmount(fat32_unmount,fat32.c)会调用bcache_sync。
FAT32 相对 Linux ABI 的缺口:
- 没有 hard link 或 symbolic link(rename 已实现)。
- 文件 ownership/mode 是易失的(只存在 RAM)。
- 没有 atime/mtime/ctime 持久化;没有对应 RAM time-meta 时,
vfs_vnode_stat回退为当前时间(kernel/fs/vfs/stat_perm.c)。 st_nlink总是 1。- 没有 xattr 持久化。
3.2 ext4(kernel/fs/diskfs/ext4.c)¶
ext4 从 block cache 挂载,并使用强引用 vnode cache:同一 (superblock, inode) 在 cache 中只有一个 live vnode,cache 自身持有引用,lookup 命中时为调用者再取引用。unlink/rmdir/rename-remove 会先把 victim 移出 cache 并标记 unlinked,最后一个外部引用释放后才回收 inode 数据;cache prune 与 unmount 负责释放仍由 cache 独占的引用。
| Op | Support | Errno | 说明 / 代码引用 |
|---|---|---|---|
| lookup | Y | — | ext4_lookup(ext4_namei.c)。支持 ./..。 |
| create | Y | — | ext4_vn_create(ext4_namei.c)。分配 inode,写入目录项。 |
| mkdir | Y | — | ext4_vn_mkdir(ext4_namei.c)。为 ./.. 分配一个 block。 |
| unlink | Y | — | ext4_vn_unlink(ext4_namei.c)。目录以 -EISDIR 拒绝。 |
| rmdir | Y | — | ext4_vn_rmdir(ext4_namei.c)。检查除 ./.. 外为空。 |
| rename | Y | — | ext4_vn_rename(ext4_namei.c)。支持普通替换、RENAME_NOREPLACE 与 RENAME_EXCHANGE。 |
| link | Y | — | ext4_vn_link(ext4_namei.c)。递增 i_links_count;拒绝目录;失败时回滚。 |
| symlink | Y | — | ext4_vn_symlink(ext4_namei.c)。只支持 fast symlink(target <= 60 bytes)。 |
| readlink | Y | — | ext4_readlink(ext4_namei.c)。从 i_block 读取最多 60 字节。 |
| stat | Y | — | ext4_stat(ext4_namei.c)。st_nlink 来自 i_links_count。 |
| truncate | Y | — | ext4_vn_truncate(ext4.c)。零大小截断全部 block;非零大小释放 EOF 之后的 block(collect-rebuild / 间接块裁剪)。支持 64 位文件大小(i_size_high)。 |
| chmod | Y | — | ext4_vn_chmod(ext4_namei.c)。将 i_mode 写到磁盘。 |
| chown | Y | — | ext4_vn_chown(ext4_namei.c)。写入 i_uid/i_gid;清除 suid/sgid。 |
| read/write/lseek | Y | — | g_ext4_fops(ext4_file.c)。 |
| readdir | Y | — | ext4_freaddir(ext4_file.c)。返回 DT_DIR/DT_REG/DT_LNK。 |
| ioctl | N | -ENOTTY |
.ioctl 为 NULL。 |
| fsync | Y | — | 同步共享脏映射与 vnode page cache,再定点刷出该文件的数据、inode 和相关分配元数据;超出定点收集范围时回退为整个 mount 的 block-cache sync。运行时 mutation 全部经 ext4_journal_meta_write 记入 JBD2 事务,sync()/fsync() 触发 commit(ordered 语义:数据先落盘,日志副本后写,commit block 最后),因此具备 ext4 ordered/journal 的断电原子性。 |
| xattr | partial | — | 无 ext4 xattr 后端 hook;reg/dir/lnk 的值只进入全局 RAM 表。 |
顺序保证(ext4):
- inode/block allocation 由
alloc_lock保护,namespace mutation 由metadata_lock串行。每次 metadata 写入都经ext4_journal_meta_write:写入 block cache 的同时登记事务覆盖的物理块并bcache_hold_page持有该页,使任何通用 sync 都无法在日志副本之前把它写出去。 - commit 顺序(
ext4_journal_commit):先bcache_sync_checked落数据 → 置EXT4_FEATURE_INCOMPAT_RECOVER→ 写 descriptor → 写各数据块 → 写 journal superblock 的s_start→ 最后写 commit block →bcache_release_holds+bcache_sync_held落元数据 → 日志置空并清 recover 标志。commit block 之前崩溃则整个事务被丢弃,之后崩溃则下个 mount 必须重放。 - 挂载时是否重放不看
EXT4_FEATURE_INCOMPAT_RECOVER一个信号:该位与 superblock 的 free 计数共享同一个 cache page,而该页被打开的事务持有,因此崩溃可能丢掉这个位却留下非空日志。ext4_journal_log_pending()直接读 journal superblock 的s_start,这才是权威判据。 - 数据块的 checksum 记在 descriptor 的 tag 里,不写进块本身最后 4 字节——那 4 个字节属于文件系统(block bitmap 的校验覆盖它们),把 journal checksum 写进去会在重放时污染 bitmap 并使其与 group descriptor 里的
bg_block_bitmap_csum不一致。 - 普通
ext4_vn_rename通过一组目录项更新完成,RENAME_EXCHANGE交换两侧 inode;这些更新全部落在同一个 journal 事务里,因此断电原子性等同 Linux ext4 的 ordered 模式。 vfs_fsync会先同步共享脏映射和 vnode page cache;ext4 的sync_vnode随后用bcache_sync_scoped刷出文件数据、inode table、bitmap、group descriptor 和 superblock 页,深层 extent 或定点数组不足时回退为整个 mount sync(kernel/fs/vfs/file.c、kernel/fs/diskfs/ext4_sync.c)。
日志模式契约(ext4_journal.c):
- 实现的只有 ordered 元数据日志:数据块在 descriptor 之前落盘,元数据经 journal 提交。可写挂载下没有第二种数据模式。
- revoke 记录**已实现**:descriptor 里的
JBD2_REVOKE_BLOCK记录按 sequence 收集,重放时跳过被撤销的块(否则重放会把已释放的块写回去)。 - 明确**不支持**并在挂载时拒绝的选项:
data=journal、data=writeback、journal_async_commit、journal_checksum(v2)、barrier=0、nobarrier、fast_commit、journal_dev。这些选项改变的是日志语义本身,静默忽略等于对外宣称实现了没有实现的模式;ext4_validate_mount_options()在设备打开后、任何写入前返回-EOPNOTSUPP。 - 日志 superblock 侧同样只接受
REVOKE | 64BIT | CSUM_V3+ crc32c;async_commit(0x4) 与fast_commit(0x20) 的镜像在jbd2_load_superblock()就被拒绝,不会进入重放。 - 崩溃注入覆盖的就是这个已实现的模式:
make smoke-ext4-journal在 recover-flag / journal / commit / checkpoint 四个点各崩溃一次,断言承诺过的写入存活、未承诺的不出现、恢复前后e2fsck -fn都干净。data=journal之类的模式不在契约内,因此没有、也不声称有对应用例。
完整性边界(有意的,不是待办):ext4 的 on-disk 格式没有 per-file 数据块校验和,Linux 的 ext4 也没有。本驱动校验的是**元数据**(metadata_csum:superblock、group descriptor、bitmap、inode)和**日志记录**(JBD2 csum_v3),文件内容本身不做校验。要检测静默数据损坏需要另一种兼容机制(例如 fs-verity 的 Merkle 树,一种只读文件的独立特性),或换用支持数据校验和的文件系统;为了"有数据校验和"而往 ext4 镜像里塞私有字段会造出 e2fsprogs 读不了的格式,因此不做。e2fsck -fn 能发现元数据不一致,但发现不了文件内容里被翻转的字节。
ext4 相对 Linux ABI 的缺口:
- 只支持 fast symlink;更长 target 返回
-ENAMETOOLONG(ext4.c)。 - hard link 已实现;
st_nlink来自i_links_count(unlink 递减,link 递增)。 - 挂载时对带 journal 的镜像执行 JBD2 recovery(
EXT4_FEATURE_INCOMPAT_RECOVER已在unsupported_incompat中显式排除,ext4_journal_recover在挂载时运行),recovery 失败则 fail closed 拒绝挂载。日志非空而 recover 标志丢失时同样进入 recovery。 - 支持的 JBD2 校验和格式是 v3 +
INCOMPAT_64BIT(与 mke2fs 默认一致)。更旧的 v1/v2 日志**不支持重放或写入**:干净的 v1/v2 镜像可以被**只读**挂载,走的是一条显式降级路径(日志打印clean legacy checksum journal; explicit read-only downgrade),日志非空的旧格式镜像连只读挂载都拒绝。判定逻辑在user/svc/jbd2_legacy_policy.rs;内核构建不链接该 crate,因此kernel/fs/diskfs/ext4_journal.c里有一份等价实现,两边的条件必须同步。门禁是make smoke-ext4-legacy-journal。 - 无日志镜像(
^has_journal)没有重放路径,但崩溃后仍然可以挂载:s_state缺VALID_FS且没有ERROR_FS时,挂载先跑孤儿 recovery 把被打断的 unlink 做完再发布。带ERROR_FS的镜像仍然拒绝——那表示驱动在上一会话里发现过不可信元数据,挂载期恢复修不了。门禁是make smoke-ext4-recovery(open+unlink → kill → 重启同一张镜像 → inode 被回收、e2fsck -fn干净)。 - 崩溃一致性由
make smoke-ext4-journal把守:四个注入点各做一次崩溃—重启往返,断言承诺过的写入没丢、没承诺的写入没回来,并在宿主机上用e2fsck -fn检查崩溃后的镜像和恢复后的镜像都干净。 - xattr 持久化只做 in-inode:
user.*、system.posix_acl_access、system.posix_acl_default存放在 256 字节 inode 的尾部(i_extra_isize取 mke2fs 的 32,magic 在128+extra处),布局与 e2fsprogs 一致,debugfs ea_list和e2fsck -fn都接受。一个 inode 的属性区约 90 字节;放不下时setxattr返回ENOSPC,且不改动已有属性(每次修改都在内存里重建整块属性区再一次性写回,失败不留半写)。没有外部 EA 块(i_file_acl),所以属性总量超过 inode 尾部空间的文件会失败,而不是换块存储。trusted.*/security.*仍走 VFS 的易失表。ACL 只做存储与读回,不做权限判定。 - mount 时做 fail-closed feature 检查:不支持的 incompat 特性(meta_bg、bigalloc、inline_data、casefold、encryption、MMP)会拒绝挂载,而不是静默误读镜像。
3.3 NTFS(kernel/fs/diskfs/ntfs.c)¶
NTFS 从 block cache 挂载,直接解析 MFT(master file table)记录,支持 $I30 目录索引(index root + index allocation block)。ntfs_sb_t 由 ntfs_lock 保护。
| Op | Support | Errno | 说明 / 代码引用 |
|---|---|---|---|
| lookup | Y | — | ntfs_lookup(ntfs_namei.c)。通过 ntfs_read_directory 枚举 $I30 索引。 |
| create | Y | — | ntfs_vn_create。构建 FILE record($STANDARD_INFORMATION/$FILE_NAME/$DATA)并插入父目录索引。 |
| mkdir | Y | — | 创建带 $INDEX_ROOT 的空目录 record。 |
| unlink | Y | — | ntfs_vn_unlink(ntfs_namei.c)。从索引移除,释放数据 cluster 与 MFT record。 |
| rmdir | Y | — | ntfs_vn_rmdir(ntfs_namei.c)。目录必须为空。 |
| rename | Y | — | ntfs_vn_rename。移除旧索引项,改写子 record 的 $FILE_NAME(新 parent ref + 新 name),插入新索引项;失败回滚。 |
| link | N | -ENOSYS |
无 .link op。 |
| symlink | N | -ENOSYS |
无 .symlink/.readlink ops。 |
| stat | Y | — | ntfs_stat(ntfs_namei.c)。st_nlink 为 1。 |
| statfs | Y | — | ntfs_statfs(ntfs_namei.c)。f_bfree 是估算值(total/2)。 |
| truncate | Y | — | ntfs_vn_truncate(ntfs.c)。resident 数据就地收缩,或裁剪非 resident run。 |
| read/write/lseek | Y | — | g_ntfs_fops。支持 resident 与 non-resident(runlist 编码)数据。 |
| readdir | Y | — | ntfs_freaddir。从 $I30 索引枚举。 |
| ioctl | N | -ENOTTY |
无 .ioctl op。 |
NTFS 的顺序保证:
- 所有 mutation 在
ntfs_lock下串行化。 - rename 在改写
$FILE_NAME后、插入新索引项前,若失败会恢复旧索引项,避免名字丢失。 - 无
$LogFile/$MFTMirr处理;崩溃一致性不保证。 - 压缩/加密属性被拒绝(
ntfs.c);$ATTRIBUTE_LIST(跨 record 属性)不支持。
NTFS 相对 Linux ABI 的缺口:
- 没有 hard link、symbolic link 或 rename 之外的名字操作。
- 索引插入只支持 root 或既有 allocation block 内追加,索引满时返回
-ENOSPC(无 B-tree split)。 $MFTbitmap 不维护;通过扫描 MFT record 的 in-use flag 找空闲记录。- 非 ASCII 文件名变成
?。
3.4 ISO9660(kernel/fs/diskfs/isofs.c)¶
ISO9660 是只读 CD-ROM 文件系统,从 block cache 挂载。在逻辑块 16 处扫描主卷描述符(PVD),按逻辑块大小(512–4096)读取目录记录;文件数据直接按 extent × block_size + 偏移从 block cache 读取。
| Op | Support | Errno | 说明 / 代码引用 |
|---|---|---|---|
| lookup | Y | — | isofs_lookup。名字转小写、去 ;1 版本。 |
| create/mkdir/unlink/rmdir/rename/link/symlink | N | -EROFS |
只读挂载;VFS 在 vfs_vnode_permission 对 W_OK 返回 -EROFS。 |
| stat | Y | — | isofs_stat。st_blksize=2048。 |
| statfs | Y | — | isofs_statfs。f_type=0x9660。 |
| read/lseek | Y | — | g_isofs_fops。只读取 walker 最终选中的单个 extent,不聚合 multi-extent 记录。 |
| readdir | Y | — | isofs_freaddir。返回 DT_DIR/DT_REG;multi-extent 名字只由最终未置 continuation flag 的记录暴露。 |
| ioctl | N | -ENOTTY |
无 .ioctl op。 |
ISO9660 的顺序保证:
- 目录记录可跨块边界(
isofs_read_dirent处理跨块组装)。 - multi-extent walker 跳过所有设置
0x80continuation flag 的记录,并把最后一个未设置该 flag 的记录当作普通文件条目。因此当前实际暴露的是最终 extent,而不是首 extent;前面的 extent 不可见,也没有聚合读取,不能描述为“读首 extent 后返回垃圾”。 - 名字总是转成小写(ISO 原为大写 8.3 风格);
;1版本号被剥离。
ISO9660 相对 Linux ABI 的缺口:
- 没有 Rock Ridge(长名字、symlink、POSIX 权限)。
- 没有 Joliet(补充卷描述符未解析)。
- 只读;所有 mutation 返回
-EROFS。
3.5 ramfs(kernel/fs/diskfs/ramfs.c)¶
ramfs 是 root filesystem,也是 /dev/shm 和显式 tmpfs/ramfs mount 的后端。它使用单个全局 inode table,每个目录有固定的 RAMFS_MAX_INODES(4096)和 RAMFS_MAX_DIR_ENTRIES(256)上限。
| Op | Support | Errno | 说明 / 代码引用 |
|---|---|---|---|
| lookup | Y | — | ramfs_vnode_lookup(ramfs.c)。 |
| create | Y | — | ramfs_vnode_create(ramfs.c)。 |
| mkdir | Y | — | ramfs_vnode_mkdir(ramfs.c)。 |
| unlink | Y | — | ramfs_vnode_unlink(ramfs.c)。递减 nlink,可能释放。 |
| rmdir | Y | — | ramfs_vnode_rmdir(ramfs.c)。empty 检查统计 active entry > 2。 |
| rename | Y | — | ramfs_vnode_rename(ramfs.c)。仅同一 mount(由 VFS 强制)。 |
| link | Y | — | ramfs_vnode_link(ramfs.c)。拒绝目录。 |
| symlink | Y | — | ramfs_vnode_symlink(ramfs.c)。 |
| readlink | Y | — | ramfs_vnode_readlink(ramfs.c)。 |
| stat | Y | — | ramfs_vnode_stat(ramfs.c)。st_nlink 来自 inode。 |
| truncate | Y | — | ramfs_vnode_truncate(ramfs.c)。 |
| chmod | Y | — | ramfs_vnode_chmod(ramfs.c)。 |
| chown | Y | — | ramfs_vnode_chown(ramfs.c)。 |
| read/write/lseek | Y | — | g_ramfs_fops(ramfs.c)。 |
| readdir | Y | — | ramfs_freaddir(ramfs.c)。 |
| ioctl | N | -ENOTTY |
无 .ioctl op。 |
| fsync | Y(no-op) | — | vfs_fsync 同步 block cache;ramfs 没有 block cache,因此实际为 no-op。 |
| xattr | partial | — | 存储在全局 RAM 表(kernel/fs/xattr.c),重启后丢失。 |
顺序保证(ramfs):
- namespace/inode metadata 由全局
g_ramfs_meta_lock串行,regular-file 内容由每 inode 的data_lock保护;这不是“隐式单线程、无 per-inode lock”模型。 ramfs_vnode_link正确递增nlink(ramfs.c)。ramfs_vnode_unlink递减nlink,并在nlink == 0 && ref_count <= 1时释放 inode(ramfs.c)。
ramfs 相对 Linux ABI 的缺口:
- 每目录 entry 上限为 256(
ramfs.c)。 - 总 inode 上限为 4096(
ramfs.c)。 - 没有持久化;xattr 也只是全局 RAM 状态。
3.6 devfs(kernel/fs/devfs/devfs.c)¶
devfs 是合成设备树。g_nodes 提供编译期静态节点;驱动核心虽注册 char/block/net/input/display/audio 六类 class 设备,但通用动态 devfs 节点只为 char/block/audio 生成 /dev/charN、diskN、audioN。input/display 继续通过静态 /dev/event0 与 /dev/fb0 聚合节点消费,net 没有通用动态 devfs 节点。
| Op | Support | Errno | 说明 / 代码引用 |
|---|---|---|---|
| lookup | Y | — | devfs_lookup。支持 root、misc/、pts/ 目录与 char/block/audio 动态 class 节点。 |
| create | N | -ENOSYS |
无 .create op;带 O_CREAT 的 vfs_open 返回 -ENOSYS。 |
| mkdir | N | -ENOTDIR |
无 .mkdir op;vfs_mkdir 返回 -ENOTDIR。 |
| unlink | N | -ENOTDIR |
无 .unlink op;vfs_unlink 返回 -ENOTDIR。 |
| rmdir | N | -ENOSYS |
无 .rmdir op;vfs_rmdir 返回 -ENOSYS。 |
| rename | N | -ENOSYS |
无 .rename op。 |
| link | N | -ENOSYS |
无 .link op。 |
| symlink | N | -ENOSYS |
无 .symlink op。 |
| stat | Y | — | devfs_stat。报告 S_IFCHR/S_IFBLK/S_IFDIR。 |
| chmod/chown | N | -EPERM |
无 .chmod/.chown ops;vfs_chmod_vnode 返回 -EPERM。 |
| open | Y | — | devfs_open_vnode。分发到 per-device vfile_ops_t。 |
| read/write/ioctl | Y | — | per-kind vfile_ops_t 表。 |
| readdir | Y | — | devfs_dir_readdir。 |
devfs 的顺序保证:内建 g_nodes 是静态表;char/block/audio class device 会通过 class_device_get_nth/get_by_name 动态枚举和引用,节点释放时归还 class-device 引用。不能把整个 devfs 描述为 init 后静态不变,也不能把该动态节点机制外推到 net/input/display。
devfs 的 ABI 缺口:
- 不能创建、删除或 rename 设备节点。
- 不支持
chmod/chown。 - char/block/audio class 设备的节点名由驱动核心按
class_device_get_nth生成(/dev/charN等),节点内容由驱动 probe 决定;net/input/display 不走该通用 devnode 路径,uevent 驱动的动态命名尚未实现。
3.7 procfs(kernel/fs/procfs/procfs.c)¶
procfs 是完全合成的文件系统。entry 在 lookup 和 open 时生成。没有后端 mutation 操作。
| Op | Support | Errno | 说明 / 代码引用 |
|---|---|---|---|
| lookup | Y | — | procfs_lookup(kernel/fs/procfs/procfs.c)。数字 PID 和静态 entry。 |
| create/mkdir/unlink/rmdir/rename/link/symlink | N | -ENOSYS/-ENOTDIR |
g_procfs_vnode_ops 只定义 lookup、readlink、stat、open、release(kernel/fs/procfs/procfs.c)。 |
| stat | Y | — | procfs_stat(kernel/fs/procfs/procfs.c)。 |
| open | Y | — | procfs_open_vnode(kernel/fs/procfs/procfs.c)。分配 procfs_priv_t snapshot。 |
| read | Y | — | procfs_fread(kernel/fs/procfs/procfs.c)。 |
| write | partial | -EINVAL |
只有特定 tunable 接受写入(procfs_fwrite,kernel/fs/procfs/procfs.c)。 |
| lseek | Y | — | procfs_flseek(kernel/fs/procfs/procfs.c)。 |
| readdir | Y | — | procfs_freaddir(kernel/fs/procfs/procfs.c)。 |
| chmod/chown | N | -EPERM |
无后端 hook。 |
procfs 的顺序保证:
- 内容在
open时生成并缓存在procfs_priv_t中;并发 process 状态变化不会在 open 后反映出来。 - 可写 tunable 的同步策略不统一:
pid_max经proc_set_pid_max更新,oom_score_adj和pipe-max-size则直接更新对应字段或全局值。
procfs 相对 Linux ABI 的缺口:
- 许多
/proc/<pid>文件只是占位符,返回空内容或静态内容。 /proc/self/exe和/proc/<pid>/exe/cwd在vfs_readlinkat中作为特殊情况处理(kernel/fs/vfs.c),不是真正的 symlink。- 不允许文件 mutation。
3.8 sysfs(kernel/fs/sysfs.c)¶
sysfs 是合成树。除 /sys/block/loopN/{dev,size,uevent} 与 /sys/class/drm/card0/... 外,当前还按驱动核心的 class registry 动态暴露 /sys/class/{char,block,net,input,display,audio}/<device>/dev。
| Op | Support | Errno | 说明 / 代码引用 |
|---|---|---|---|
| lookup | Y | — | sysfs_lookup(kernel/fs/sysfs.c)。 |
| create/mkdir/unlink/rmdir/rename/link/symlink | N | -ENOSYS/-ENOTDIR |
g_sysfs_vnode_ops 只定义 lookup、stat、open、release(kernel/fs/sysfs.c)。 |
| stat | Y | — | sysfs_stat(kernel/fs/sysfs.c)。 |
| open/read/lseek/readdir | Y | — | g_sysfs_fops(kernel/fs/sysfs.c)。 |
| write | N | -EINVAL |
未注册 .write。 |
| chmod/chown | N | -EPERM |
无后端 hook。 |
sysfs 的顺序保证:
- 内容在 lookup/open/readdir 时由静态视图和动态 class-device registry 合成;动态节点持有 class-device 引用。
- sysfs 本身不提供用户 mutation op,但底层 class registry 可随驱动 bind/remove 改变。
sysfs 相对 Linux ABI 的缺口:
- 视图仍远小于 Linux sysfs;动态 class 只提供设备名与
dev等最小属性,不是完整 kobject/uevent 层级。 - 没有 writable attribute,也没有 uevent write。
3.9 pipe(kernel/fs/pipe.c)¶
pipe 不是挂载文件系统。它创建一对共享 pipe_buf_t 环形缓冲区的 vfile_t 对象。
| Op | Support | Errno | 说明 / 代码引用 |
|---|---|---|---|
| create (pipe2) | Y | — | pipe_create(kernel/fs/pipe.c)。分配环形缓冲区和两个全局 fd。 |
| read | Y | — | pipe_read(kernel/fs/pipe.c)。除非 O_NONBLOCK,否则阻塞。 |
| write | Y | — | pipe_write(kernel/fs/pipe.c)。不超过 PIPE_BUF_SIZE(4096)字节的写入具备原子性;更大写入可能交错。 |
| poll | Y | — | pipe_poll_events(kernel/fs/pipe.c)。 |
| set_size | Y | — | pipe_set_size(kernel/fs/pipe.c),在 vfs_fcntl 中受 CAP_SYS_RESOURCE 限制。 |
| lseek | N | -ESPIPE |
无 .lseek op;vfs_lseek 返回 -ESPIPE。 |
pipe 的顺序保证:
PIPE_BUF_SIZE(4096)字节或更少的写入相互之间是原子的(kernel/fs/pipe.c);复制整个 chunk 时持有 spinlock。- 大于
PIPE_BUF_SIZE的写入会被拆分,可能与其他 writer 交错。 read/write在 wait queue 上阻塞,并通过pipe_wake_readers/pipe_wake_writers唤醒所有对应 waiter(kernel/fs/pipe.c)。- 关闭最后一个 reader 会唤醒 writer;后续或已阻塞的 write 检测到该状态后向当前 task 发送
SIGPIPE并返回-EPIPE(kernel/fs/pipe.c)。
pipe 的 ABI 缺口:
- 内核
PIPE_BUF_SIZE定义于kernel/include/core/consts.h,值为 4096,与 Linux ABI 的PIPE_BUF预期一致。 F_SETPIPE_SZ对非特权 task 的容量限制硬编码为 1 MiB(kernel/fs/vfs.c)。
3.10 anonfd(kernel/fs/anonfd.c)¶
anonfd 是把匿名 vfile 安装到当前 fd table 的 helper。它不是文件系统,没有 path 语义。
| Op | Support | Errno | 说明 / 代码引用 |
|---|---|---|---|
| install | Y | — | anonfd_install_vfile(kernel/fs/anonfd.c)。 |
| close | Y | — | 通过 anonfd_free_priv_close 释放 vf->priv(kernel/fs/anonfd.c)。 |
anonfd 的顺序保证:install 和 close 相对于调用 task 的 fdtable 是单线程的。
anonfd 的 ABI 缺口:按设计没有缺口;它是内部 helper,不是 Linux ABI 表面。
4. VFS 横切行为¶
4.1 Permission 模型¶
vfs_vnode_permission使用当前 task 的fsuid/fsgid调用vfs_mode_has_perm_ids(kernel/fs/vfs/stat_perm.c)。CAP_DAC_OVERRIDE绕过 read/write,但仍拒绝对没有 execute bit 的 regular file 执行(kernel/fs/vfs/stat_perm.c)。- 不带
AT_EACCESS的access()/faccessat()使用 real uid/gid,且不使用 capability(vfs_mode_has_perm_ids_nocap,kernel/fs/vfs/stat_perm.c)。 vfs_chmod_vnode要求所有权或CAP_FOWNER(kernel/fs/vfs_stat.c)。vfs_chown_vnode要求CAP_CHOWN或满足受限 ownership 规则(kernel/fs/vfs_stat.c)。- sticky-bit 删除检查在
vfs_sticky_may_remove中应用(kernel/fs/vfs/stat_perm.c)。
4.2 Path resolution¶
vnode_lookup_path按当前 task 的root_path、起始 dirfd 与 resolve context 解析路径。- walk 期间按 flag 跟随 symlink,深度限制为
MAX_SYMLINKS(40)。 - mount root 的
..通过 mount 表回到覆盖点的父目录;RESOLVE_NO_XDEV会拒绝该跨越,chroot/IN_ROOT边界仍优先约束逃逸。 - 名称长度 >=
MAX_NAME_LEN返回-ENAMETOOLONG(kernel/fs/vfs/path_resolution.c)。 vfs_resolve_no_follow_final解析父目录,并在不跟随最终 component 的情况下 lookup 它(kernel/fs/vfs.c)。
4.3 Mount 操作¶
vfs_mount支持tmpfs/ramfs、cgroup/cgroup2、proc、sysfs、devtmpfs/devfs,以及fat32/vfat/ext4/ntfs/isofs/iso9660的块设备 mount(kernel/fs/vfs/mount_ops.c)。- 当块设备 mount 的 fstype 为空时,
mount_block_dev_idx先尝试ext4,再尝试vfat(kernel/fs/vfs/mount_ops.c)。 vfs_umount按 normalized path 匹配;FAT32、ext4、NTFS 和 ISO9660 会调用各自的 unmount helper,然后移除 mount(kernel/fs/vfs/mount_ops.c)。vfs_rename_flags用-EXDEV拒绝 cross-mount rename(kernel/fs/vfs.c)。
4.4 Dcache¶
- dcache 只对 ramfs、FAT32、ext4 启用;它是 2048 项、512 个 hash bucket、64 把 bucket lock 的 lookup 优化层,不是权威 namespace。
RESOLVE_CACHED通过 dcache 命中检查实现:任意组件未缓存即返回-EAGAIN,由调用方去 flag 重试。 - create、unlink、rmdir、rename、link、symlink 等路径多数按
(parent, name)定点失效;mount/umount、部分全局状态变更和无法安全定点的情况仍调用vfs_dcache_invalidate_all。
4.5 xattr¶
- xattr 存储在按
(mnt, ino)索引的 1024 项全局 RAM 表g_xattrs中(kernel/fs/xattr.c)。 - 遵守
XATTR_CREATE和XATTR_REPLACEflag(kernel/fs/xattr.c)。 - name 限制为
XATTR_NAME_MAX_LOCAL;value 限制为XATTR_VALUE_MAX_LOCAL。 - 没有后端特定 xattr hook;FAT32/ext4 的值不会写入磁盘,并会在 unmount/reboot 后丢失。
5. 已知 Linux ABI 缺口(汇总)¶
| 领域 | 当前行为 | 期望的 Linux 行为 |
|---|---|---|
| openat2 resolve flag | NO_XDEV/NO_SYMLINKS/BENEATH/IN_ROOT/CACHED 有实现(CACHED 未命中返回 -EAGAIN,编号 0x20 与 Linux 一致);NO_MAGICLINKS 被接受但未执行检查 |
Linux 编号和可扩展 open_how size 语义 |
| renameat2 flag | VFS 接受 NOREPLACE/EXCHANGE;ramfs/ext4 支持两者,FAT32/NTFS 只支持 NOREPLACE,whiteout 不支持 |
后端一致支持与 overlay whiteout |
| statx | 不是 requested-only:实现总把 STATX_BASIC_STATS 加入 stx_mask 并返回基础元数据,再按请求追加 STATX_BTIME 等可选字段;支持 sync type 子集 |
完整遵守 AT_STATX_*/STATX_* 及字段可用性语义 |
| fchmodat2 | 带 flags 分发到 sys_fchmodat(kernel/abi/linux/syscall_table.def) |
独立 syscall,完整处理 AT_* flag |
| xattr | 只有全局 RAM 表 | 具备 namespace 检查的后端持久化 xattr |
| Symlink loop limit | 40(MAX_SYMLINKS,kernel/include/fs/vfs.h) |
Linux 使用 40(MAX_SYMLINKS) |
Mount-point .. |
已跨到 parent mount,并受 NO_XDEV/root 边界约束 |
仍需更多嵌套 mount/chroot 组合覆盖 |
| chroot | 已实现:root_path 在路径解析中生效(vfs_path_normalize_absolute_with_root,path_resolution.c) |
resolution 必须受 root_path 约束 |
| faccessat2 flag | 支持 AT_EACCESS/AT_SYMLINK_NOFOLLOW/AT_EMPTY_PATH,未支持 bit 返回 -EINVAL(kernel/fs/vfs_stat.c) |
同时严格校验不支持的 bit |
6. 测试影响¶
- 上方矩阵中的每个 unsupported operation 都必须有测试断言精确 errno。
- Cross-mount
rename和link必须返回-EXDEV。 - Permission 测试必须覆盖 real uid/gid(
access)、effective uid/gid(faccessat2(AT_EACCESS))、capability bypass 和 sticky-bit 目录。 - FAT32/ext4 必须有 fsync/truncate/page-cache coherence 测试。
- Pipe 测试必须验证
PIPE_BUF大小写入的原子性和SIGPIPE投递。