English pages are provided only to compare translations to original pages,
better looking pages can be browsed
at the Linux man-pages official site.
Linux Programmer's Manual (2)
io_getevents - read asynchronous I/O events from the completion queue
#include <linux/aio_abi.h> /* Defines needed types */
#include <linux/time.h> /* Defines 'struct timespec' */
int io_getevents(aio_context_t ctx_id, long min_nr, long nr,
struct io_event *events, struct timespec *timeout);
There is no glibc wrapper for this system call; see NOTES.
attempts to read at least min_nr events and
up to nr events from the completion queue of the AIO context
specified by ctx_id.
The timeout argument specifies the amount of time to wait for events,
where a NULL timeout waits until at least min_nr events
have been seen.
Note that timeout is relative.
returns the number of events read: 0 if no events are
available, or less than min_nr
if the timeout
For the failure return, see NOTES.
Either events or timeout is an invalid pointer.
ctx_id is invalid.
min_nr is out of range or nr is
out of range.
Interrupted by a signal handler; see
is not implemented on this architecture.
The asynchronous I/O system calls first appeared in Linux 2.5.
is Linux-specific and should not be used in
programs that are intended to be portable.
Glibc does not provide a wrapper function for this system call.
You could invoke it using
But instead, you probably want to use the
wrapper function provided by
Note that the
wrapper function uses a different type
Note also that the
wrapper does not follow the usual C library conventions for indicating errors:
on error it returns a negated error number
(the negative of one of the values listed in ERRORS).
If the system call is invoked via
then the return value follows the usual conventions for
indicating an error: -1, with
set to a (positive) value that indicates the error.
may cause a segmentation fault instead of generating the error
This page is part of release 3.66 of the Linux
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at
- RETURN VALUE
- CONFORMING TO
- SEE ALSO
This document was created by
using the manual pages.
Time: 21:42:57 GMT, July 12, 2014