【嵌入式Linux应用开发基础】stat函数

byte轻骑兵

发布于 2026-01-21 15:23:15

3250

在嵌入式Linux应用开发中，stat函数是一个非常有用的系统调用，用于获取文件的状态信息。这些信息包括文件的大小、权限、所有者、组、修改时间等。stat函数定义在<sys/stat.h>头文件中。

一、概述

stat 函数可以帮助开发者了解文件的各种属性，如文件类型（普通文件、目录、符号链接等）、文件权限、文件大小、文件创建和修改时间等。这些信息对于文件操作、权限管理以及系统监控等方面都非常有用。

1.1. 函数原型

在 <sys/stat.h> 头文件中定义了 stat 函数，其原型如下：

#include <sys/stat.h>

int stat(const char *pathname, struct stat *statbuf);

1.2. 参数说明

pathname：是一个指向以空字符结尾的字符串的指针，代表要获取信息的文件或目录的路径名。它可以是绝对路径，也可以是相对路径。
statbuf：是一个指向 struct stat 结构体的指针。该结构体用于存储文件的各种属性信息。struct stat 结构体的定义如下：

struct stat {
    dev_t     st_dev;         /* 文件所在设备的 ID */
    ino_t     st_ino;         /* 文件的 inode 编号 */
    mode_t    st_mode;        /* 文件的类型和权限 */
    nlink_t   st_nlink;       /* 文件的硬链接数 */
    uid_t     st_uid;         /* 文件所有者的用户 ID */
    gid_t     st_gid;         /* 文件所有者的组 ID */
    dev_t     st_rdev;        /* 特殊设备文件的设备 ID */
    off_t     st_size;        /* 文件的大小（以字节为单位） */
    blksize_t st_blksize;     /* 文件系统的块大小 */
    blkcnt_t  st_blocks;      /* 文件所占的块数 */
    time_t    st_atime;       /* 文件的最后访问时间 */
    time_t    st_mtime;       /* 文件的最后修改时间 */
    time_t    st_ctime;       /* 文件的最后状态改变时间 */
};

1.3. 返回值

成功：如果函数调用成功，返回值为 0，并且 statbuf 结构体中会填充相应的文件信息。
失败：如果函数调用失败，返回值为 -1，并且会设置 errno 变量来指示具体的错误原因。常见的错误包括文件或目录不存在（ENOENT）、权限不足（EACCES）等。

1.4. 相关函数

lstat：不追踪符号链接。
fstat：通过文件描述符获取信息。

二、典型应用场景

2.1. 文件权限管理

在嵌入式系统里，对文件的访问权限进行严格控制是至关重要的。stat 函数可用于获取文件的权限信息，以此判断用户是否具有相应的访问权限。

#include <stdio.h>
#include <sys/stat.h>
#include <unistd.h>

int main(int argc, char *argv[]) {
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <filename>\n", argv[0]);
        return 1;
    }

    struct stat file_stat;
    if (stat(argv[1], &file_stat) == -1) {
        perror("stat");
        return 1;
    }

    // 检查用户是否有读权限
    if (file_stat.st_mode & S_IRUSR) {
        printf("User has read permission.\n");
    } else {
        printf("User does not have read permission.\n");
    }

    return 0;
}

通过 stat 函数获取指定文件的信息，然后检查文件的权限位，判断用户是否具有读权限。

2.2. 文件大小检查

在嵌入式系统中，存储空间通常较为有限。因此，在进行文件操作之前，需要检查文件的大小，以确保系统有足够的空间来处理该文件。

#include <stdio.h>
#include <sys/stat.h>

#define MAX_FILE_SIZE 1024 * 1024  // 最大文件大小为 1MB

int main(int argc, char *argv[]) {
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <filename>\n", argv[0]);
        return 1;
    }

    struct stat file_stat;
    if (stat(argv[1], &file_stat) == -1) {
        perror("stat");
        return 1;
    }

    if (file_stat.st_size > MAX_FILE_SIZE) {
        printf("File size exceeds the limit.\n");
    } else {
        printf("File size is within the limit.\n");
    }

    return 0;
}

