aio_cancel(2)aio_cancel(2)NAMEaio_cancel() - cancel an asynchronous I/O operation
SYNOPSISDESCRIPTION
The function attempts to cancel the asynchronous I/O request currently
outstanding for the referenced by aiocbp or, if aiocbp is any asynchro‐
nous I/O operations currently outstanding for the file descriptor
fildes.
If an asynchronous I/O operation is successfully canceled as a result
of its status is set to and any signal delivery specified for that
operation is performed. Any outstanding requests that cannot be can‐
celed as a result of the remain enqueued and are unaffected by the can‐
cellation request.
Asynchronous I/O operations that are requested as a single logical
operation are either completed or canceled atomically. Once any por‐
tion of the operation has started, it cannot be canceled. Whether or
not and when an asynchronous I/O operation can be canceled depends on
the nature of the request.
If aiocbp is not fildes is ignored.
To use this function, link in the realtime library by specifying on the
compiler or linker command line.
RETURN VALUE
The function returns one of the following values:
The asynchronous I/O operation
enqueued for the referenced by aiocbp or all
asynchronous I/O operations enqueued for the file
referenced by fildes have been successfully can‐
celed.
The asynchronous I/O operation enqueued for the
referenced by aiocbp or at least one of the asyn‐
chronous I/O operations enqueued for the file
referenced by fildes have not been canceled.
(The function must be used to determine the sta‐
tus of individual operations.)
The asynchronous I/O operation enqueued for the
referenced by aiocbp or all of the asynchronous
I/O operations enqueued for the file referenced
by fildes completed before cancellation could be
attempted.
Failure. The requested cancellation could not be initi‐
ated. is set to indicate the error.
ERRORS
If detects one of the following error conditions, is set to the indi‐
cated value:
[EBADF] The aiocbp argument is and the fildes argument is
not a valid file descriptor.
[EINVAL] There was no asynchronous I/O operation enqueued
for the referenced by aiocbp.
SEE ALSOaio_error(2), aio_fsync(2), aio_read(2), aio_return(2), aio_suspend(2),
aio_write(2), lio_listio(2), aio(5).
STANDARDS CONFORMANCEaio_cancel(2)