aio_return(3)

1aio_return(3)              Library Functions Manual              aio_return(3)
2
3
4

NAME

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

LIBRARY

9       Real-time library (librt, -lrt)
10

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUE

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

ERRORS

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

ATTRIBUTES

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

STANDARDS

50       POSIX.1-2008.
51

HISTORY

53       glibc 2.1.  POSIX.1-2001.
54

EXAMPLES

56       See aio(7).
57