linux 内核中备受关注的“新 mount api”(即基于文件描述符的挂载接口)现已正式纳入官方 man 手册页面,标志着这一自诞生以来长达六年多缺乏权威文档说明的重要特性终于拥有了完整、规范的技术文档支持。
此次文档落地将显著降低开发者与系统运维人员的学习与使用门槛,使其能够更准确、高效地理解该 API 的语义、调用流程及行为边界,从而推动其在实际部署和上游工具链中的深度集成与广泛应用。

https://www.php.cn/link/696da8718f4b20ac408558e7dfd9f7ee
长期以来,Linux 依赖单一的 mount() 系统调用完成挂载操作,虽实现简洁,但在配置粒度、错误隔离及可扩展性方面存在明显局限。而新一代 Mount API 则通过模块化设计引入了如 fsopen、fsconfig、fsmount 和 move_mount 等一系列协同工作的系统调用,依托文件描述符传递上下文,实现了对挂载过程的分阶段控制与精细化管理。
该接口最早于 2019 年随 Linux 5.2 内核版本发布,并逐步获得 ext4、XFS、Btrfs、NFS 等主流文件系统的兼容支持。然而,由于长期缺失标准化的手册页支持,相关技术细节主要散见于内核源码注释、邮件列表讨论及零星社区笔记中,严重制约了其普及速度与工程化落地效率。
据历史记录显示,早在 2018 至 2020 年间已有多个针对 man page 的补丁提案提交至 man-pages 项目,但均因格式审查、内容完整性或维护优先级等原因未能合入主线。由此导致该 API 在相当长一段时间内处于“功能可用但文档缺位”的尴尬境地。
直至 2025 年 10 月,随着 man-pages 项目 6.16 版本的正式发布,这批文档才首次被纳入标准发行版手册体系;不过目前部分在线手册镜像站点(例如 man7.org)尚未完成同步更新,用户可能需手动刷新缓存或查阅本地安装版本以获取最新内容。

有参与本次文档撰写的内核维护者指出,man-pages 项目当前仍严格采用 Groff 排版系统编写手册页,相较 Markdown 等现代轻量格式,在协作编辑、自动化测试与持续集成方面存在一定障碍,这也在一定程度上拖慢了新特性的文档跟进节奏。
源码地址:点击下载