stat 函数获取文件的大小，然后将其与预设的最大文件大小进行比较，判断文件大小是否超出限制。

2.3. 文件时间戳检查

文件的时间戳（如最后访问时间、最后修改时间、最后状态改变时间）可以反映文件的更新情况。在某些应用中，需要根据文件的时间戳来判断文件是否需要更新或重新处理。

#include <stdio.h>
#include <sys/stat.h>
#include <time.h>

#define UPDATE_INTERVAL 3600  // 更新间隔为 1 小时

int main(int argc, char *argv[]) {
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <filename>\n", argv[0]);
        return 1;
    }

    struct stat file_stat;
    if (stat(argv[1], &file_stat) == -1) {
        perror("stat");
        return 1;
    }

    time_t current_time = time(NULL);
    if (current_time - file_stat.st_mtime > UPDATE_INTERVAL) {
        printf("File needs to be updated.\n");
    } else {
        printf("File is up-to-date.\n");
    }

    return 0;
}

利用 stat 函数获取文件的最后修改时间，然后将其与当前时间进行比较，判断文件是否需要更新。

2.4. 文件类型判断

在嵌入式系统中，不同类型的文件（如普通文件、目录、符号链接等）需要进行不同的处理。stat 函数可以帮助我们判断文件的类型。

#include <stdio.h>
#include <sys/stat.h>

int main(int argc, char *argv[]) {
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <filename>\n", argv[0]);
        return 1;
    }

    struct stat file_stat;
    if (stat(argv[1], &file_stat) == -1) {
        perror("stat");
        return 1;
    }

    if (S_ISREG(file_stat.st_mode)) {
        printf("It is a regular file.\n");
    } else if (S_ISDIR(file_stat.st_mode)) {
        printf("It is a directory.\n");
    } else if (S_ISLNK(file_stat.st_mode)) {
        printf("It is a symbolic link.\n");
    } else {
        printf("It is an unknown file type.\n");
    }

    return 0;
}

使用 stat 函数获取文件的信息，然后通过 S_ISREG、S_ISDIR、S_ISLNK 等宏来判断文件的类型。

2.5. 日志文件管理

在嵌入式系统中，日志文件的管理是一个常见的需求。可以使用 stat 函数来检查日志文件的大小和时间戳，当文件大小超过一定限制或文件存在时间过长时，进行日志文件的分割或归档操作。

#include <stdio.h>
#include <sys/stat.h>
#include <time.h>
#include <unistd.h>
#include <string.h>

#define MAX_LOG_SIZE 1024 * 1024  // 最大日志文件大小为 1MB
#define ARCHIVE_INTERVAL 86400    // 归档间隔为 1 天

void archive_log(const char *log_file) {
    char archive_file[256];
    time_t current_time = time(NULL);
    struct tm *tm_info = localtime(&current_time);
    strftime(archive_file, sizeof(archive_file), "archive_%Y%m%d.log", tm_info);
    if (rename(log_file, archive_file) == -1) {
        perror("rename");
    }
}

int main(int argc, char *argv[]) {
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <log_file>\n", argv[0]);
        return 1;
    }

    struct stat log_stat;
    if (stat(argv[1], &log_stat) == -1) {
        perror("stat");
        return 1;
    }

    time_t current_time = time(NULL);
    if (log_stat.st_size > MAX_LOG_SIZE || current_time - log_stat.st_mtime > ARCHIVE_INTERVAL) {
        archive_log(argv[1]);
    }

    return 0;
}

使用 stat 函数检查日志文件的大小和最后修改时间，当文件大小超过 MAX_LOG_SIZE 或最后修改时间距离当前时间超过 ARCHIVE_INTERVAL 时，调用 archive_log 函数对日志文件进行归档操作。

2.6. 文件合法性校验

场景：

固件升级前验证文件完整性（大小、类型）。
加载配置文件时确保文件存在且非空。

代码片段：

struct stat st;
if (stat("/data/config.bin", &st) != 0) {
    printf("配置文件不存在\n");
} else if (st.st_size == 0) {
    printf("配置文件为空\n");
} else if (!S_ISREG(st.st_mode)) {
    printf("非法文件类型\n");
}

