table of contents
other versions
- wheezy 3.44-1
- jessie 3.74-1
- jessie-backports 4.10-2~bpo8+1
- testing 4.10-2
- unstable 4.10-2
other sections
AIO_WRITE(3) | Linux Programmer's Manual | AIO_WRITE(3) |
NAME¶
aio_write - asynchronous writeSYNOPSIS¶
#include <aio.h>DESCRIPTION¶
The aio_write() function queues the I/O request described by the buffer pointed to by aiocbp. This function is the asynchronous analog of write(2). The arguments of the callwrite(fd, buf, count)
RETURN VALUE¶
On success, 0 is returned. On error the request is not enqueued, -1 is returned, and errno is set appropriately. If an error is only detected later, it will be reported via aio_return(3) (returns status -1) and aio_error(3) (error status—whatever one would have gotten in errno, such as EBADF).ERRORS¶
- EAGAIN
- Out of resources.
- EBADF
- aio_fildes is not a valid file descriptor open for writing.
- EFBIG
- The file is a regular file, we want to write at least one byte, but the starting position is at or beyond the maximum offset for this file.
- EINVAL
- One or more of aio_offset, aio_reqprio, aio_nbytes are invalid.
- ENOSYS
- aio_write() is not implemented.
VERSIONS¶
The aio_write() function is available since glibc 2.1.CONFORMING TO¶
POSIX.1-2001, POSIX.1-2008.NOTES¶
It is a good idea to zero out the control block before use. The control block must not be changed while the write operation is in progress. The buffer area being written out must not be accessed during the operation or undefined results may occur. The memory areas involved must remain valid.SEE ALSO¶
aio_cancel(3), aio_error(3), aio_fsync(3), aio_read(3), aio_return(3), aio_suspend(3), lio_listio(3), aio(7)COLOPHON¶
This page is part of release 3.44 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.2012-05-08 |