Updated: April 19, 2023 |
Asynchronously read from a file
#include <aio.h> int aio_read( struct aiocb * const aiocbptr ); int aio_read64( struct aiocb64 * const aiocbptr );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The aio_read() function asynchronously reads aiocbptr->aio_nbytes from the file associated with aiocbptr->aio_filedes into the buffer pointed to by aiocbptr->aio_buf. The functions return when the read request has been initiated or queued to the file or device (even when the data can't be delivered immediately). The aio_read64() function is a large-file support version of aio_read().
The asynchronous operation is submitted at the scheduling priority of the thread minus aiocbp->aio_reqprio.
You can pass the aiocbptr argument to aio_error() and aio_return(), to determine the error status and return status of the asynchronous operation while it's proceeding. If an error condition is encountered during queuing, the functions return without having initiated or queued the request. The requested operation takes place at the absolute position in the file as given by aio_offset, as if lseek() were called immediately prior to the operation with an offset equal to aio_offset and a whence of SEEK_SET. After a successful call to enqueue an asynchronous I/O operation, the value of the file offset for the file is undefined.
These functions ignore the aiocbptr->aio_lio_opcode field.
If the buffer pointed to by aiocbptr->aio_buf or the control block pointed to by aiocbptr becomes an illegal address before the asynchronous I/O is completed, then the behavior is undefined.
Simultaneous asynchronous operations using the same aiocbptr produce undefined results.
If synchronized I/O is enabled on the file associated with aiocbptr->aio_filedes, these functions behave in accordance with the definitions of synchronized I/O data integrity completion and synchronized I/O file integrity completion.
If a system action changes the process memory space while an asynchronous I/O is outstanding to the address range being changed, the results of that action are undefined.
The following conditions may be detected synchronously at the time of the call to aio_read() or aio_read64(), or asynchronously. If any of these conditions are detected synchronously, these functions return -1 and set errno to the corresponding value. If any of these conditions are detected asynchronously, the return status of the asynchronous operation is set to -1, and the error status of the asynchronous operation is set to the corresponding value:
If aio_read() or aio_read64() successfully queues the I/O operation, but the operation is subsequently canceled or encounters an error, the return status of the asynchronous operation is one of the values normally returned by read(). In addition, the error status of the asynchronous operation is set to one of the error statuses normally set by read(), or one of the following:
The following condition may be detected synchronously or asynchronously:
0 if the I/O operation was successfully queued, or -1 if an error occurred (errno is set).
aio_read() is POSIX 1003.1; aio_read64() is Large-file support
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | Yes |
Thread | Yes |
The first time you call an aio_* function, a thread pool is created, making your process multithreaded if it isn't already. Because of this, after a fork() the child can not use any of the aio_*() functions if the parent used any aio_*() functions before the fork(). The thread pool isn't destroyed until your process ends.