readdir返回的dirent结构体详解

readdir函数是用于读取目录内容的系统调用，它返回一个指向dirent结构体的指针。dirent结构体包含了关于目录中条目的信息。以下是dirent结构体的详细解释：

dirent 结构体定义

struct dirent {
    long d_ino;             // inode号
    off_t d_off;            // 偏移量
    unsigned short d_reclen; // 名称长度
    unsigned char d_type;     // 文件类型
    char d_name[];            // 文件名（以null结尾）
};

字段解释

1. d_ino:

   • 类型：long
   • 描述：该目录条目的inode号。inode是文件系统中的一个数据结构，包含了文件的元数据，如文件大小、权限、所有者等。

2. d_off:

   • 类型：off_t
   • 描述：该目录条目在目录文件中的偏移量。这个偏移量可以用于后续的readdir调用以继续读取下一个条目。

3. d_reclen:

   • 类型：unsigned short
   • 描述：目录条目名称的长度（不包括null终止符）。这个长度用于确定d_name字段的实际长度。

4. d_type:

   • 类型：unsigned char
   • 描述：文件类型。常见的文件类型包括：
     • DT_REG: 普通文件
     • DT_DIR: 目录
     • DT_LNK: 符号链接
     • DT_BLK: 块设备文件
     • DT_CHR: 字符设备文件
     • DT_FIFO: 管道（FIFO）
     • DT_SOCK: 套接字
   • 注意：在某些系统上，d_type可能不被支持或返回DT_UNKNOWN。

5. d_name:

   • 类型：char[]
   • 描述：目录条目的名称。这是一个以null终止的字符串，长度由d_reclen指定。

使用示例

以下是一个简单的示例，展示如何使用readdir函数读取目录内容：

#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <sys/types.h>
#include <sys/stat.h>

int main(int argc, char *argv[]) {
    DIR *dir;
    struct dirent *entry;

    if (argc != 2) {
        fprintf(stderr, "Usage: %s <directory>\n", argv[0]);
        return EXIT_FAILURE;
    }

    dir = opendir(argv[1]);
    if (dir == NULL) {
        perror("opendir");
        return EXIT_FAILURE;
    }

    while ((entry = readdir(dir)) != NULL) {
        printf("Inode: %ld, Name: %s, Type: %d\n", entry->d_ino, entry->d_name, entry->d_type);
    }

    closedir(dir);
    return EXIT_SUCCESS;
}

在这个示例中，程序打开一个目录并逐个读取其条目，打印每个条目的inode号、名称和类型。

注意事项

• readdir函数返回的dirent结构体是由内核分配的，因此不需要手动释放内存。
• d_name字段的长度可能小于d_reclen指定的长度，因此在处理文件名时应小心。
• 在某些系统上，d_type字段可能不被支持，返回DT_UNKNOWN。

通过理解dirent结构体的各个字段，可以更有效地处理目录中的文件和子目录。