Linux statx 怎样读取纳秒时间与挂载 ID

我第一次把文件元数据接入归档索引时，最容易混淆的是两件事：时间戳里的纳秒不是“另一种时间”，而是秒内的精细部分；挂载 ID 也不是设备号，不能拿 stx_dev_major 一类字段代替。Linux 的 statx() 可以一次请求这些字段，但调用方必须同时看请求掩码和返回的 stx_mask。

下面用一个最小 C 示例说明读取方式。示例只展示接口关系，配图是静态说明图，不是本机运行截图或运行证据。

核心做法是请求 STATX_BTIME | STATX_MTIME | STATX_MNT_ID，再分别读取 tv_sec、tv_nsec 和 stx_mnt_id；任何字段都要先用 stx_mask 确认是否真的返回。

statx 的请求掩码和返回掩码要分开看

statx() 的第四个参数是调用方想要什么，返回结构里的 stx_mask 则说明内核实际提供了什么。两者不能混为一谈：请求了创建时间，不代表当前文件系统一定能给出创建时间；请求挂载 ID，也要按返回掩码判断。

纳秒时间要从 tv_sec 和 tv_nsec 组合

struct statx_timestamp 里，tv_sec 是 Unix 时间的秒数，tv_nsec 是这一秒以内的纳秒部分，范围通常是 0 到 999999999。要把它送进日志或排序键，建议保留两个整数，或者在明确不会溢出的前提下再转换成更高精度的时间类型。

#define _GNU_SOURCE
#include 
#include 
#include 
#include 
#include 
#include 
#include 

int main(void) {
    const char *path = "/var/log/example.log";
    struct statx stx;
    unsigned int mask = STATX_BTIME | STATX_MTIME | STATX_MNT_ID;

    // 只请求文章需要的字段，避免把未使用的元数据当成必然存在。
    memset(&stx, 0, sizeof(stx));
    if (syscall(SYS_statx, AT_FDCWD, path, AT_SYMLINK_NOFOLLOW,
                mask, &stx) == -1) {
        // 系统调用失败时保留 errno，便于区分路径、权限和内核接口问题。
        fprintf(stderr, "statx failed: %s\\n", strerror(errno));
        return 1;
    }

    // 返回掩码决定字段是否有效；不能只检查字段当前是不是 0。
    if (stx.stx_mask & STATX_MTIME) {
        printf("mtime=%lld.%09u\\n",
               (long long)stx.stx_mtime.tv_sec,
               stx.stx_mtime.tv_nsec);
    }
    if (stx.stx_mask & STATX_BTIME) {
        printf("btime=%lld.%09u\\n",
               (long long)stx.stx_btime.tv_sec,
               stx.stx_btime.tv_nsec);
    }
    if (stx.stx_mask & STATX_MNT_ID) {
        printf("mount_id=%llu\\n",
               (unsigned long long)stx.stx_mnt_id);
    }
    return 0;
}

这里用 %09u 补足纳秒部分的 9 位，输出形如“秒.纳秒”。创建时间 stx_btime 可能因为文件系统能力或内核返回掩码而不可用；这时应把“没有创建时间”作为正常分支，而不是把 0 当成真实时间。

挂载 ID 的含义与兼容边界

stx_mnt_id 表示文件所在挂载的标识，和设备主次号、inode 号不是同一个维度。它适合帮助索引系统区分同一路径语义下的挂载边界，但不应被当作永久不变的业务主键。STATX_MNT_ID 从较新的 Linux 内核开始提供，老内核或不支持该字段的环境应允许降级。

判断顺序可以固定成三条：先判断系统调用是否失败；再检查 stx_mask 中是否包含目标位；最后才读取对应成员。尤其不要因为 stx_mnt_id == 0 就判断字段不存在，字段存在性由掩码表达。

把字段缺失作为可记录的结果

如果程序要把元数据写入索引，建议为时间和挂载 ID 分别保留“值”和“可用标志”。这样在跨文件系统、容器挂载或旧内核环境中，查询层可以区分“字段确实为零”和“本次没有返回”。当只需要修改时间时，可以只请求 STATX_MTIME；不要把 STATX_ALL 当成默认方案，它包含更多字段且在文档中已不推荐使用。

这套写法的重点不在于把所有元数据一次读全，而在于让每个字段都有清楚的请求位、返回位和降级路径。对于日志排序，保存秒与纳秒两个整数；对于挂载识别，保存 stx_mnt_id 及其有效标志，并在跨重启或跨命名空间使用时重新确认语义。

相关问题

为什么请求了 btime 仍然没有创建时间？ 因为请求掩码只是意图，文件系统和内核是否能提供要看返回的 stx_mask。

挂载 ID 能代替设备号吗？ 不能。挂载 ID 描述挂载实例边界，设备主次号描述设备身份，使用场景不同。