ElfBoard 开发板上跑 Linux 系统做 C 语言开发时,判断文件类型基本都要搭配 stat、lstat、fstat 这三个获取文件属性的函数,再配合 S_ISxxx 系列类型检查宏使用,很多新手容易混淆 stat 和 lstat 对软链接的处理逻辑,直接用 stat 会穿透软链接去读取目标文件信息,而 lstat 会直接读取软链接本身属性,fstat 则需要先打开文件拿到文件描述符再读取。开发流程一般是先引入 sys/stat.h 头文件,调用 stat 类函数填充 struct stat 结构体,取出 st_mode 字段,传入类型检查宏,宏返回非 0 代表匹配该类型,0 代表不匹配,这套组合是 ElfBoard 嵌入式 Linux 文件遍历、资源筛选、固件脚本开发里最常用的类型判断方案。
一、前置基础函数(获取文件属性)
| 函数 | 头文件 | 核心作用 | 软链接处理特点 |
|---|---|---|---|
| stat | #include | 按文件路径读取文件属性 | 跟随软链接,拿到链接指向文件的信息 |
| lstat | #include | 按文件路径读取文件属性 | 不跟随软链接,直接读取软链接本身 |
| fstat | #include | 根据文件描述符读取属性 | 需要 open 打开文件,无法直接用路径 |
二、常用类型检查宏(ElfBoard 开发高频使用)
这一组本质是宏,开发文档里习惯统称类型检查函数,入参是 st_mode,返回非 0 为真:
- S_ISREG (m):判断是否普通文件
- S_ISDIR (m):判断是否目录
- S_ISLNK (m):判断是否符号链接(软链接),搭配 lstat 才能正常识别
- S_ISCHR (m):判断是否字符设备文件
- S_ISBLK (m):判断是否块设备文件
- S_ISFIFO (m):判断是否管道 FIFO 文件
- S_ISSOCK (m):判断是否 socket 套接字文件
三、简单使用示例(适配 ElfBoard)
include
include
int main(void){
struct stat buf;
lstat("/test", &buf);
if(S_ISDIR(buf.st_mode)){
printf("这是目录\n");
}else if(S_ISREG(buf.st_mode)){
printf("这是普通文件\n");
}
return 0;
}
编译后直接在 ElfBoard ELF2、ELF2Lite、ELF-RK3506 等板子的 Linux 环境运行。
四、使用注意事项
- 必须先调用 stat/lstat/fstat 成功,再执行类型检查,函数调用失败直接判断会出现异常结果
- 想要识别软链接,一定要用 lstat,stat 会自动解析链接指向的文件,S_ISLNK 直接返回 0
- 宏参数只能传入 st_mode,不能直接传文件路径或者 struct stat 结构体
- 所有接口遵循 POSIX 标准,ElfBoard 全系 Linux 镜像都原生支持,不需要额外安装库
【相关 FAQ】
问题 1:ElfBoard 里使用 S_ISLNK 类型检查函数识别不到软链接是什么原因?
回答 1:大概率是使用了 stat 而不是 lstat,stat 会追踪软链接指向目标文件,无法识别链接本身,想要用 S_ISLNK 类型检查函数判断软链接,必须换成 lstat 读取属性。
问题 2:ElfBoard 开发时,S_ISREG 这类类型检查函数属于标准库函数吗?
回答 2:S_ISREG 属于 POSIX 标准宏,在 ElfBoard Linux 环境下可以直接使用,不需要额外移植,只需要引入 sys/stat.h 头文件。
问题 3:ElfBoard 中 fstat 配合类型检查函数和 stat 有什么区别?
回答 3:fstat 依靠 open 得到的文件描述符读取属性,适合已经打开文件后的二次类型校验;stat 靠路径读取,适合还没有打开文件、提前做类型过滤的场景,二者都可以搭配同一套类型检查函数。
问题 4:ElfBoard 上遍历目录做文件筛选,优先选哪一个类型检查函数?
回答 4:遍历目录推荐 lstat + S_ISDIR、S_ISREG、S_ISLNK 组合,不会自动穿透软链接,避免遍历的时候重复扫描链接指向的目录,减少异常循环。
【参考资料】
[2026-11-17](stat (2) 手册)Debian Manpages
[2026-01-08](ElfBoard Linux 文件分类开发教程)电子发烧友
[2025-03-31](libelf elf_kind 接口文档)ManKier
[2024-12-13](ELF2 开发板产品规格书)ElfBoard 官网
[2024-08-31](ElfBoard C 语言函数基础)与非网
【免责声明】
本文内容仅针对飞凌 ElfBoard Linux 环境下的类型检查函数做技术科普,代码示例仅作学习调试使用,不保证直接适配所有定制固件;不同内核版本、自定义文件系统可能存在少量差异,正式项目需要自行充分测试验证。
