Linux fanotify FAN_MARK_MOUNT 怎样只监控一个文件系统
我第一次用 fanotify 做文件系统级监控时,最容易误判的地方不是事件读取,而是 pathname 到底代表多大范围。FAN_MARK_MOUNT 的答案很明确:传入的路径会被解析到它所在的挂载点,标记覆盖这个 mount 下的目录、子目录和文件,并不是只盯住传入的那一级目录。
官方文档:https://www.kernel.org/doc/html/latest/userspace-api/fanotify.html
FAN_MARK_MOUNT适合“只关注某个挂载点”的场景。使用它前要同时确认三个条件:调用进程拥有CAP_SYS_ADMIN,事件掩码没有放入需要文件句柄的事件,并且退出或重载时清理同一个 mount mark。
先判断 pathname 会落到哪个范围
fanotify_mark() 的最后两个关键参数是 dirfd 和 pathname。当 flags 带有 FAN_MARK_MOUNT 时,内核把 pathname 所在的挂载点作为标记对象;即使 pathname 不是挂载点本身,也会标记包含它的 mount。
例如 /data/logs/app 位于单独挂载的 /data 文件系统中,使用 FAN_MARK_MOUNT 后,监控范围是 /data 这个 mount,而不是 /data/logs/app。如果目标是一个目录树中的局部子目录,应考虑普通 inode 或目录标记,不能把 mount 标记当成目录过滤器。

