Section: Linux Programmer's Manual (3)
aio_cancel - cancel an outstanding asynchronous I/O request
int aio_cancel(int fd, struct aiocb *aiocbp);
Link with -lrt.
function attempts to cancel outstanding asynchronous I/O requests
for the file descriptor
is NULL, all such requests are canceled.
Otherwise, only the request
described by the control block pointed to by
for a description of the
Normal asynchronous notification occurs for canceled requests (see
The request return status
is set to -1, and the request error status
is set to
The control block of requests that cannot be canceled is not changed.
If the request could not be canceled,
then it will terminate in the usual way after performing the I/O operation.
(In this case,
will return the status
is not NULL, and
differs from the file descriptor with which the asynchronous operation
was initiated, unspecified results occur.
Which operations are cancelable is implementation-defined.
function returns one of the following values:
All requests were successfully canceled.
At least one of the
requests specified was not canceled because it was in progress.
In this case, one may check the status of individual requests using
All requests had already been completed before the call.
An error occurred.
The cause of the error can be found by inspecting
is not a valid file descriptor.
is not implemented.
function is available since glibc 2.1.
For an explanation of the terms used in this section, see
This page is part of release 5.02 of the Linux
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at