C / C++ / 系统课时
用 stat 查看文件属性
用 stat 查看文件属性
程序需要判断路径指向什么类型的文件、文件有多大或最近何时修改时,不必读取文件内容。POSIX 的 stat 可以一次取得这些元数据,本节通过一个可运行示例读取文件类型、大小、权限和修改时间。
学习目标
- 会调用
stat获取路径对应的文件元数据 - 能正确判断常规文件类型并读取大小、权限和修改时间
- 理解
stat、lstat与fstat在目标对象上的区别
stat 返回的是什么
stat 接收文件路径和 struct stat 指针。调用成功后,内核把文件元数据写入该结构体,而不会把文件正文读入程序。
常用成员包括 st_mode、st_size 和 st_mtime。其中 st_mode 同时编码了文件类型和权限位,因此不能直接把它当作普通的三位权限数字处理,应使用 POSIX 提供的文件类型宏和权限掩码。
函数返回 0 表示成功,返回 -1 表示失败,并通过 errno 提供具体原因。实际程序至少要处理路径不存在、权限不足或路径中某一级目录不可访问等情况。
读取并解释常用属性
下面的程序先创建一个内容确定的普通文件,并把权限设为 0640,随后使用 stat 查看属性。这样除了修改时间外,其余输出都可以稳定验证。
#include <fcntl.h>
#include <stdio.h>
#include <sys/stat.h>
#include <unistd.h>
int main(void) {
const char *path = "stat-demo.txt";
const char data[] = "hello";
int fd = open(path, O_WRONLY | O_CREAT | O_TRUNC, 0640);
if (fd == -1) {
perror("open");
return 1;
}
if (write(fd, data, sizeof(data) - 1) != (ssize_t)(sizeof(data) - 1)) {
perror("write");
close(fd);
return 1;
}
close(fd);
if (chmod(path, 0640) == -1) {
perror("chmod");
return 1;
}
struct stat info;
if (stat(path, &info) == -1) {
perror("stat");
return 1;
}
printf("type: %s\n", S_ISREG(info.st_mode) ? "regular file" : "other");
printf("size: %lld bytes\n", (long long)info.st_size);
printf("mode: %04o\n", (unsigned int)(info.st_mode & 0777));
printf("mtime: %lld\n", (long long)info.st_mtime);
return 0;
}预期输出
type: regular file
size: 5 bytes
mode: 0640
mtime: <TIME><TIME> 是文件最后修改时间对应的时间值,实际结果会随运行时间变化。这里把 st_size 和时间字段转换后再输出,避免直接假定相关系统类型与某个 printf 整数格式完全一致。
文件类型和权限为什么共用 st_mode
st_mode 不是单纯的权限字段。它同时保存文件类型位和权限位。判断文件类型时应使用 S_ISREG、S_ISDIR、S_ISLNK 等宏,而不是自己猜测位值。
如果只想查看常见的九个权限位,可以使用 info.st_mode & 0777。示例输出的 0640 表示所有者可读写、同组用户只读、其他用户没有权限。
stat、lstat 和 fstat 怎么区分
stat 根据路径查询对象,并且遇到符号链接时会继续跟随链接,返回链接最终指向对象的属性。如果要检查符号链接本身,应使用 lstat。
fstat 不接收路径,而是接收一个已经打开的文件描述符。这适合程序先通过 open 得到稳定对象,再查询其元数据,也能避免再次按路径查找文件。
| 接口 | 查询依据 | 遇到符号链接 |
|---|---|---|
stat |
路径 | 跟随链接 |
lstat |
路径 | 查询链接本身 |
fstat |
文件描述符 | 查询描述符引用的对象 |
使用 stat 时,最重要的是先检查返回值,再读取结构体成员。文件属性在调用成功的那个时刻形成一份快照;如果其他进程随后修改或替换文件,之前得到的数据不会自动更新,需要再次调用相应接口获取最新状态。