stat.h File Reference

 st_dev The numeric ID of the device containing the file.
 st_ino The file's inode number.
 st_nlink
  The number of hard links to the file.

 st_atime Time when file data last accessed.
 Changed by the .Xr utimes 2, read and readv system calls.
 st_mtime Time when file data last modified.
 Changed by the mkdir, mkfifo, mknod, utimes, write and writev system calls.
 st_ctime Time when file status was last changed (inode data modification).
 Changed by the chmod, chown, creat, link, mkdir, mkfifo, mknod, rename, rmdir, symlink, truncate, unlink, utimes, write and writev system calls.
 st_birthtime
  Time when the inode was created.

 st_size The file size in bytes.
 st_blksize
  The optimal I/O block size for the file.
 st_blocks The actual number of blocks allocated for the file in 512-byte units.
 As short symbolic links are stored in the inode, this number may
 be zero.

 st_uid The user ID of the file's owner.
 st_gid The group ID of the file.
 st_mode
  Status of the file (see below).

 Test for a block special file.
 Test for a character special file.
 Test for a directory.
 Test for a pipe or FIFO special file.
 Test for a symbolic link. NOTE: Inode structure is not supported by Symbian OS and hence link count updation is not possible.
 Check for symbolic link would always fail because of this reason.
 Test for a regular file.
 Test for a socket.
 Test for a whiteout.

st_dev The numeric ID of the device containing the file. 
st_ino The file's inode number. 
st_nlink  The number of hard links to the file.

#ifndef _POSIX_SOURCE
#define st_atime st_atimespec.tv_sec
#define st_mtime st_mtimespec.tv_sec
#define st_ctime st_ctimespec.tv_sec
#endif

#define S_IFMT   0170000  // type of file
#define S_IFIFO  0010000  // named pipe (fifo) 
#define S_IFCHR  0020000  // character special 
#define S_IFDIR  0040000  // directory 
#define S_IFBLK  0060000  // block special 
#define S_IFREG  0100000  // regular 
#define S_IFLNK  0120000  // symbolic link 
#define S_IFSOCK 0140000  // socket 
#define S_IFWHT  0160000  // whiteout 
#define S_ISUID  0004000  // set user id on execution 
#define S_ISGID  0002000  // set group id on execution 
#define S_ISVTX  0001000  // save swapped text even after use 
#define S_IRUSR  0000400  // read permission, owner 
#define S_IWUSR  0000200  // write permission, owner 
#define S_IXUSR  0000100  // execute/search permission, owner 

/* Detailed description: Sample usage of stat system call
 Preconditions: Example.txt file should be present in working directory 
 */
#include <fcntl.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/stat.h>
int main()
{
  struct stat buf;
   if(stat("Example.txt"  , &buf;) < 0 )
   {
      printf("Failed to stat Example.txt");
      return -1;
   }
   printf("Stat system call succeeded");
   return 0;
 }
/*
 Detailed description: Sample usage of fstat system call

 */
#include <fcntl.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/stat.h>
int main()
{
  struct stat buf;
   int fd = open("Example.txt" , O_RDONLY | O_CREAT  , 0666);
   if(fstat(fd  , &buf;) < 0 ) 
   {
      printf("Failed to stat Example.txt");
      return -1;
   }
   printf("Stat system call succeeded");
   close(fd);
   return 0;
 }

Stat system call succeeded

Stat system call succeeded