1AIO_RETURN(P)              POSIX Programmer's Manual             AIO_RETURN(P)
2
3
4

NAME

6       aio_return  -  retrieve  return status of an asynchronous I/O operation
7       (REALTIME)
8

SYNOPSIS

10       #include <aio.h>
11
12       ssize_t aio_return(struct aiocb *aiocbp);
13
14

DESCRIPTION

16       The aio_return() function shall return  the  return  status  associated
17       with  the aiocb structure referenced by the aiocbp argument. The return
18       status for an asynchronous I/O operation is the  value  that  would  be
19       returned  by  the  corresponding  read(),  write(), or fsync() function
20       call. If the error status for the operation is equal to  [EINPROGRESS],
21       then the return status for the operation is undefined. The aio_return()
22       function may be called exactly once to retrieve the return status of  a
23       given  asynchronous  operation; thereafter, if the same aiocb structure
24       is used in a call to aio_return()  or  aio_error(),  an  error  may  be
25       returned.   When  the  aiocb structure referred to by aiocbp is used to
26       submit another asynchronous operation, then aio_return()  may  be  suc‐
27       cessfully used to retrieve the return status of that operation.
28

RETURN VALUE

30       If  the  asynchronous I/O operation has completed, then the return sta‐
31       tus, as described for read(), write(), and fsync(), shall be  returned.
32       If the asynchronous I/O operation has not yet completed, the results of
33       aio_return() are undefined.
34

ERRORS

36       The aio_return() function may fail if:
37
38       EINVAL The aiocbp argument does not refer to an asynchronous  operation
39              whose return status has not yet been retrieved.
40
41
42       The following sections are informative.
43

EXAMPLES

45       None.
46

APPLICATION USAGE

48       The  aio_return() function is part of the Asynchronous Input and Output
49       option and need not be available on all implementations.
50

RATIONALE

52       None.
53

FUTURE DIRECTIONS

55       None.
56

SEE ALSO

58       aio_cancel() , aio_error() , aio_fsync() , aio_read() ,  aio_write()  ,
59       close()  , exec() , exit() , fork() , lio_listio() , lseek() , read() ,
60       the Base Definitions volume of IEEE Std 1003.1-2001, <aio.h>
61

63       Portions of this text are reprinted and reproduced in  electronic  form
64       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
65       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
66       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
67       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
68       event of any discrepancy between this version and the original IEEE and
69       The Open Group Standard, the original IEEE and The Open Group  Standard
70       is  the  referee document. The original Standard can be obtained online
71       at http://www.opengroup.org/unix/online.html .
72
73
74
75IEEE/The Open Group                  2003                        AIO_RETURN(P)
Impressum