用 FAN_MARK_ADD 把一个 mount 加入监控
添加挂载标记时,把 FAN_MARK_ADD 和 FAN_MARK_MOUNT 组合到 flags 中,再把想接收的通知事件放进 mask。下面的片段只演示“创建一个通知组并标记挂载点”的核心调用,事件读取循环不在本文范围内。
#include#include #include #include #include #include int main(int argc, char **argv) { // 通过命令行传入挂载点,避免把环境路径写死在程序里。 if (argc != 2) { fprintf(stderr, "用法:%s MOUNT_PATH\n", argv[0]); return EXIT_FAILURE; } // FAN_CLASS_NOTIF 只接收通知,不处理需要回复的权限事件。 int fan_fd = fanotify_init(FAN_CLOEXEC | FAN_CLASS_NOTIF, O_RDONLY | O_CLOEXEC); if (fan_fd == -1) { perror("fanotify_init"); return EXIT_FAILURE; } // 只请求通知类事件;FAN_MARK_MOUNT 会把 argv[1] 所在 mount 整体标记。 uint64_t mask = FAN_OPEN | FAN_CLOSE_WRITE; if (fanotify_mark(fan_fd, FAN_MARK_ADD | FAN_MARK_MOUNT, mask, AT_FDCWD, argv[1]) == -1) { perror("fanotify_mark"); close(fan_fd); // 添加失败时也要释放已经创建的文件描述符。 return EXIT_FAILURE; } puts("mount mark added"); close(fan_fd); // 示例到此结束;长期监听程序应在退出路径中先移除标记。 return EXIT_SUCCESS; }
这里有两个容易混淆的点。第一,FAN_MARK_ADD 表示把 mask 中的事件加入现有标记;如果同一组已经有该 mount 的标记,再次添加是在更新事件集合。第二,FAN_CLASS_NOTIF 是通知类,不会让程序进入权限事件的允许/拒绝回复流程,所以示例把重点放在范围和生命周期上。
为什么加上 FAN_MARK_MOUNT 后会出现 EINVAL
我排查这类失败时,通常先看 flags,再看 mask。FAN_MARK_MOUNT 不能和要求用文件句柄识别对象的事件随意混用。官方 man-pages 明确列出了 FAN_CREATE、FAN_ATTRIB、FAN_MOVE、FAN_DELETE_SELF 等事件:它们不能直接作为 mount mark 的 mask,否则 fanotify_mark() 会返回 -1 并把 errno 设为 EINVAL。
// 这是一个掩码选择示意:mount mark 先使用通知类、非文件句柄事件。
uint64_t mount_mask = FAN_OPEN | FAN_CLOSE_WRITE;
// 不要把需要 FAN_REPORT_FID 的创建、属性或移动事件直接塞进这里。
int rc = fanotify_mark(fan_fd,
FAN_MARK_ADD | FAN_MARK_MOUNT,
mount_mask,
AT_FDCWD,
mount_path);
if (rc == -1) {
// EINVAL 通常说明 flags、mask 或 fanotify_init 的组合不兼容。
if (errno == EINVAL) {
fprintf(stderr, "mount mark 的 flags 或事件掩码不兼容\n");
}
}
这不是简单的“把所有感兴趣的宏 OR 起来”。fanotify 的初始化模式、对象识别方式和事件类型必须成套设计。如果需求是定位新建文件、移动文件等对象,应该重新评估文件句柄报告模式和对应的标记方式,而不是只在原调用上不断增加事件宏。
把 CAP_SYS_ADMIN 当成前置条件
挂载级标记需要 CAP_SYS_ADMIN。没有这个能力时,即使 pathname 存在、mask 也看起来合理,调用仍可能失败。这个权限前提与“能不能读取目录”是两回事:当前用户能够访问路径,不代表它拥有创建 mount mark 所需的内核能力。
# 先确认进程当前的 capability 集合;这里只做环境检查,不修改系统权限。 capsh --print | sed -n '/Current:/p' # 查看目标路径落在哪个挂载点,帮助确认 FAN_MARK_MOUNT 的实际范围。 findmnt --target /data/logs/app # 用具备所需能力的受控服务启动监听器;不要把 CAP_SYS_ADMIN 无条件给普通业务进程。 sudo --preserve-env=PATH ./mount-watch /data
上面的命令只是在部署或排障时确认两个事实:进程是否具备所需能力,以及目标路径实际属于哪个 mount。生产环境里更稳妥的做法是把监听器放到权限边界清楚的服务中,缩小它能接触的文件描述符、配置和输出范围。
用 FAN_MARK_REMOVE 让标记生命周期闭环
添加标记不是一次性的配置动作。程序重载、切换监听路径或准备退出时,都应该使用同一个 fan_fd、同一个 pathname 和 FAN_MARK_MOUNT 清理对应标记。常见的误区是只关闭 fanotify 文件描述符,却没有把“重新添加”的代码和“移除旧标记”的代码放在同一条生命周期里。
// 退出前移除同一挂载点的通知事件,避免重载逻辑留下旧状态。
if (fanotify_mark(fan_fd,
FAN_MARK_REMOVE | FAN_MARK_MOUNT,
mask,
AT_FDCWD,
mount_path) == -1) {
// 目标已经被清理时记录 errno,不能把所有失败都当成可忽略。
perror("fanotify_mark remove");
}
// 清理完成后再关闭描述符,避免后续排查无法区分 mark 与 fd 的状态。
close(fan_fd);
FAN_MARK_REMOVE 的 mask 需要对应要移除的事件;如果要清掉这一组的挂载标记,也可以根据生命周期设计使用 FAN_MARK_FLUSH | FAN_MARK_MOUNT,但 flush 的影响范围更大,不能在多租户或多个监控目标共用一组时随意使用。

