Section: Linux Programmer's Manual (2)
Return to Main Contents
io_cancel - cancel an outstanding asynchronous I/O operation
#include <linux/aio_abi.h> /* Defines needed types */
int io_cancel(aio_context_t ctx_id, struct iocb *iocb,
struct io_event *result);
There is no glibc wrapper for this system call; see NOTES.
attempts to cancel an asynchronous I/O operation previously submitted with
argument describes the operation to be canceled and the
argument is the AIO context to which the operation was submitted.
If the operation is successfully canceled, the event will be copied into
the memory pointed to by
without being placed into the
For the failure return, see NOTES.
The iocb specified was not canceled.
One of the data structures points to invalid data.
The AIO context specified by ctx_id is invalid.
is not implemented on this architecture.
The asynchronous I/O system calls first appeared in Linux 2.5.
is Linux-specific and should not be used
in programs that are intended to be portable.
Glibc does not provide a wrapper function for this system call.
You could invoke it using
But instead, you probably want to use the
wrapper function provided by
Note that the
wrapper function uses a different type
Note also that the
wrapper does not follow the usual C library conventions for indicating errors:
on error it returns a negated error number
(the negative of one of the values listed in ERRORS).
If the system call is invoked via
then the return value follows the usual conventions for
indicating an error: -1, with
set to a (positive) value that indicates the error.
This page is part of release 3.74 of the Linux
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at
- RETURN VALUE
- CONFORMING TO
- SEE ALSO