aio_error(3)

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

NAME

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

LIBRARY

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

SYNOPSIS

12       #include <aio.h>
13
14       int aio_error(const struct aiocb *aiocbp);
15

DESCRIPTION

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

RETURN VALUE

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

ERRORS

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

ATTRIBUTES

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

STANDARDS

55       POSIX.1-2008.
56

HISTORY

58       glibc 2.1.  POSIX.1-2001.
59

EXAMPLES

61       See aio(7).
62