Nios II Classic Software Developer’s Handbook

ID 683282
Date 5/14/2015
Public
Document Table of Contents

14.1.60. fstat()

Prototype

int fstat (int fd, struct stat *st)

Commonly Called By

C/C++ programs

Device drivers

Thread-safe

See description.

Available from ISR

No.

Include

<sys/stat.h>

Description

The fstat() function obtains information about the capabilities of an open file descriptor. The underlying device driver fills in the input st structure with a description of its functionality. Refer to the header file sys/stat.h provided with the compiler for the available options.

By default, file descriptors are marked as character devices, unless the underlying driver provides its own implementation of the fstat() function.

Calls to fstat() are thread-safe only if the implementation of fstat() provided by the driver that is manipulated is thread-safe.

Valid values for the fd parameter are: stdout, stdin, and stderr, or any value returned from a call to open().

Return

The return value is zero on success, or –1 otherwise. If the call fails, errno is set to indicate the cause of the error.