2.7. 权限控制与安全检测

场景：

检查关键文件是否被篡改（权限、所有者）。
确保临时文件未被恶意替换为符号链接。

代码示例：

struct stat st;
if (lstat("/tmp/cache.tmp", &st) == 0) { // 使用lstat避免符号链接攻击
    if (!S_ISREG(st.st_mode) || (st.st_uid != 0)) {
        printf("安全警告：非法文件权限或所有者\n");
    }
}

2.8. 存储空间管理

场景：

写入数据前检查剩余存储空间。
限制日志文件大小防止磁盘占满。

实现方法：

struct stat st;
stat("/data", &st);
uint64_t free_space = st.st_blksize * st.st_blocks; // 总块大小
if (free_space < 1024 * 1024) { // 剩余空间不足1MB
    trigger_cleanup();
}

2.9. 设备节点检测

场景：

检测外设（如U盘、传感器）对应的设备文件（/dev/sda1）是否存在。
动态创建设备节点前检查冲突。

代码片段：

if (stat("/dev/ttyUSB0", &st) == 0) {
    if (S_ISCHR(st.st_mode)) { // 字符设备
        open_serial_port();
    }
} else {
    printf("设备未连接\n");
}

三、关键注意事项

3.1. 文件系统与嵌入式特性适配

问题描述：嵌入式系统可能使用非标准文件系统（如YAFFS2/JFFS2），某些struct stat字段可能不准确（如st_blocks表示块数）。

解决方法：

验证关键字段：测试目标文件系统下st_size、st_mtime等核心字段的可靠性。
避免依赖非标准字段：如st_blksize和st_blocks可能不适用于嵌入式闪存文件系统。

示例代码：

struct stat st;
if (stat("/data/sensor.log", &st) == 0) {
    // 仅依赖可靠字段
    printf("Size: %lld\n", (long long)st.st_size);
}

3.2. 符号链接与文件类型误判

问题描述：默认stat函数会追踪符号链接目标，可能导致安全风险或逻辑错误。

解决方法：

使用lstat区分链接：若需获取符号链接自身信息（而非目标文件），用lstat代替stat。
显式检查文件类型：用S_ISLNK(st_mode)判断是否为符号链接。

示例代码：

struct stat st;
if (lstat("/tmp/link", &st) == 0) {
    if (S_ISLNK(st.st_mode)) {
        printf("这是一个符号链接\n");
    }
}

3.3. 跨平台类型兼容性

问题描述：off_t、time_t等类型的大小可能因架构（32/64位）或编译器选项（如_FILE_OFFSET_BITS=64）不同而变化。

解决方法：

强制类型转换：格式化输出时使用long long确保兼容性。
启用大文件支持：在编译时添加-D_FILE_OFFSET_BITS=64。

示例代码：

printf("文件大小：%lld\n", (long long)st.st_size);  // 兼容32/64位系统

3.4. 权限与访问控制

问题描述：嵌入式设备可能以低权限用户（如nobody）运行程序，导致stat因权限不足失败（EACCES）。

解决方法：

检查路径可访问性：确保目标路径的父目录具有执行（X）权限。
验证文件所有者：通过st_uid和st_gid确认文件归属。

示例代码：

struct stat st;
if (stat("/etc/config", &st) == -1) {
    if (errno == EACCES) {
        printf("错误：权限不足\n");
    }
}

if (st.st_uid != 0) {
    printf("警告：配置文件所有者非root\n");
}

3.5. 时间戳与时区处理

问题描述：st_mtime等时间戳为UTC时间，直接转换可能因嵌入式系统未配置时区导致本地时间错误。

解决方法：

使用UTC时间：优先使用gmtime而非localtime，避免依赖时区配置。
手动时区修正：若需本地时间，确保嵌入式系统已正确配置时区文件。

示例代码：

struct tm *tm_info = gmtime(&st.st_mtime);  // 使用UTC时间
strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", tm_info);

3.6. 错误处理与竞态条件

问题描述：文件可能在stat调用后被删除或修改（TOCTOU攻击），导致后续操作不安全。

