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
27       returned, and errno is set to indicate the error.
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       └────────────────────────────────────────────┴───────────────┴─────────┘
50

CONFORMING TO

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

EXAMPLES

55       See aio(7).
56

SEE ALSO

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

COLOPHON

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