Linux statx 怎样读取文件创建时间

Linux 中可以用 statx() 请求 STATX_BTIME，在调用成功后检查 stx_mask 是否包含该位，再读取 stx_btime。请求了创建时间并不代表一定能拿到；返回掩码没有这一位时，应记录“创建时间不可用”，不能拿 ctime 冒充。

官方文档入口：https://www.kernel.org/doc/man-pages/

创建时间解决什么问题

文件清单、归档索引和资产登记经常需要保存文件的创建时间。这里的创建时间是文件系统为对象记录的 birth time，不是业务系统第一次接收到文件的时间，也不能证明文件内容最初诞生于何时。

例如权限或所有者改变会影响状态时间，不能由 ctime 推导创建时间。复制文件、恢复备份和跨文件系统迁移也可能改变对象及其时间语义；若业务需要“原始创建时间”，应另存业务元数据并说明来源。

先区分接口支持与字段支持

statx 是 Linux 接口，Linux man-pages 记录其进入 Linux 4.11、glibc 2.28。这些是接口出现的时间点，不是“所有文件系统从此都有创建时间”的保证。构建环境还需要提供相应声明、结构体和常量；其他 C 库环境应以该实现的头文件与文档为准。

mask 是调用者想要哪些字段，stx_mask 是实际提供了哪些字段。内核可以返回额外字段，也可以无法提供某个请求字段，所以不要判断两个掩码整体相等，只检查目标位。

具体结果取决于正在访问的目标文件、后端文件系统及其实现。网络文件系统、容器挂载或叠加文件系统不能只靠宿主内核版本判断支持。字段未提供时，其数值不应进入业务计算；也不能以秒数是否为零代替掩码判断。

最小 C 示例：读取前先检查 stx_mask

下面示例面向提供 statx 声明的 Linux C 开发环境。它查询传入路径的对象，保留“调用失败”和“创建时间不可用”两类结果；使用 AT_SYMLINK_NOFOLLOW 表示最终路径是符号链接时查询链接本身。

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

int main(int argc, char **argv)
{
    if (argc != 2) {
        fprintf(stderr, "usage: %s PATH\n", argv[0]);
        return 2;
    }
    struct statx info = {0};
    // 只请求创建时间；不跟随路径最后一段的符号链接
    if (statx(AT_FDCWD, argv[1], AT_SYMLINK_NOFOLLOW,
              STATX_BTIME, &info) == -1) {
        // 调用失败与字段未提供是两类结果
        if (errno == ENOSYS)
            fprintf(stderr, "statx unavailable\n");
        else
            perror("statx");
        return 1;
    }
    if ((info.stx_mask & STATX_BTIME) == 0) {
        puts("birth time unavailable");
        return 3;
    }
    // 秒数与纳秒分开打印，避免转浮点数丢失精度
    printf("birth_seconds=%" PRIdMAX "\nbirth_nanoseconds=%09" PRIuMAX "\n",
           (intmax_t)info.stx_btime.tv_sec,
           (uintmax_t)info.stx_btime.tv_nsec);
    return 0;
}

# 在 Linux 开发环境中编译，再查询一个实际存在的文件
cc -std=c11 -Wall -Wextra birth_time.c -o birth_time
./birth_time ./sample.dat

将源码保存为 birth_time.c 后执行上述命令。正常取得时间时，程序打印 Unix 纪元起的秒数和纳秒部分；这不是格式化后的本地时间字符串。纳秒字段有九位显示形式，不表示底层文件系统一定具备纳秒级记录精度。需要展示日期时再做明确的 UTC 或本地时区转换。

示例约定退出码 0 表示取得创建时间，3 表示调用成功但该字段未提供，1 表示调用失败，2 表示参数数量错误。这是应用自己定义的约定，不是 statx 的系统退出码。statx 本身成功返回 0，错误返回 -1 并设置 errno。本文代码是使用示例，没有把示例输出描述为本机运行记录。

拿不到创建时间时怎样兼容处理

对权限不足、路径不存在等错误，应保留失败原因。访问路径需要相应目录搜索权限，取得元数据不等于必须读取文件内容。较旧或受限制的运行环境可能不支持该调用；出现 ENOSYS 时记录接口不可用，其他错误继续按实际 errno 处理。

存储模型可以包含 status、birth_seconds、birth_nanoseconds 与 error_code。只有可用状态填写时间字段；未提供与失败状态使用空值。若另有上传时间或入库时间，应分别命名，避免在同一列中混用含义。

路径语义和性能注意

AT_FDCWD 让相对路径以当前工作目录为基准；绝对路径不使用这个基准。若想查询符号链接指向的目标，可移除示例中的 AT_SYMLINK_NOFOLLOW。这个标志只改变最后一段链接的处理方式，不能当成整条路径都禁止经过符号链接的保证。

批量扫描只请求需要的字段，避免使用全部比特置位的 mask；手册也将 STATX_ALL 标为不建议继续使用。默认同步策略由文件系统决定，网络文件系统可能涉及元数据同步。不要为了加速就承诺结果一定最新；确有新鲜度要求时，应阅读对应同步标志与后端语义。

stat 返回的 ctime 名称里有 c，为什么不是 creation？

这里的 c 表示状态变化，创建时间使用 btime 表达。不能从字段名称猜业务含义，应看接口定义。

stx_btime.tv_sec 为零就说明不支持吗？

不能。先看 stx_mask 的 STATX_BTIME 位；字段有效性与字段数值是不同信息。

同样程序在两个挂载目录结果不同正常吗？

可能正常。后端实现和目标对象不同会影响可提供的字段，应记录各自返回掩码，而不是给整个机器设置一个永久支持开关。

参考：Linux man-pages：statx(2)。