aio_return(3)

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.
27
28       If the asynchronous I/O operation has not  yet  completed,  the  return
29       value and effect of aio_return() are undefined.
30

ERRORS

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

VERSIONS

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

ATTRIBUTES

41   Multithreading (see pthreads(7))
42       The aio_return() function is thread-safe.
43

CONFORMING TO

45       POSIX.1-2001, POSIX.1-2008.
46

EXAMPLE

48       See aio(7).
49

COLOPHON

55       This  page  is  part of release 3.53 of the Linux man-pages project.  A
56       description of the project, and information about reporting  bugs,  can
57       be found at http://www.kernel.org/doc/man-pages/.
58
59
60
61                                  2013-07-04                     AIO_RETURN(3)