按 errno 判断问题落在哪一层
| 现象 | 优先检查 | 处理方向 |
|---|---|---|
EPERM 或权限相关失败 | 进程是否具有 CAP_SYS_ADMIN | 调整受控服务的能力边界,不要只给目录加读权限 |
EINVAL | flags、mask 与 fanotify_init 模式 | 移除不适用于 mount mark 的文件句柄事件,重新设计报告模式 |
ENOENT | pathname 是否存在,或移除时标记是否已存在 | 确认挂载点和清理顺序,避免用已经变化的路径重放旧操作 |
ENODEV | 目标文件系统是否提供 fanotify 所需的文件系统标识 | 结合内核文档和目标文件系统能力重新评估部署范围 |
排查顺序最好固定下来:先确认 findmnt --target 得到的范围,再确认 capability,接着检查初始化类和事件掩码,最后才看路径或文件系统本身。这样能把“路径错了”和“能力不够”“事件组合不允许”分开,不会在同一处反复改 mask。
什么时候应该换成其他标记方式
如果你需要的是某个目录及其子目录,而不是整个挂载文件系统,FAN_MARK_MOUNT 的范围就太大;如果你需要跨多个挂载点观察同一个文件系统,也要比较 FAN_MARK_FILESYSTEM 的语义。两者都不是“更强的目录过滤器”,而是不同的对象范围。
我的判断标准很简单:监控边界跟着部署单元走,就考虑 mount mark;边界跟着单个目录或文件走,就不要为了少写几行代码扩大范围;需求涉及创建、移动、属性变化等文件句柄事件时,先设计对象识别方式,再选 mark flags。
常见问题
pathname 必须正好是挂载点吗?
不必。只要 pathname 位于某个挂载点内,FAN_MARK_MOUNT 会标记包含它的 mount。但这也意味着传入一个深层目录不会把范围缩小到这个目录。
为什么 FAN_CREATE 不能直接和 FAN_MARK_MOUNT 一起用?
这类事件需要用文件句柄识别对象,而 mount mark 的事件掩码有明确限制。应按官方 fanotify 语义重新选择初始化报告模式和标记对象,不要只把宏继续叠加。
关闭 fanotify 文件描述符就够了吗?
短命进程结束时,内核资源会随描述符生命周期回收;但常驻程序重载、切换目标或多次初始化时,仍应显式移除旧标记,避免把生命周期问题留到下一次排查。
FAN_MARK_MOUNT 和 FAN_MARK_FILESYSTEM 有什么区别?
前者针对 pathname 所在的 mount,后者针对 pathname 所在的整个文件系统,后者可能覆盖该文件系统的其他挂载点。选择时看你要隔离的是挂载点,还是底层文件系统。
总结
用 FAN_MARK_MOUNT 监控一个文件系统挂载点,可以按四步落地:先用 findmnt --target 确认 pathname 的实际归属,再用 FAN_MARK_ADD | FAN_MARK_MOUNT 添加通知标记;随后检查 CAP_SYS_ADMIN 和不兼容的事件掩码,最后在退出或重载时用 FAN_MARK_REMOVE | FAN_MARK_MOUNT 清理。真正关键的不是记住一个宏,而是把路径范围、事件类型、权限能力和标记生命周期放在同一张设计图里。
Linux getconf 怎样读取系统的时钟滴答数
- 上一篇
- Linux getconf 怎样读取系统的时钟滴答数
- 下一篇
- Linux lsipc 怎样查询单个 System V 信号量集的详细信息
-
- 文章 · linux | 1天前 | 权限管理 · linux运维 · Linux systemd capabilities 最小权限 file capabilities ambient capabilities
- Linux capabilities 怎样替代给进程授予完整 root
- 266浏览 收藏
-
- 文章 · linux | 1天前 | Linux · Linux 进程状态 procfs /proc/PID/status
- Linux /proc/PID/status 怎样读取进程状态字段
- 499浏览 收藏
-
- 文章 · linux | 1天前 | 权限管理 · Linux capabilities user namespace uid_map gid_map 权限边界 UID映射
- Linux user namespace 怎样理解 UID 映射和权限边界
- 186浏览 收藏
-
- 文章 · linux | 1天前 | Linux · 运维 · 文件系统 · Linux mount bind mount rbind
- Linux bind mount 怎样只暴露目录的一部分
- 308浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1088次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1086次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1251次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1196次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1039次使用
-
- Go 用 io/fs 做配置目录快照:过滤、排序与差异报告小工具
- 2026-07-24 339浏览
-
- Go io/fs.ValidPath 为什么拒绝 ./config.yaml:FS 路径规则与迁移边界
- 2026-07-24 388浏览
-
- Go io/fs.ReadDir 如何避免目录遍历顺序误判:排序约定、错误处理与测试边界
- 2026-08-26 253浏览
-
- Go os.OpenRoot 怎么限制用户路径:安全打开、目录逃逸与错误验收
- 2026-08-26 182浏览
-
- Go os.CopyFS 怎么把嵌入文件复制到磁盘:覆盖规则与目录权限核对
- 2026-08-26 374浏览

