UNIX - stat、fstat和lstat函数，获取文件信息结构

stat、fstat和lstat函数返回一个文件的有关信息。

函数声明

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

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

函数说明
stat（）获取由path指定文件的信息。
lstat（）类似于stat（），但是当path是一个符号链接时，它返回该符号链接的有关信息，而不是该符号链接引用的文件的信息。
fstat（）获取文件描述符为fd的已打开文件的有关信息。

这些函数调用返回一个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 file system I/O */
     blkcnt_t  st_blocks;  /* number of 512B 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 */
};

文件类型信息包含在stat结构体的st_mode成员中。使用下面的宏可确定文件类型，这些宏的参数都是stat结构体的st_mode成员。

S_ISDIR()   目录；
S_ISCHR()   字符文件；
S_ISBLK()   块文件；
S_ISREG()   普通文件；
S_FIFO()    管道或FIFO；
S_ISLNK()   符号链接；
S_ISSOCK()  套接字；

这些宏在/usr/include/sys/stat.h中定义：

/* Test macros for file types.  */

#define __S_ISTYPE(mode, mask)  (((mode) & __S_IFMT) == (mask))

#define S_ISDIR(mode)    __S_ISTYPE((mode), __S_IFDIR)
#define S_ISCHR(mode)    __S_ISTYPE((mode), __S_IFCHR)
#define S_ISBLK(mode)    __S_ISTYPE((mode), __S_IFBLK)
#define S_ISREG(mode)    __S_ISTYPE((mode), __S_IFREG)
#ifdef __S_IFIFO
# define S_ISFIFO(mode)  __S_ISTYPE((mode), __S_IFIFO)
#endif
#ifdef __S_IFLNK
# define S_ISLNK(mode)   __S_ISTYPE((mode), __S_IFLNK)
#endif

#if defined __USE_BSD && !defined __S_IFLNK
# define S_ISLNK(mode)  0
#endif

#if (defined __USE_BSD || defined __USE_UNIX98 || defined __USE_XOPEN2K) \
    && defined __S_IFSOCK
# define S_ISSOCK(mode) __S_ISTYPE((mode), __S_IFSOCK)
#elif defined __USE_XOPEN2K
# define S_ISSOCK(mode) 0
#endif

宏__S_IFDIR … __S_IFSOCK在/usr/include/bits/stat.h定义：

/* Encoding of the file mode.  */

#define __S_IFMT        0170000 /* These bits determine file type.  */

/* File types.  */
#define __S_IFDIR       0040000 /* Directory.  */
#define __S_IFCHR       0020000 /* Character device.  */
#define __S_IFBLK       0060000 /* Block device.  */
#define __S_IFREG       0100000 /* Regular file.  */
#define __S_IFIFO       0010000 /* FIFO.  */
#define __S_IFLNK       0120000 /* Symbolic link.  */
#define __S_IFSOCK      0140000 /* Socket.  */

通过sys/stat.h和bits/stat.h中的定义可将宏S_ISDIR（）展开为：

(((mode) & 0170000) == 004000

其它的宏展开类似。