C語言stat()函數：獲取文件狀態
頭文件：

#include <sys/stat.h>  #include <unistd.h>

定義函數：

int stat(const char * file_name, struct stat *buf);

函數說明：stat()用來將參數file_name 所指的文件狀態, 復制到參數buf 所指的結構中。

下面是struct stat 內各參數的說明：

struct stat{  dev_t st_dev; //device 文件的設備編號  ino_t st_ino; //inode 文件的i-node  mode_t st_mode; //protection 文件的類型和存取的權限  nlink_t st_nlink; //number of hard links 連到該文件的硬連接數目, 剛建立的文件值為1.  uid_t st_uid; //user ID of owner 文件所有者的用戶識別碼  gid_t st_gid; //group ID of owner 文件所有者的組識別碼  dev_t st_rdev; //device type 若此文件為裝置設備文件, 則為其設備編號  off_t st_size; //total size, in bytes 文件大小, 以字節計算  unsigned long st_blksize; //blocksize for filesystem I/O 文件系統的I/O 緩沖區大小.  unsigned long st_blocks; //number of blocks allocated 占用文件區塊的個數, 每一區塊大小為512 個字節.  time_t st_atime; //time of lastaccess 文件最近一次被存取或被執行的時間, 一般只有在用mknod、utime、read、write 與tructate 時改變.  time_t st_mtime; //time of last modification 文件最后一次被修改的時間, 一般只有在用mknod、utime 和write 時才會改變  time_t st_ctime; //time of last change i-node 最近一次被更改的時間, 此參數會在文件所有者、組、權限被更改時更新};

先前所描述的st_mode 則定義了下列數種情況：
1、S_IFMT 0170000 文件類型的位遮罩
2、S_IFSOCK 0140000 scoket
3、S_IFLNK 0120000 符號連接
4、S_IFREG 0100000 一般文件
5、S_IFBLK 0060000 區塊裝置
6、S_IFDIR 0040000 目錄
7、S_IFCHR 0020000 字符裝置
8、S_IFIFO 0010000 先進先出
9、S_ISUID 04000 文件的 (set user-id on execution)位
10、S_ISGID 02000 文件的 (set group-id on execution)位
11、S_ISVTX 01000 文件的sticky 位
12、S_IRUSR (S_IREAD) 00400 文件所有者具可讀取權限
13、S_IWUSR (S_IWRITE)00200 文件所有者具可寫入權限
14、S_IXUSR (S_IEXEC) 00100 文件所有者具可執行權限
15、S_IRGRP 00040 用戶組具可讀取權限
16、S_IWGRP 00020 用戶組具可寫入權限
17、S_IXGRP 00010 用戶組具可執行權限
18、S_IROTH 00004 其他用戶具可讀取權限
19、S_IWOTH 00002 其他用戶具可寫入權限
20、S_IXOTH 00001 其他用戶具可執行權限上述的文件類型在 POSIX 中定義了檢查這些類型的宏定義
21、S_ISLNK (st_mode) 判斷是否為符號連接
22、S_ISREG (st_mode) 是否為一般文件
23、S_ISDIR (st_mode) 是否為目錄
24、S_ISCHR (st_mode) 是否為字符裝置文件
25、S_ISBLK (s3e) 是否為先進先出
26、S_ISSOCK (st_mode) 是否為socket 若一目錄具有sticky 位 (S_ISVTX), 則表示在此目錄下的文件只能被該文件所有者、此目錄所有者或root 來刪除或改名.

返回值：執行成功則返回0，失敗返回-1，錯誤代碼存于errno。

錯誤代碼：
1、ENOENT 參數file_name 指定的文件不存在
2、ENOTDIR 路徑中的目錄存在但卻非真正的目錄
3、ELOOP 欲打開的文件有過多符號連接問題, 上限為16 符號連接
4、EFAULT 參數buf 為無效指針, 指向無法存在的內存空間
5、EACCESS 存取文件時被拒絕
6、ENOMEM 核心內存不足
7、ENAMETOOLONG 參數file_name 的路徑名稱太長

范例

#include <sys/stat.h>#include <unistd.h>main(){  struct stat buf;  stat("/etc/passwd", &buf);  printf("/etc/passwd file size = %d /n", buf.st_size);}

執行：

/etc/passwd file size = 705

C語言fstat()函數：由文件描述詞取得文件狀態
頭文件：

 #include <sys/stat.h>  #include <unistd.h>

定義函數：

int fstat(int fildes, struct stat *buf);

函數說明：fstat()用來將參數fildes 所指的文件狀態, 復制到參數buf 所指的結構中(struct stat). Fstat()與stat()作用完全相同, 不同處在于傳入的參數為已打開的文件描述詞. 詳細內容請參考stat().

返回值：執行成功則返回0, 失敗返回-1, 錯誤代碼存于errno.

范例

#include <sys/stat.h>#include <unistd.h>#include <fcntk.h>main(){  struct stat buf;  int fd;  fd = open("/etc/passwd", O_RDONLY);  fstat(fd, &buf);  printf("/etc/passwd file size +%d/n ", buf.st_size);}

執行：

/etc/passwd file size = 705

C語言lstat()函數：由文件描述詞取得文件狀態
頭文件：

#include <sys/stat.h>  #include <unistd.h>

定義函數：

int lstat (const char * file_name, struct stat * buf);

函數說明：lstat()與stat()作用完全相同, 都是取得參數file_name 所指的文件狀態, 其差別在于, 當文件為符號連接時, lstat()會返回該link 本身的狀態. 詳細內容請參考stat().

返回值：執行成功則返回0, 失敗返回-1, 錯誤代碼存于errno.

范例：參考stat()。