focal (2) aio_error.2freebsd.gz

Provided by: freebsd-manpages_12.0-1_all bug

NAME
     aio_error — retrieve error status of asynchronous I/O operation (REALTIME)


LIBRARY
     Standard C Library (libc, -lc)


SYNOPSIS
     #include <aio.h>

     int
     aio_error(const struct aiocb *iocb);


DESCRIPTION
     The aio_error() system call returns the error status of the asynchronous I/O request associated with the
     structure pointed to by iocb.


RETURN VALUES
     If the asynchronous I/O request has completed successfully, aio_error() returns 0.  If the request has not
     yet completed, EINPROGRESS is returned.  If the request has completed unsuccessfully the error status is
     returned as described in read(2), write(2), or fsync(2).  On failure, aio_error() returns -1 and sets errno
     to indicate the error condition.


ERRORS
     The aio_error() system call will fail if:

     [EINVAL]           The iocb argument does not reference an outstanding asynchronous I/O request.


SEE ALSO
     aio_cancel(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2), fsync(2), read(2), write(2),
     aio(4)


STANDARDS
     The aio_error() system call is expected to conform to the IEEE Std 1003.1 (“POSIX.1”) standard.


HISTORY
     The aio_error() system call first appeared in FreeBSD 3.0.


AUTHORS
     This manual page was written by Wes Peters <wes@softweyr.com>.