www.LinuxHowtos.org

io_prep_pwrite

Section: Linux AIO (3)
Updated: 201-0-23
Index Return to Main Contents

NAME

io_prep_pwrite - Set up iocb for asynchronous writes

SYNOPSIS

#include <errno.h>



#include <libaio.h>



inline void io_prep_pwrite(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_write() is a convenience function for setting up parallel writes.

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

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

Simultaneous asynchronous operations using the same iocb produce undefined results.

RETURN VALUES

None.

ERRORS