Name
io_cancel — cancel an outstanding asynchronous I/O operation
Synopsis
#include <libaio.h>
int
io_cancel( |
aio_context_t | ctx_id, |
| struct iocb * | iocb, | |
| struct io_event * | result); |
![[Note]](../stylesheet/note.png) |
Note |
|---|---|
|
Link with |
DESCRIPTION
io_cancel() attempts to
cancel an asynchronous I/O operation previously submitted
with io_submit(2). ctx_id is the AIO context ID of
the operation to be canceled. If the AIO context is found,
the event will be canceled and then copied into the memory
pointed to by result
without being placed into the completion queue.
RETURN VALUE
io_cancel() returns 0 on
success; on failure, it returns one of the errors listed
under ERRORS.
ERRORS
- EINVAL
-
The AIO context specified by
ctx_idis invalid. - EFAULT
-
One of the data structures points to invalid data.
- EAGAIN
-
The
iocbspecified was not canceled. - ENOSYS
-
io_cancel() is not implemented on this architecture.
CONFORMING TO
io_cancel() is
Linux-specific and should not be used in programs that are
intended to be portable.