Unix for Beginners
Unix Shell Programming
Advanced Unix
Unix Useful References
Unix Useful Resources
Selected Reading
Copyright © 2014 by tutorialspoint
|
io_getevents() - Unix, Linux System Call
Advertisements
NAME
io_getevents - Read asynchronous I/O events from the completion queue
SYNOPSIS
#include <linux/time.h>
#include <libaio.h>
Tag | Description |
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
Tag | Description |
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.
Advertisements
|
|
|
To Continue Learning Please Login
Login with Google