fstat

Obtains information about an open file.

Library:LibC
Classification:POSIX
Service:File and Directory I/O

Syntax

  #include <sys/stat.h> 
   
  int fstat (
     int            fildes,   
     struct stat   *buf);

Parameters

fildes

(IN) Specifies a file handle.

buf

(OUT) Points to the address of the structure stat.

Return Values

If successful, returns 0. Otherwise, returns -1 and sets errno to one of the following:

Decimal

Constant

Description

4

EBADF

The fides parameter does not specify an open file.

28

EIO

An I/O error occurred while reading from the file system.

81

EOVERFLOW

Either one of the values is too large to store into the structure pointed to by the buf argument, or the file's size, its number of blocks, or its serial number cannot be stored correctly in the structure.

Remarks

The fstat function obtains information about an open file whose file descriptor is the fildes parameter. This information is placed in the structure located at the address indicated by the buf parameter.

The sys/stat.h header file contains definitions for the stat structure and describes the contents of the fields within that structure.

See Also

stat