aio_error(2) [hpux man page]

aio_error(2)							System Calls Manual						      aio_error(2)

NAME

       aio_error() - return error status of an asynchronous I/O operation

SYNOPSIS

DESCRIPTION

       The  function returns the error status of the asynchronous I/O operation that was initiated with the and referenced by The error status for
       an asynchronous I/O operation is the value set by the corresponding or function.

       To use this function, link in the realtime library by specifying on the compiler or linker command line.

RETURN VALUE

       If the is invalid or if no asynchronous I/O operation is enqueued for the returns and is set to indicate the error.  If the  operation  has
       been  queued  but  not  completed,  returns  Otherwise,	returns the error status of the referenced See aio_read(2), read(2), aio_write(2),
       write(2), aio_fsync(2), fsync(2), and lio_listio(2) for relevant error values.

ERRORS

       If detects one of the following error conditions, is set to the indicated value:

	      [EINVAL]	     There was no asynchronous I/O operation enqueued for the referenced

EXAMPLES

       The following code sequence illustrates using to retrieve the error status of an operation.

SEE ALSO

       aio_cancel(2), aio_fsync(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2), fsync(2), lio_listio(2), read(2), write(2), aio(5).

STANDARDS CONFORMANCE

																      aio_error(2)

AIO_ERROR(3)                                                 Linux Programmer's Manual                                                AIO_ERROR(3)

NAME

       aio_error - get error status of asynchronous I/O operation

SYNOPSIS

       #include <aio.h>

       int aio_error(const struct aiocb *aiocbp);

       Link with -lrt.

DESCRIPTION

       The  aio_error()  function  returns the error status for the asynchronous I/O request with control block pointed to by aiocbp.  (See aio(7)
       for a description of the aiocb structure.)

RETURN VALUE

       This function returns one of the following:

       *  EINPROGRESS, if the request has not been completed yet.

       *  ECANCELED, if the request was canceled.

       *  0, if the request completed successfully.

       *  A positive error number, if the asynchronous I/O operation failed.  This is the same value that would have  been  stored  in  the  errno
          variable in the case of a synchronous read(2), write(2), fsync(2), or fdatasync(2) call.

ERRORS

       EINVAL aiocbp does not point at a control block for an asynchronous I/O request of which the return status (see aio_return(3)) has not been
              retrieved yet.

       ENOSYS aio_error() is not implemented.

VERSIONS

       The aio_error() function is available since glibc 2.1.

ATTRIBUTES

       For an explanation of the terms used in this section, see attributes(7).

       +------------+---------------+---------+
       |Interface   | Attribute     | Value   |
       +------------+---------------+---------+
       |aio_error() | Thread safety | MT-Safe |
       +------------+---------------+---------+
CONFORMING TO

       POSIX.1-2001, POSIX.1-2008.

EXAMPLE

       See aio(7).

SEE ALSO

       aio_cancel(3), aio_fsync(3), aio_read(3), aio_return(3), aio_suspend(3), aio_write(3), lio_listio(3), aio(7)

COLOPHON

       This page is part of release 4.15 of the Linux man-pages project.  A description of the project, information about reporting bugs, and  the
       latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.

                                                                    2015-03-02                                                        AIO_ERROR(3)