当前位置:首页 > 文章列表 > 文章 > linux > Linux fanotify FAN_MARK_MOUNT 怎样只监控一个文件系统

Linux fanotify FAN_MARK_MOUNT 怎样只监控一个文件系统

来源:17golang原创 2026-11-18 06:04:51 0浏览 收藏

我第一次用 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 标记当成目录过滤器。

Linux fanotify FAN_MARK_MOUNT 将传入路径映射到挂载点并覆盖其目录子目录和文件的静态结构图
图1:结构说明图,展示 FAN_MARK_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 的影响范围更大,不能在多租户或多个监控目标共用一组时随意使用。

fanotify 挂载标记从初始化到添加事件掩码再到错误判断和移除的静态流程图
图2:流程说明图,展示挂载标记的添加、边界检查与移除;不是截图或运行证据。

按 errno 判断问题落在哪一层

现象优先检查处理方向
EPERM 或权限相关失败进程是否具有 CAP_SYS_ADMIN调整受控服务的能力边界,不要只给目录加读权限
EINVALflags、mask 与 fanotify_init 模式移除不适用于 mount mark 的文件句柄事件,重新设计报告模式
ENOENTpathname 是否存在,或移除时标记是否已存在确认挂载点和清理顺序,避免用已经变化的路径重放旧操作
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 清理。真正关键的不是记住一个宏,而是把路径范围、事件类型、权限能力和标记生命周期放在同一张设计图里。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Linux getconf 怎样读取系统的时钟滴答数Linux getconf 怎样读取系统的时钟滴答数
上一篇
Linux getconf 怎样读取系统的时钟滴答数
Linux lsipc 怎样查询单个 System V 信号量集的详细信息
下一篇
Linux lsipc 怎样查询单个 System V 信号量集的详细信息
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1088次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1086次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1251次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1196次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1039次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码