Linux 内核中 IBM JFS 文件系统挂载选项详解：从文档选项表到 fs/jfs 源码实现

本文以 Documentation/admin-guide/jfs.rst 中列出的 JFS（IBM's Journaled File System）全部挂载选项为主线，逐项给出可复制的 mount 用法与默认值，并结合 fs/jfs/ 目录下的参数解析、日志管理器、卷扩展与 TRIM 等源码实现，说明每个选项在挂载、重挂载和数据块释放路径上的实际生效位置，帮助读者在配置 JFS 卷、调整错误处理策略和管理 SSD TRIM 行为时有据可依。

一、JFS 在 Linux 内核中的位置与构建配置

JFS 是 IBM 的日志型文件系统（journaling filesystem）在 Linux 上的移植，内核实现集中在 fs/jfs/ 目录，核心文件包括：

文件	职责
fs/jfs/super.c	挂载/重挂载入口，挂载选项解析与错误处理
fs/jfs/jfs_logmgr.c	日志（journal）管理器
fs/jfs/resize.c	在线卷扩展（resize 选项的实现）
fs/jfs/jfs_discard.c	discard/TRIM 与 FITRIM ioctl 实现
fs/jfs/jfs_mount.c	读/写挂载与超级块状态更新

构建时相关开关定义在 fs/jfs/Kconfig：

• CONFIG_JFS_FS：JFS 文件系统支持（可选模块 m）。它会连带选中 NLS、NLS_UCS2_UTILS、CRC32 等依赖，iocharset 选项依赖的字符集转换即由此提供；文档特别指出 iocharset=utf8 需要内核配置中打开 CONFIG_NLS_UTF8。
• CONFIG_JFS_POSIX_ACL：启用 POSIX ACL，打开后超级块会设置 SB_POSIXACL（见 fs/jfs/super.c#L482-L484）。
• CONFIG_JFS_SECURITY：为 SELinux 等安全模块提供文件安全标签的扩展属性支持。
• CONFIG_JFS_DEBUG：输出额外调试日志，并暴露 jfsloglevel 模块参数。
• CONFIG_JFS_STATISTICS：在 /proc/fs/jfs/ 下暴露运行时统计。

JFS 的磁盘块大小固定为 4KiB：挂载时直接执行 sb_set_blocksize(sb, PSIZE)（fs/jfs/super.c#L491-L495）。这一点与后文 discard 选项"64 块 = 256KiB"的换算直接相关。

二、挂载选项总览

Documentation/admin-guide/jfs.rst 声明 JFS 支持以下挂载选项（(*) 表示默认行为），本文逐项展开：

选项	形式	默认值
iocharset=name	字符串	不转换（等效 iocharset=none）
resize=value	仅重挂载时有效	—
integrity / nointegrity	开关	integrity
errors=continue|remount-ro|panic	枚举	remount-ro
uid=value	数值	不覆盖
gid=value	数值	不覆盖
umask=value	八进制	不覆盖
discard=minlen / nodiscard	开关/数值	nodiscard（默认不启用在线 TRIM）

这些选项在内核中的统一声明是 jfs_param_spec 参数表（fs/jfs/super.c#L220-L237），由通用挂载参数解析框架 fs_parse 分发给 jfs_parse_param() 处理。各选项在 fs/jfs/super.c 中对应的解析分支为 Opt_integrity、Opt_iocharset、Opt_resize、Opt_errors、Opt_uid/gid/umask、Opt_discard/nodiscard/discard_minblk 等。

三、逐项选项详解与源码印证

3.1 iocharset=name：Unicode 到本地字符集的转换

mount -t jfs -o iocharset=utf8 /dev/sdb1 /mnt/data

该选项指定从 Unicode（UTF-16 存储的目录名）转换到用户态可见编码所使用的字符集。默认行为是不转换，iocharset=none 只是显式表达默认行为。

源码层面（fs/jfs/super.c#L273-L288），Opt_iocharset 分支调用 load_nls(param->string) 加载对应 NLS 字符集表；字符串为 none 时直接置空；加载失败会打印 JFS: charset not found 并返回 -EINVAL 导致挂载失败。因此 iocharset=utf8 能否生效，取决于内核是否编译了 UTF-8 的 NLS 支持（CONFIG_NLS_UTF8）——这与文档中的要求一致。字符集表保存在 jfs_sb_info->nls_tab，卸载时由 jfs_put_super() 中的 unload_nls() 释放。

3.2 resize=value：只允许在线扩卷

文档说明：resize 将卷扩展（grow）到 value 个块；JFS 只支持扩卷、不支持缩卷；该选项只在以读写方式重挂载（remount）时有效；不带数值的 resize 关键字会把卷扩展到分区的全部大小。

# 假设 /dev/sdb1 是承载 JFS 卷的分区，已扩到 100G
mount -o remount,rw,resize /dev/sdb1 /mnt/data        # 扩到整个分区
mount -o remount,rw,resize=10485760 /dev/sdb1 /mnt/data  # 扩到指定块数

