HP-UX Reference (11i v1 05/09) - 2 System Calls (vol 5)

fstat(2) fstat(2)

NAME

fstat - get ﬁle status

SYNOPSIS

#include <sys/types.h>

#include <sys/stat.h>

int fstat(int fildes, struct stat *buf);

DESCRIPTION

The fstat() function obtains information about an open ﬁle associated with the ﬁle descriptor ﬁldes, and

writes it to the area pointed to by buf. The buf argument is a pointer to a

stat structure, as deﬁned in

<sys/stat.h> , into which information is placed concerning the ﬁle.

The structure members st_mode, st_ino, st_dev, st_uid, st_gid, st_atime, st_ctime , and st_mtime will have

meaningful values for all ﬁle types deﬁned in this document. The value of the member st_nlink will be set

to the number of links to the ﬁle.

An implementation that provides additional or alternative ﬁle access control mechanisms may, under

implementation-dependent conditions, cause

fstat() to fail.

The

fstat() function updates any time-related ﬁelds as described in File Times Update (see the XBD

speciﬁcation, Chapter 4, Character Set), before writing into the stat structure.

RETURN VALUE

Upon successful completion, 0 is returned. Otherwise, −1 is returned and errno is set to indicate the

error.

When using fstat() to get the status of a socket descriptor, the following return values are also possible:

[EINPROGRESS] Nonblocking I/O is enabled using O_NONBLOCK, O_NODELAY, or

FIOSNBIO, and the connection cannot be completed immediately. This is

not a failure. Make the connect() call again a few seconds later. Alter-

natively, wait for completion by calling select() and selecting for write.

[EWOULDBLOCK] Non-blocking I/O is enabled using ioctl() FIOSNBIO request, and the

requested operation would block.

ERRORS

The fstat() function will fail if:

[EBADF] The ﬁldes argument is not a valid ﬁle descriptor.

[EIO] An I/O error occurred while reading from the ﬁle system.

The fstat() function may fail if:

[EOVERFLOW] One of the values is too large to store into the structure pointed to by the

buf argument.