Provided by: manpages-dev_2.17-1_all bug

NAME

       io_getevents - Read asynchronous I/O events from the completion queue

SYNOPSIS

       #include <linux/time.h>

       #include <linux/aio.h>

       long io_getevents (aio_context_t ctx_id, long min_nr, long nr,
                          struct io_event *events, struct timespec *timeout);

DESCRIPTION

       io_getevents() 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.  timeout 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 and will  be  updated  if  not  NULL  and  the
       operation blocks.

RETURN VALUE

       io_getevents()  returns  the  number of events read: 0 if no events are
       available or < min_nr if the timeout has elapsed.

ERRORS

       EINVAL ctx_id is invalid. min_nr is out of range or nr is out of range.

       EFAULT Either events or timeout is an invalid pointer.

       ENOSYS io_getevents() is not implemented on this architecture.

CONFORMING TO

       io_getevents()  is  Linux  specific  and should not be used in programs
       that are intended to be portable.

VERSIONS

       The asynchronous I/O system calls first appeared in Linux  2.5,  August
       2002.

SEE ALSO

       io_setup(2),      io_submit(2),      io_getevents(2),     io_cancel(2),
       io_destroy(2).

NOTES

       The asynchronous I/O system calls were written by Benjamin LaHaise.

AUTHOR

       Kent Yoder.