解决方法：

原子性操作：关键操作（如打开文件）应直接使用文件描述符结合fstat。
最小化时间窗口：减少stat与后续操作之间的延迟。

示例代码：

int fd = open("data.bin", O_RDONLY);
if (fd != -1) {
    struct stat st;
    fstat(fd, &st);  // 通过文件描述符获取信息，避免竞态
    // 安全操作文件
}

3.7. 资源消耗优化

问题描述：频繁调用stat可能增加I/O负载，影响嵌入式系统性能（尤其在低端CPU或慢速存储介质上）。

解决方法：

缓存元数据：对静态文件缓存st_size、st_mtime等字段。
减少调用频率：使用inotify替代轮询（需内核支持）。

示例代码：

static time_t last_mtime = 0;
if (stat("config.cfg", &st) == 0) {
    if (st.st_mtime > last_mtime) {
        reload_config();
        last_mtime = st.st_mtime;  // 缓存修改时间
    }
}

3.8. 特殊文件处理

问题描述：嵌入式设备可能包含字符设备、管道等特殊文件，需明确区分文件类型。

解决方法：

严格类型检查：使用S_ISCHR()、S_ISFIFO()等宏验证文件类型。
拒绝非预期类型：若要求普通文件，需主动过滤其他类型。

示例代码：

struct stat st;
stat("/dev/ttyS0", &st);
if (S_ISCHR(st.st_mode)) {
    open_serial_device();
} else {
    printf("错误：非字符设备\n");
}

3.9. 小结

在嵌入式Linux中使用stat函数时，需重点关注：

嵌入式文件系统特性（字段可靠性、权限模型）
安全防护（符号链接处理、竞态条件）
资源优化（减少I/O、缓存策略）
跨平台兼容性（类型转换、编译选项）

结合fstat、lstat和inotify等机制，可构建更健壮、高效的嵌入式文件操作逻辑。

四、常见问题

4.1. 路径或权限问题

问题现象：stat返回-1，错误码为ENOENT（文件不存在）或EACCES（权限不足）。

原因：

文件路径错误（绝对路径/相对路径问题）。
用户权限不足，无法访问目标文件或父目录。

解决方案：

检查路径是否正确（嵌入式系统中路径可能受根文件系统限制）。
使用access函数预检查文件是否存在或权限。
通过errno获取具体错误信息：

if (stat("/path/to/file", &st) == -1) {
    perror("stat failed");
}

4.2. 结构体成员误解

常见错误：对struct stat成员理解不准确。

示例：

struct stat st;
stat("file.txt", &st);
printf("File size: %d bytes\n", st.st_size);  // 错误！st_size类型是off_t

修正：

printf("File size: %lld bytes\n", (long long)st.st_size);  // 正确转换类型

4.3. 符号链接处理

问题：stat会跟随符号链接，而lstat不会。

示例：

struct stat st;
// 若文件是符号链接，stat返回目标文件信息，lstat返回链接本身信息
if (lstat("/path/to/link", &st) == 0) {
    if (S_ISLNK(st.st_mode)) {
        printf("This is a symbolic link\n");
    }
}

4.4. 时间戳处理

问题：st_atime、st_mtime、st_ctime是time_t类型，需转换为可读格式。

示例：

char buffer[80];
struct tm *tm_info = localtime(&st.st_mtime);
strftime(buffer, 80, "%Y-%m-%d %H:%M:%S", tm_info);
printf("Last modified: %s\n", buffer);

4.5. 文件类型判断

错误方式：直接比较st_mode与S_IFREG等宏。

if (st.st_mode == S_IFREG)  // 错误！未屏蔽其他位

正确方式：使用宏函数（如S_ISREG）：

if (S_ISREG(st.st_mode)) {
    printf("Regular file\n");
} else if (S_ISDIR(st.st_mode)) {
    printf("Directory\n");
}

4.6. 跨平台兼容性

问题：不同系统对struct stat字段定义可能不同（如st_atim vs st_atime）。

解决方案：

使用POSIX标准宏（如st_mtime）。
在支持大文件的系统中使用stat64：

