stat(2) - Linux 手册页

符合

这些系统调用符合 SVr4、4.3BSD、POSIX.1-2001。

根据 POSIX.1-2001，对符号链接使用 lstat() 仅需在 stat 结构体中返回 st_size 字段和 st_mode 字段的文件类型部分中的有效信息。POSIX.1-2008 强化了该规范，要求 lstat() 在除 st_mode 中的权限位之外的所有字段中都返回有效信息。

使用 st_blocks 和 st_blksize 字段的可移植性可能较差。（它们是在 BSD 中引入的。在不同系统之间，甚至在同一系统涉及 NFS 挂载时，解释可能会有所不同。）如果需要从 <sys/stat.h> 获取 blkcnt_t 或 blksize_t 类型的定义，请定义 _XOPEN_SOURCE 且值为 500 或更高（在包含任何头文件之前）。

POSIX.1-1990 未描述 S_IFMT, S_IFSOCK, S_IFLNK, S_IFREG, S_IFBLK, S_IFDIR, S_IFCHR, S_IFIFO, S_ISVTX 常量，而是要求使用 S_ISDIR() 等宏。S_IF* 常量在 POSIX.1-2001 及更高版本中存在。

S_ISLNK() 和 S_ISSOCK() 宏不在 POSIX.1-1996 中，但在 POSIX.1-2001 中两者都存在；前者来自 SVID 4，后者来自 SUSv2。

UNIX V7（及后续系统）有 S_IREAD, S_IWRITE, S_IEXEC，而 POSIX 规定了其同义词 S_IRUSR, S_IWUSR, S_IXUSR。

其他系统

在各种系统中使用过（或正在使用）的值

粘滞位命令出现在 AT&T UNIX 第 32V 版中。

说明

从内核 2.5.48 开始，stat 结构体支持三个文件时间戳字段的纳秒级分辨率。如果定义了 _BSD_SOURCE 或 _SVID_SOURCE 特性测试宏，Glibc 会使用 st_atim.tv_nsec 格式的名称公开每个字段的纳秒分量。这些字段在 POSIX.1-2008 中有规定，且自 2.12 版本起，如果定义了 _POSIX_C_SOURCE 且值为 200809L 或更高，或者定义了 _XOPEN_SOURCE 且值为 700 或更高，glibc 也会公开这些字段名称。如果未定义上述任何宏，则纳秒值将以 st_atimensec 格式的名称公开。在不支持亚秒时间戳的文件系统上，纳秒字段返回的值为 0。

在 Linux 上，lstat() 通常不会触发自动挂载程序操作，而 stat() 会触发（但请参阅 fstatat(2)）。

对于 /proc 目录下的大多数文件，stat() 不会返回 st_size 字段中的文件大小；相反，该字段返回的值为 0。

底层内核接口

随着时间的推移，stat 结构体大小的增加导致了三个连续版本的 stat()：sys_stat() (插槽 __NR_oldstat), sys_newstat() (插槽 __NR_stat), 和 sys_stat64() (内核 2.4 中新增；插槽 __NR_stat64)。Glibc 的 stat() 包装函数对应用程序隐藏了这些细节，调用内核提供的最新版本的系统调用，并在需要时为旧二进制文件重新打包返回的信息。对于 fstat() 和 lstat() 也适用类似的说明。

示例

以下程序调用 stat() 并显示返回的 stat 结构体中选定的字段。

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

int
main(int argc, char *argv[])
{
    struct stat sb;

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

   if (stat(argv[1], &sb) == -1) {
        perror("stat");
        exit(EXIT_FAILURE);
    }

   printf("File type:                ");

   switch (sb.st_mode & S_IFMT) {
    case S_IFBLK:  printf("block device\n");            break;
    case S_IFCHR:  printf("character device\n");        break;
    case S_IFDIR:  printf("directory\n");               break;
    case S_IFIFO:  printf("FIFO/pipe\n");               break;
    case S_IFLNK:  printf("symlink\n");                 break;
    case S_IFREG:  printf("regular file\n");            break;
    case S_IFSOCK: printf("socket\n");                  break;
    default:       printf("unknown?\n");                break;
    }

   printf("I-node number:            %ld\n", (long) sb.st_ino);

   printf("Mode:                     %lo (octal)\n",
            (unsigned long) sb.st_mode);

   printf("Link count:               %ld\n", (long) sb.st_nlink);
    printf("Ownership:                UID=%ld   GID=%ld\n",
            (long) sb.st_uid, (long) sb.st_gid);

   printf("Preferred I/O block size: %ld bytes\n",
            (long) sb.st_blksize);
    printf("File size:                %lld bytes\n",
            (long long) sb.st_size);
    printf("Blocks allocated:         %lld\n",
            (long long) sb.st_blocks);

   printf("Last status change:       %s", ctime(&sb.st_ctime));
    printf("Last file access:         %s", ctime(&sb.st_atime));
    printf("Last file modification:   %s", ctime(&sb.st_mtime));

   exit(EXIT_SUCCESS);
}

参见

access(2), chmod(2), chown(2), fstatat(2), readlink(2), utime(2), capabilities(7), symlink(7)

引用自