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)