aio_error(3)

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

NAME

6       aio_error - get error status of asynchronous I/O operation
7

SYNOPSIS

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

DESCRIPTION

16       The  aio_error() function returns the error status for the asynchronous
17       I/O request with control block pointed to by aiocbp.  (See aio(7) for a
18       description of the aiocb structure.)
19

RETURN VALUE

21       This function returns one of the following:
22
23       *  EINPROGRESS, if the request has not been completed yet.
24
25       *  ECANCELED, if the request was canceled.
26
27       *  0, if the request completed successfully.
28
29       *  A  positive  error number, if the asynchronous I/O operation failed.
30          This is the same value that would have  been  stored  in  the  errno
31          variable  in  the case of a synchronous read(2), write(2), fsync(2),
32          or fdatasync(2) call.
33

ERRORS

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

VERSIONS

42       The aio_error() function is available since glibc 2.1.
43

ATTRIBUTES

45       For  an  explanation  of  the  terms  used   in   this   section,   see
46       attributes(7).
47
48       ┌────────────┬───────────────┬─────────┐
49       │Interface   │ Attribute     │ Value   │
50       ├────────────┼───────────────┼─────────┤
51       │aio_error() │ Thread safety │ MT-Safe │
52       └────────────┴───────────────┴─────────┘

CONFORMING TO

54       POSIX.1-2001, POSIX.1-2008.
55

EXAMPLE

57       See aio(7).
58

COLOPHON

64       This page is part of release 4.16 of the Linux  man-pages  project.   A
65       description  of  the project, information about reporting bugs, and the
66       latest    version    of    this    page,    can     be     found     at
67       https://www.kernel.org/doc/man-pages/.
68
69
70
71                                  2015-03-02                      AIO_ERROR(3)