aio_error(3) [osf1 man page]

aio_error(3)						     Library Functions Manual						      aio_error(3)

NAME

       aio_error - Returns the error status of a specified asynchronous I/O operation (P1003.1b)

LIBRARY

       Asynchronous I/O Library (libaio, libaio_raw)

SYNOPSIS

       #include <aio.h>

       int aio_error (const struct
       aiocb *aiocbp);

PARAMETERS

       *aiocbp	   A pointer to the address of the aiocb structure.

DESCRIPTION

       The aio_error function returns the error status associated with the aiocb structure referenced by the aiocbp argument.  The error status is
       the errno value that is set by the corresponding asynchronous I/O read, write, or fsync operation.

       The aio_error function returns EINPROGRESS until the asynchronous I/O operation is complete. When  the  operation  is  complete,  call  the
       aio_return function to determine if the operation was successful.

RETURN VALUES

       If the asynchronous I/O operation was successful, a value of 0 is returned.

       If the asynchronous I/O operation has not yet completed, [EINPROGRESS] is returned.

       If the aio_error operation was canceled, [ECANCELED] is returned.

       On an unsuccessful call, the value returned corresponds to those error values returned for a failed read, write, or fsync operation.

ERRORS

       The aio_error function fails under the following conditions:

       [EINVAL]       The aiocbp argument does not refer to an asynchronous operation whose return status has not yet been retrieved.

RELATED INFORMATION

       Functions:  close(2),  exec(2),	_exit(2),  fork(2),  lseek(2),	read(2), write(2), aio_cancel(3), aio_group_completion_np(3), aio_read(3),
       aio_results_np(3), aio_return(3), aio_suspend(3), aio_write(3), lio_listio(3)

       Guide to Realtime Programming delim off

																      aio_error(3)

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)