aio_cancel - Cancel one or more asynchronous I/O requests pending against the specified file descriptor (P1003.1b)
int aio_cancel (
struct aiocb *aiocbp);
The aio_cancel function cancels asynchronous I/O requests. Normal signal delivery occurs for asynchronous I/O operations that are successfully canceled. If a request cannot be canceled, then the normal asynchronous completion process takes place for those requests when they are completed.
On a successful call to the aio_cancel function, the requested operation is canceled, and AIO_CANCELED is returned. If at least one of the requested operations is not canceled because it is in progress, AIO_NOTCANCELED is returned. If all the operations completed prior to the cancel request, AIO_ALLDONE is returned.
On an unsuccessful call, a value of -1 is returned and errno is set to indicate that an error occurred. Note that the value of -1 is returned only if the call itself failed.
The aio_cancel function fails under the following conditions:
Functions: aio_group_completion_np(3), aio_read(3), aio_results_np(3), aio_write(3), aio_suspend(3). delim off