文件和目录之stat族函数——APUE学习笔记

一. 函数原型及具体数据结构：

#include <sys/stat.h>

int stat(const char *retrict pathname, struct stat *restrict buf);
int fstat(int fd, struct stat *buf);
int lstat(const char *restrict pathname, struct stat *restrict buf);
int fstatat(int dirfd, const char *restrict pathname, struct stat *restrict buf, int flag);

所有四个函数返回值：成功返回0，出错返回-1.

其中buf指针为结构体指针，其结构如下：

struct stat {
      dev_t            st_dev; /* device number (file system) */
      dev_t            st_rdev; /* device number for special files */
      ino_t            st_ino; /* inode number (serial number)*/
      mode_t           st_mode; /* file type & mode (permissions) */
      nlink_t          st_nlink; /* number of hard links */
      uid_t            st_uid; /* user ID of owner */
      gid_t            st_gid; /* group ID of owner */
      off_t            st_size; /* size in bytes, for regular files */
      blksize_t        st_blksize; /* best IO block size*/
      blkcnt_t         st_blocks; /* number of 512B blocks allocated */
      struct timespec  st_atime; /* time of last access */
      struct timespec  st_mtime; /* time of last modification */
      struct timespec  st_ctime; /* time of last status change */
};

结构体中的结构体成员timespce分别包含以秒和纳秒为单位定义的时间，timespec提供更高的时间戳：结构如下：

struct timespec{
    time_t tv_sec ;
    long   tv_nsec;
};

二. stat族函数各自用途：
1.stat函数能根据pathname得到以此name命名的文件的信息结构。

2.lstat能够根据pathname得到以此name命名的*连接文件*的信息结构。
--> 注意：lstat列出的是符号连接文件本身，而不是连接引用的文件。
--> 用途：需要以降序遍历目录层次结构时。

3.fstatat根据文件描述符得到相应文件的信息结构。

4.fstatat函数操作的函数为：由fd参数指向的相对于当前打开目录的路径名，返回文件统计信息。
参数：
(1). dirfd: 如果该参数被设置为AT_FDCWD时有以下两种情况：
--> 当pathname为相对路径时：fstatat会自己计算pathname相对于但当前目录的参数。
--> 当pathname为绝对路径时：dirfd参数会被丢弃。

(2). flag：该参数控制着是否跟随着一个符号连接，如下：
--> flag默认情况下，fstata函数返回符号连接指向的实际文件信息。
--> 当AT_SYMLINK_NOFOLLOW标志被设置，fstata不跟随符号连接，而回返回符号连接本身信息。

强大的fstatat：
fstatat函数通过改变flag参数的值，可以分别实现其余stat族函数的功能。

三. 实际应用：
stat族函数使用最多的地方可能就是ls -l命令，此命令可以获得当前目录下的文件所有信息。

http://blog.csdn.net/riyadh_linux/article/details/49935819