NAME

astat − get status of an asynchronous file read

SYNOPSIS

int astat(fildes) int fildes;

DESCRIPTION

fildes is a file descriptor obtained from a creat(2), open(2), or fcntl(2), system call.

astat returns the status of a pending asynchronous file read operation.  Upon return from the call, and if the file was opened with the O_BASYNC flag, a 1 is returned if the read is complete, and 0 is returned if the read is still pending. 

If the file was not opened with the O_BASYNC flag, a 1 is returned. 

astat fails if one or more of the following are true:

[EBADF] fildes is not a valid file descriptor open for reading. 

[EINTR] A signal was caught during the await(2) system call.

SEE ALSO

creat(2), fcntl(2), open(2), read(2), await(2)

September 02, 1992