fgetstat

Obtains selected information about an open file.

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

Syntax

  #include <fsio.h> 
   
  int fgetstat (
     int             fildes,
     struct stat    *buf,
     unsigned long   requestmap);

Parameters

fildes

(IN) Specifies a file handle.

buf

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

requestmap

(IN) Specifies a bit mask of the information to return. See Request Flags for Entry Status.

Return Values

If successful, returns 0. Otherwise, returns one of the following errors. Unlike fstat, errno is not set.

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 fgetstat 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 requestmap parameter determines which fields in the stat structure return with information. The fields not requested have undefined values.

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

See Also