aio_cancel(3)aio_cancel(3)NAMEaio_cancel - Cancels one or more asynchronous I/O requests pending
against the specified file descriptor (P1003.1b)
SYNOPSIS
#include <aio.h>
int aio_cancel ( int fildes, struct aiocb *aiocbp);
LIBRARY
Asynchronous I/O Library (libaio, libaio_raw)
PARAMETERS
The file descriptor against which outstanding asynchronous I/O opera‐
tions are canceled. A pointer to the address of the aiocb structure
for a particular request to be canceled. If the aiocbp argument is
NULL, all queued outstanding asynchronous I/O requests against the file
descriptor are canceled.
DESCRIPTION
The aio_cancel function cancels asynchronous I/O requests. Normal sig‐
nal delivery occurs for asynchronous I/O operations that are success‐
fully canceled. If a request cannot be canceled, then the normal asyn‐
chronous completion process takes place for those requests when they
are completed.
RETURN VALUES
On a successful call to the aio_cancel function, the requested opera‐
tion 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.
ERRORS
The aio_cancel function fails under the following conditions: The
fildes argument is not a valid file descriptor.
SEE ALSO
Functions: aio_group_completion_np(3), aio_read(3), aio_results_np(3),
aio_write(3), aio_suspend(3)
Guide to Realtime Programming
aio_cancel(3)