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)