1AIO_RETURN(3)              Linux Programmer's Manual             AIO_RETURN(3)
2
3
4

NAME

6       aio_return - get return status of asynchronous I/O operation
7

SYNOPSIS

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

DESCRIPTION

16       The aio_return() function returns the final return status for the asyn‐
17       chronous I/O request with control block pointed  to  by  aiocbp.   (See
18       aio(7) for a description of the aiocb structure.)
19
20       This  function  should be called only once for any given request, after
21       aio_error(3) returns something other than EINPROGRESS.
22

RETURN VALUE

24       If the asynchronous I/O operation has completed, this function  returns
25       the  value  that  would  have  been  returned  in case of a synchronous
26       read(2), write(2), fsync(2) or fdatasync(2), call.  On error, -1 is re‐
27       turned, and errno is set appropriately.
28
29       If  the  asynchronous  I/O  operation has not yet completed, the return
30       value and effect of aio_return() are undefined.
31

ERRORS

33       EINVAL aiocbp does not point at a control block for an asynchronous I/O
34              request of which the return status has not been retrieved yet.
35
36       ENOSYS aio_return() is not implemented.
37

VERSIONS

39       The aio_return() function is available since glibc 2.1.
40

ATTRIBUTES

42       For  an  explanation  of  the  terms  used  in  this  section,  see at‐
43       tributes(7).
44
45       ┌─────────────┬───────────────┬─────────┐
46       │Interface    │ Attribute     │ Value   │
47       ├─────────────┼───────────────┼─────────┤
48       │aio_return() │ Thread safety │ MT-Safe │
49       └─────────────┴───────────────┴─────────┘

CONFORMING TO

51       POSIX.1-2001, POSIX.1-2008.
52

EXAMPLES

54       See aio(7).
55

SEE ALSO

57       aio_cancel(3), aio_error(3), aio_fsync(3), aio_read(3), aio_suspend(3),
58       aio_write(3), lio_listio(3), aio(7)
59

COLOPHON

61       This  page  is  part of release 5.10 of the Linux man-pages project.  A
62       description of the project, information about reporting bugs,  and  the
63       latest     version     of     this    page,    can    be    found    at
64       https://www.kernel.org/doc/man-pages/.
65
66
67
68                                  2020-06-09                     AIO_RETURN(3)
Impressum