IO_GETEVENTS   (2) manpage
IO_GETEVENTS
2
2003-02-21
Linux 2.4
Linux Programmer's Manual
  • 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
  • NOTES



      The asynchronous I/O system calls were written by Benjamin LaHaise.
  • AUTHOR
      Kent Yoder.
Current Users: 25 © 1999-2006 Linux.com.hk PenguinSoft
All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.