sys\stat.h

_fstat
_stat

_fstat

Header

sys\stat.h

Prototype

int _fstat(int fd, struct stat *buf);

Description

The _fstat function gets information about an open file fd and stores it in the structure pointed to by buf. Some of the fields in the _stat structure are:

Field/Description

st_dev: Drive number of disk containing file fd or value of fd if fd is a device.
st_mode: Bit map containing mode information on the open file. The bits in this mask are described in the following table.
st_nlink: Number of links (always 1).
st_rdev: Same as st_dev.
st_size: Size of open file in bytes.
st_mtime: Time last modified.
st_atime: Same as st_mtime
st_ctime: Same as st_mtime
st_mode will be a combination of these values:
Value/Is set if fd refers to...
_S_IFCHR: a character device.
_S_IFREG: a regular file, not a device.
_S_IREAD: a readable file or device.
_S_IWRITE: a wriatable file or device.

Synonym

Function: fstat
Structure: stat
Modes: S_IFCHR, S_IFREG, S_IREAD, S_IWRITE

Return Value

A value of 0 if file information is successfully obtained. If the return value is -1, errno is set to EBADF indicating a bad file handle.

Compatibility

DOS Windows 3.x Phar Lap DOSX Win32

See Also

_stat
findfirst
findnext
_isatty

Example

/* 	Example of _fstat */ 

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

void main () 
{   
   char filen[_MAX_PATH]; 
   char *date; 
   int res; 
   struct _stat fstat; 
   int fh; 

   printf (" Enter a filename: "); 
   gets (filen); 

   if ((fh = _open (filen, _O_RDONLY)) < 0) 
   {   
      perror (" Error opening file"); 
      exit (EXIT_FAILURE); 
   } 

   if ((res = _fstat (fh, &fstat)) != 0) 
   {   
      perror (" Failure calling _fstat"); 
      exit (EXIT_FAILURE); 
   } 

   date = asctime (localtime (& fstat. st_ctime)); 
   printf ("\nDate: %s", date); 
   printf (" Mode: %d\n", fstat. st_mode); 
   printf (" Size: %ld\n", fstat. st_size); 
}

Output

Enter a filename: _fstat. c
 
Date: Tue Jun 28 14: 11: 56 1994
Mode: -32330
Size: 760

_stat

Header

sys/stat.h
sys/types.h

Prototype

int _stat(char *path, struct _stat *buf);

Description

The _stat function gets information about a file or directory specified by path and store the information in the structure that buf points to. The structure contains the following fields:

st_dev: The drive number of the drive specified in path, or the default drive, if none is given.
st_mode: Bit map containing mode information on the open file, made up of the values below.
st_nlink: Always 1.
st_rdev: Same as st_dev.
st_size: Size of file in bytes.
st_mtime: Time last modified.
st_atime: For NT, time last accessed; or same as st_mtime.
st_ctime: For NT, time created; otherwise same as st_mtime.
st_ino: Always 0. (stat structure only)
st_uid: Always 0. (stat structure only)
st_gid: Always 0. (stat structure only)

Use the following values for st_mode:

_S_IFREG: Set if path refers to an ordinary file, not a directory.
_S_IREAD: Set if path refers to a readable file or directory.
_S_IWRITE: Set if path refers to a writable file or directory.
_S_IFDIR: Set if path refers to a directory.
_S_IEXEC: Set if path refers to an executable file or a directory.