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)