stat() - Unix，Linux 系统调用

名称

语法

int stat(const char *path, struct stat *buf);
int fstat(int filedes, struct stat *buf);
int lstat(const char *path, struct stat *buf);

描述

这些函数返回有关文件的信息。不需要对文件本身具有任何权限，但在 stat() 和 lstat() 的情况下，需要对通往文件的 path 中的所有目录具有执行（搜索）权限。

stat() 获取 path 指向的文件的状态并填充 buf。

lstat() 与 stat() 相同，但如果 path 是符号链接，则会获取链接本身的状态，而不是它所指向的文件的状态。

fstat() 与 stat() 相同，但要获取状态的文件由文件描述符 filedes 指定。

所有这些系统调用都返回一个 stat 结构，其中包含以下字段

struct stat {
    dev_t     st_dev;     /* ID of device containing file */
    ino_t     st_ino;     /* inode number */
    mode_t    st_mode;    /* protection */
    nlink_t   st_nlink;   /* number of hard links */
    uid_t     st_uid;     /* user ID of owner */
    gid_t     st_gid;     /* group ID of owner */
    dev_t     st_rdev;    /* device ID (if special file) */
    off_t     st_size;    /* total size, in bytes */
    blksize_t st_blksize; /* blocksize for filesystem I/O */
    blkcnt_t  st_blocks;  /* number of blocks allocated */
    time_t    st_atime;   /* time of last access */
    time_t    st_mtime;   /* time of last modification */
    time_t    st_ctime;   /* time of last status change */
};

st_dev 字段描述了此文件所在的设备。

st_rdev 字段描述了此文件（inode）表示的设备。

st_size 字段以字节为单位给出文件（如果它是常规文件或符号链接）的大小。符号链接的大小是它包含的路径名的长度，不包括尾随的空字节。

st_blocks 字段指示分配给文件的数据块数，以 512 字节为单位。（这可能小于 st_size/512，例如，当文件有空洞时。）

st_blksize 字段给出文件系统 I/O 的“首选”块大小。（以较小的块写入文件可能会导致效率低下的读-修改-重写。）

并非所有 Linux 文件系统都实现了所有时间字段。某些文件系统类型允许以这样一种方式挂载，即文件访问不会导致更新 st_atime 字段。（请参阅 mount(8) 中的“noatime”。）

st_atime 字段会因文件访问而更改，例如，由 execve(2)、mknod(2)、pipe(2)、utime(2) 和 read(2)（超过零个字节）更改。其他例程，如 mmap(2)，可能会也可能不会更新 st_atime。

st_mtime 字段会因文件修改而更改，例如，由 mknod(2)、truncate(2)、utime(2) 和 write(2)（超过零个字节）更改。此外，目录的 st_mtime 字段会因该目录中文件的创建或删除而更改。st_mtime 字段不会因所有者、组、硬链接计数或模式的更改而更改。

st_ctime 字段会因写入或设置 inode 信息（即所有者、组、链接计数、模式等）而更改。

以下 POSIX 宏定义用于使用 st_mode 字段检查文件类型

以下标志定义用于 st_mode 字段

设置组 ID 位 (S_ISGID) 有几种特殊用途。对于目录，它表示要对该目录使用 BSD 语义：在那里创建的文件从目录继承其组 ID，而不是从创建进程的有效组 ID 继承，并且在那里创建的目录也将设置 S_ISGID 位。对于未设置组执行位 (S_IXGRP) 的文件，设置组 ID 位表示强制文件/记录锁定。

目录上的“粘滞”位 (S_ISVTX) 意味着只有文件的所有者、目录的所有者和特权进程才能重命名或删除该目录中的文件。

Linux 说明

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

返回值

错误

符合标准

st_blocks 和 st_blksize 字段的使用可能不太可移植。（它们是在 BSD 中引入的。解释因系统而异，并且可能在单个系统上使用 NFS 挂载时存在差异。）

POSIX 没有描述 S_IFMT、S_IFSOCK、S_IFLNK、S_IFREG、S_IFBLK、S_IFDIR、S_IFCHR、S_IFIFO、S_ISVTX 位，而是要求使用宏 S_ISDIR() 等。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。

其他系统

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

另请参阅

• access (2)

• chmod (2)

• chown (2)

• fstatat (2)

• readlink (2)

• utime (2)