io_prep_pwrite(3)

io_prep_pwrite3

Set up iocb for asynchronous writes

Usage

#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;
};

Overview

io_prep_write() is a convenience function for setting up parallel writes.

The first iocb->u.c.nbytes = count bytes of the file for which iocb->aio_fildes = fd is a descriptor are written from the buffer starting at iocb->u.c.buf = buf. Writing 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(3) must be called.

Simultaneous asynchronous operations using the same iocb produce undefined results.

Return values

None.

Errors

None.

Releases

11 releases since Debian 4.0 (Etch); the text changed 4 times.

  1. 4.0–5.0
  2. 6.0–8
  3. 9
  4. 10
  5. 11–Arch

From libaio 0.3.113-5 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.