struct stat64 st;
stat64("/large_file", &st);

4.7. 缓存与实时性问题

问题：stat获取的是调用时刻的快照，文件状态可能随后被修改。
场景：多进程/线程环境下，文件可能在两次stat调用之间被更改。
建议：对关键操作（如文件读写）使用原子操作或文件锁。

4.8. 错误处理缺失

常见漏洞：未检查stat返回值直接使用结构体。

stat("file", &st);
// 如果stat失败，st内容未定义！

修正：

if (stat("file", &st) == 0) {
    // 成功时处理
} else {
    // 处理错误
}

4.9. 小结

使用stat时需注意：

始终检查返回值并处理错误。
正确理解struct stat成员类型（如off_t、time_t）。
区分stat和lstat。
使用标准宏（如S_ISDIR）判断文件类型。
注意嵌入式环境的路径和权限限制。

通过合理处理这些问题，可以避免大多数由stat引发的嵌入式Linux应用异常。

五、参考文献

《Unix 环境高级编程（第 3 版）》
- 作者是 Richard A. Stevens 和 Stephen A. Rago。这本书是 Unix 和 Linux 编程领域的经典之作，对 stat 函数进行了详细且全面的讲解。它不仅介绍了 stat 函数的基本用法、参数含义，还深入探讨了其在不同 Unix 环境下的实现细节和使用场景。
《Linux 设备驱动开发详解：基于最新的 Linux 4.0 内核》
- 由宋宝华编著。本书聚焦于 Linux 设备驱动开发，其中对文件系统相关的系统调用，包括 stat 函数，有较为深入的分析。它结合设备驱动开发的实际需求，讲解了如何利用 stat 函数获取设备文件的属性信息，对于嵌入式 Linux 开发者理解 stat 函数在设备驱动开发中的应用有很大帮助。
《Linux C 编程实战（第 3 版）》
- 作者是杨宗德。书中包含了大量实用的 Linux C 编程技巧和案例，对 stat 函数的讲解结合了具体的编程实例，详细展示了如何使用 stat 函数进行文件权限检查、文件大小获取等操作。通过阅读这本书，可以快速掌握 stat 函数在实际编程中的应用方法。
Linux 手册页（man pages）
- 在 Linux 系统中，使用 man stat 命令可以查看 stat 函数的详细手册页。手册页提供了 stat 函数的官方文档，包括函数原型、参数说明、返回值、错误处理以及相关的注意事项等内容。这是获取 stat 函数最准确和最新信息的重要来源。
The Linux Documentation Project（TLDP）
- 网址为 The Linux Documentation Project 。该网站提供了丰富的 Linux 文档资源，其中包含了关于文件系统和系统调用的详细介绍。在相关文档中，对 stat 函数的原理、用法和应用场景有较为深入的阐述，同时还提供了一些示例代码和编程技巧。
GNU C Library Documentation
- 网址是 https://www.gnu.org/software/libc/manual/ 。GNU C 库是 Linux 系统中广泛使用的 C 库，该文档对 stat 函数在 GNU C 库中的实现和使用进行了详细说明。它不仅包含了函数的基本信息，还介绍了与 stat 函数相关的其他函数和宏定义，有助于读者全面了解 stat 函数在 C 编程中的应用。
Stack Overflow
- 网址为 https://stackoverflow.com/ 。这是一个知名的技术问答社区，有大量关于 stat 函数的问题和解答。开发者可以在这里找到关于 stat 函数使用过程中遇到的各种问题的解决方案，同时还能了解到其他开发者在实际项目中使用 stat 函数的经验和技巧。
CSDN
- 网址是 https://www.csdn.net/ 。CSDN 是国内知名的技术社区，有许多开发者分享了关于嵌入式 Linux 开发和 stat 函数的相关文章。
开源中国（OSChina）
- 网址为 OSCHINA - 中文开源技术交流社区。该社区汇聚了众多开源项目和开发者，有不少关于 Linux 开发的技术文章和讨论。

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2026-01-20，如有侵权请联系 cloudcommunity@tencent.com 删除

嵌入式