源码印证了这两条限制：

1. 只允许重挂载。jfs_parse_param() 中 Opt_resize / Opt_resize_nosize 分支首先判断 reconfigure（即 fc->purpose == FS_CONTEXT_FOR_RECONFIGURE），首次挂载时直接返回 -EINVAL（fs/jfs/super.c#L289-L299）；jfs_fill_super() 中还有兜底检查，打印 resize option for remount only（fs/jfs/super.c#L486-L489）。
2. 只允许增长。扩卷入口 jfs_reconfigure() 在确认卷以读写方式挂载后调用 jfs_extendfs()；jfs_extendfs() 开头即比较新旧大小，oldLVSize >= newLVSize 时打印 jfs_extendfs: volume hasn't grown, returning 直接返回（fs/jfs/resize.c#L75-L87），并且 newLVSize 不能超过设备实际块数，否则返回 -EINVAL（fs/jfs/resize.c#L89-L105）。
3. 不带数值时的目标大小。resize 无值时，jfs_reconfigure() 取 sb_bdev_nr_blocks(sb)，即块设备的全部块数作为 newLVSize（fs/jfs/super.c#L390-L394）。

jfs_extendfs() 的注释还给出了扩卷的空间布局模型：卷尾依次划分为文件系统空间、fsck 工作区与（内嵌）日志空间，扩卷时按新的 LVSize 重算日志与 fsck 区大小，再断言新的文件系统空间不小于旧值（fs/jfs/resize.c#L32-L49）。

3.3 integrity 与 nointegrity：是否写日志

• integrity（默认）：元数据变更提交到日志（journal），崩溃后文件系统可回放恢复一致性。
• nointegrity：不写日志。文档指出其主要用途是从备份介质恢复卷时获得更高性能；代价是系统异常崩溃时卷的一致性不再保证。

对应源码实现：

• 选项解析时 integrity 通过 fsparam_flag_no 声明（fs/jfs/super.c#L221），置位/清除 JFS_NOINTEGRITY 标志（0x00000040，定义于 fs/jfs/jfs_filsys.h#L34）。
• 日志打开路径：lmLogOpen() 检查到 JFS_NOINTEGRITY 时改走 open_dummy_log()——即只挂一个空壳日志而不使用真实日志空间（fs/jfs/jfs_logmgr.c#L1056-L1064）。
• 超级块状态处理：updateSuper() 在 JFS_NOINTEGRITY 下对 FM_DIRTY/FM_MOUNT/FM_CLEAN 状态做缓存（p_state），避免把脏状态落到盘上（fs/jfs/jfs_mount.c#L403-L422）。
• 恢复常规行为：文档建议"用 integrity 选项重挂载之前以 nointegrity 挂载的卷"。这一点在 jfs_reconfigure() 中有专门分支：若重挂载前后 JFS_NOINTEGRITY 发生变化且卷为读写，则先 jfs_umount_rw() 再带着新标志 jfs_mount_rw() 重新初始化日志（fs/jfs/super.c#L425-L435）。

mount -t jfs -o nointegrity /dev/sdb1 /mnt/data    # 恢复备份场景
mount -o remount,integrity /dev/sdb1 /mnt/data     # 恢复日志保护

3.4 errors=continue|remount-ro|panic：出错处理策略

errors=continue     文件系统出错后继续运行
errors=remount-ro   出错时把文件系统重挂载为只读（默认）
errors=panic         出错时 panic 并停机

源码印证：

• 枚举值由 jfs_param_errors 常量表映射为 JFS_ERR_CONTINUE、JFS_ERR_REMOUNT_RO、JFS_ERR_PANIC（fs/jfs/super.c#L213-L218）。
• 默认值确为 remount-ro：jfs_init_options() 在首次挂载上下文初始化时执行 ctx->flag = JFS_ERR_REMOUNT_RO（fs/jfs/super.c#L883-L893），与文档标注的默认行为一致。
• 实际动作在 jfs_handle_error()：panic 直接调用 panic() 停机；remount-ro 打印错误日志并置 SB_RDONLY；continue 除把超级块标记为脏（updateSuper(sb, FM_DIRTY)）外不做任何处理（fs/jfs/super.c#L62-L81）。

3.5 uid / gid / umask：覆盖磁盘上的所有权与权限

uid=value    用给定值覆盖磁盘上记录的 uid
gid=value    用给定值覆盖磁盘上记录的 gid
umask=value  用给定八进制值覆盖磁盘上的 umask；
             对于目录，若对应的读位置位则同时设置执行位

适用于从旧机器、异构系统导入数据或迁移介质等场景。解析端：Opt_umask 会校验 result.uint_32 & ~0777，非法值返回 -EINVAL（fs/jfs/super.c#L328-L334）；默认值为 INVALID_UID/INVALID_GID/umask = -1，即不覆盖。这三个值最终写入 jfs_sb_info，并通过 jfs_show_options() 回显到 /proc/mounts（如 ,umask=022，fs/jfs/super.c#L657-L687）。

3.6 discard / nodiscard：在线 TRIM 与 FITRIM

