fstat - get file state information
Standard C Library (libc, -lc)
#include <sys/stat.h>
int
fstat(int fd,
struct stat *statbuf);
fstat retrieves status information about the file referred to by the file handle fd and stores it in the stat structure pointed to by statbuf.
The call (like all system calls) should be atomic; that is, the information retrieved should come from a single point in time.
On success, fstat returns 0. On error, -1 is returned, and errno is set according to the error encountered.
The following error codes should be returned under the conditions given. Other error codes may be returned for other cases not mentioned here.
| EBADF | fd is not a valid file handle. | |
| EIO | A hard I/O error occurred. | |
| EFAULT | statbuf points to an invalid address. |