Click above to get retro games delivered to your door ever month!

 fstat()                 Get Information about Open File

 #include      <sys\stat.h>

 int           fstat(handle,buffer);
 int           handle;                   Handle referring to open file
 struct stat   *buffer;                  Pointer to results (a structure)

    fstat() gets and stores information about the open file associated
    with 'handle'.  The information is stored in the structure pointed to
    by 'buffer'.  The 'stat' structure (defined in <sys\stat.h>) has the
    following fields:

        st_mode     Bit mask that gives information about the file's
                    mode.  S_IFCHR bit is set if 'handle' refers to a
                    device.  S_IFREG is set if 'handle' refers to an
                    ordinary file.  One or both of S_IREAD and S_IWRITE
                    will be set according to the file's permission mode.

         st_dev     Drive number of the disk containing the file; file
                    handle if the file refers to a device.

        st_rdev     Same as 'st_dev'.

       st_nlink     Always set to the constant 1.

        st_size     Size of the file in bytes.

       st_atime     Time of the most recent modification of the file.

       st_mtime     Same as 'st_atime' and 'st_ctime'.

       st_ctime     Same as 'st_atime' and 'st_mtime'.

       Returns:     0, if successful.  On error, -1 is returned and
                    'errno' is set to EBADF (bad file handle).

         Notes:     The 'stat' structure contains three additional fields
                    that hold values that are not meaningful under MS-
                    DOS.

                    'st_size' and 'st_atime' (and therefore 'st_mtime'
                    and 'st_ctime') contain meaningless information if
                    'handle' refers to a device.

   -------------------------------- Example ---------------------------------

    The following statements open a preexisting file, and, if file status
    is obtained, print out the file size and last time accessed.

           #include <fcntl.h>
           #include <sys\stat.h>
           #include <stdio.h>
           #include <time.h>

           struct stat buffer;
           int status;
           FILE *stream;
           char ch;
           struct tm *acctime;

           main()
           {
               if((stream = fopen("input.dat","r+")) != NULL) {
                   if((status = fstat(fileno(stream),&buffer)) == 0)  {
                       printf("file status obtained.\n");
                       printf("file size is %ld\n",buffer.st_size);
                       acctime = gmtime(&buffer.st_atime);
                       printf("file last accessed: %s\n",asctime(acctime));
                   }
               }
           }