文档说明：

• discard=minlen / nodiscard：开关块释放时的 discard/TRIM 命令。块被释放时向底层块设备发送 TRIM，对 SSD 和稀疏/精简配置 LUN 有用。
• nodiscard（默认）下，FITRIM ioctl 依然可用（即用户可随时主动发起 fstrim）。
• minlen 指定"认为一次 TRIM 有意义"的最小块数；discard 不带值时默认 64 块，在 JFS 中即 256KiB（4KiB × 64）。
• discard 指定的 minlen 会覆盖 FITRIM ioctl 中传入的 minlen。

源码实现分三层：

1. 挂载时解析。Opt_discard（无值）设置 minblks_trim = 64 并置 JFS_DISCARD 标志；Opt_discard_minblk（带值）把值存入 minblks_trim 并置 JFS_DISCARD；Opt_nodiscard 清除 JFS_DISCARD（fs/jfs/super.c#L336-L352）。jfs_fill_super() 还会检查 bdev_max_discard_sectors()，设备不支持 discard 时打印 JFS: discard option not supported on device 并自动丢弃该选项（fs/jfs/super.c#L473-L480）。
2. 在线释放路径。当文件数据块被释放（dbFreeAG 路径）时，若 JFS_DISCARD 已置位且释放块数 nblocks >= minblks_trim，就调用 jfs_issue_discard() 向块设备下发 TRIM（fs/jfs/jfs_dmap.c#L456-L457）；最终由 sb_issue_discard() 提交（fs/jfs/jfs_discard.c#L32-L49）。
3. FITRIM ioctl。fstrim 工具走 jfs_ioctl() 的 FITRIM 分支：要求 CAP_SYS_ADMIN，设备必须支持 discard（否则 -EOPNOTSUPP），把 range.minlen 与 bdev_discard_granularity() 取最大值后交给 jfs_ioc_trim()；后者把字节范围换算成块，遍历范围内的所有 AG 调用 dbDiscardAG() 清理空闲块，并把实际 trim 的字节数写回 range->len（fs/jfs/ioctl.c#L110-L140、fs/jfs/jfs_discard.c#L65-L114）。注意 jfs_ioc_trim() 中的 minlen 下限逻辑（minlen == 0 时取 1 块）与挂载选项 minlen 共同决定哪些空闲区段"值得"下发 TRIM，这正对应文档所说"discard 的 minlen 覆盖 FITRIM 的 minlen"。

mount -t jfs -o discard /dev/sdb1 /mnt/data        # 在线 TRIM，minlen=64 块(256KiB)
mount -t jfs -o discard=128 /dev/sdb1 /mnt/data    # 仅对 >=128 块(512KiB) 的释放段 TRIM
fstrim -v /mnt/data                                # nodiscard 挂载下也可手动 TRIM

需要提醒的一点取舍：discard 模式下，文件拷贝/删除产生的每次块释放都可能触发 TRIM 命令，源码注释也指出"即使复制文件也会触发 trimming"（fs/jfs/super.c#L336-L343）。对延迟敏感的场景，可保持 nodiscard，改用周期性 fstrim 换取可预测的写入延迟。

四、挂载选项如何落盘回显与验证

/proc/mounts 中 JFS 挂载点的选项回显由 jfs_show_options() 生成：非默认配置会显示 ,uid=…、,gid=…、,umask=…、,nointegrity、,discard=<minblks>、,iocharset=<charset>、,errors=continue、,errors=panic 等（remount-ro 是默认值，不回显）（fs/jfs/super.c#L657-L687）。因此挂载后可以用如下方式核对配置是否生效：

findmnt -n -o OPTIONS /mnt/data
# 例如输出: rw,discard=64,iocharset=utf8

五、小结：选项、默认值与生效时机速查

选项	生效时机	默认	关键源码位置
iocharset	挂载/重挂载	不转换	fs/jfs/super.c#L273-L288
resize[=value]	仅读写重挂载	—，仅可扩卷	fs/jfs/super.c#L384-L399、fs/jfs/resize.c#L75-L87
integrity/nointegrity	挂载/重挂载（切换时需 umount_rw+mount_rw）	integrity	fs/jfs/super.c#L425-L435、fs/jfs/jfs_logmgr.c#L1063-L1064
errors=	出错时触发	remount-ro	fs/jfs/super.c#L62-L81、fs/jfs/super.c#L888
uid/gid/umask	挂载时	不覆盖	fs/jfs/super.c#L320-L334
discard[=minlen]/nodiscard	挂载时校验设备能力，释放块时/FITRIM 时生效	nodiscard，minlen 缺省 64 块（256KiB）	fs/jfs/super.c#L336-L352、fs/jfs/ioctl.c#L110-L140

以上行为均以当前仓库 fs/jfs 的源码为准；由于 JFS 是较老且维护面收窄的文件系统，实际使用前应确认目标发行版仍提供 CONFIG_JFS_FS，并在真实设备上验证 resize 扩卷与 discard 行为后再上生产环境。