debian man page for io_prep_pread

io_prep_pread(3)						       Linux							  io_prep_pread(3)

NAME
       io_prep_pread - Set up asynchronous read

SYNOPSYS
       #include <errno.h>

       #include <libaio.h>

       inline void io_prep_pread(struct iocb *iocb, int fd, void *buf, size_t count, long long offset);
       "

       struct iocb {
	    void      *data;
	    unsigned  key;
	    short	   aio_lio_opcode;
	    short	   aio_reqprio;
	    int       aio_fildes;
       };

DESCRIPTION
       io_prep_pread is an inline convenience function designed to facilitate the initialization of the iocb for an asynchronous read operation.

       The  first iocb->u.c.nbytes = count bytes of the file for which iocb->aio_fildes = fd is a descriptor are written to the buffer starting at
       iocb->u.c.buf = buf.  Reading starts at the absolute position ioc->u.c.offset = offset in the file.

       This function returns immediately. To schedule the operation, the function io_submit must be called.

       Simultaneous asynchronous operations using the same iocb produce undefined results.

RETURN VALUES
       None.

ERRORS
       None.

SEE ALSO
       io(3),  io_cancel(3),   io_fsync(3),   io_getevents(3),	 io_prep_fsync(3),   io_prep_pwrite(3),   io_queue_init(3),   io_queue_release(3),
       io_queue_run(3), io_queue_wait(3), io_set_callback(3), io_submit(3), errno(3).

Linux 2.4							    2009-06-10							  io_prep_pread(3)