#include <sys/stat.h>
int stat( const char *restrict pathname, struct stat *restrict buf );
int fstat( int filedes, struct stat *buf );
int lstat( const char *restrict pathname, struct stat *restrict buf );
三个函数的返回值：若成功则返回0，若出错则返回-1

关于上面函数声明中的restrict关键字的解释，可参考：http://blog.csdn.net/lovekatherine/article/details/1891806（具体如下）

今天读APUE，看到某个函数原型的声明：

int stat (  const char * restrict  pathname,struct stat * restrict buf);

这里的restrict让我觉得有些疑惑，一查原来是C99中增加的关键字那么restrict的意义是什么呢？

One of the new features in the recently approved C standard C99, is the restrict pointer qualifier. This qualifier can be applied to a data pointer to indicate that, during the scope of that pointer declaration, all data accessed through it will be accessed only through that pointer but not through any other pointer. The 'restrict' keyword thus enables the compiler to perform certain optimizations based on the premise that a given object cannot be changed through another pointer. Now you're probably asking yourself, "doesn't const already guarantee that?" No, it doesn't. The qualifier const ensures that a variable cannot be changed through a particular pointer. However, it's still possible to change the variable through a different pointer.

概括的说，关键字restrict只用于限定指针；该关键字用于告知编译器，所有修改该指针所指向内容的操作全部都是基于(base on)该指针的，即不存在其它进行修改操作的途径；这样的后果是帮助编译器进行更好的代码优化，生成更有效率的汇编代码。

举个简单的例子

很显然函数foo()的返回值是0，除非参数x和y的值相同。可以想象，99％的情况下该函数都会返回0而不是1。然而编译起必须保证生成100%正确的代码，因此，编译器不能将原有代码替换成下面的更优版本

啊哈，现在我们有了restrict这个关键字，就可以利用它来帮助编译器安全的进行代码优化了

最后注意一点，restrict是C99中定义的关键字，C++目前并未引入；在GCC可通过使用参数" -std=c99"来开启对C99的支持。

一旦给出pathname，stat函数就返回与此命名文件有关的信息结构。fstat函数获取已在描述符filedes上打开的有关信息。lstat函数类似于stat，但是当命名的文件是一个符号链接时，lstat返回该符号链接的有关信息，而不是由该符号链接引用文件的信息。

第二个参数buf是指针，它指向一个我们必须提供的结构。这些函数填写由buf指向的结构。该结构的实际定义可能随实现有所不同，但其基本形式是：

struct stat
{mode_t     st_mode;    /* file type & mode (permissions) */ino_t      st_ino;     /* i-node number (serial number) */dev_t      st_dev;     /* device number (file system) */dev_t      st_rdev;    /* device number for special files */nlink_t    st_nlink;   /* number of 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 */time_t     st_atime;   /* time of last access */time_t     st_mtime;   /* time of last modification */time_t     st_ctime;   /* time of last file status change */blksize_t  st_blksize; /* best I/O block size */blkcnt_t   st_blocks;  /* number of disk blocks allocated */
};

POSIX.1未要求st_rdev、st_blksize和st_blocks字段，Single UNIX Specification XSI扩展则定义了这些字段。

注意，该结构中的每一个成员都是基本系统数据类型。

使用stat函数最多的可能是ls -l命令，用其可以获得有关一个文件的所有信息。