aio_cancel(2)

DESCRIPTION

The aio_cancel() function attempts to cancel the asynchronous I/O request currently outstanding for the aiocb referenced by aiocbp or, if aiocbp is NULL, any asynchronous I/O operations currently outstanding for the file descriptor fildes.

If an asynchronous I/O operation is successfully canceled as a result of aio_cancel, its status is set to ECANCELED, and any signal delivery specified for that operation is performed. Any outstanding requests that cannot be canceled as a result of the aio_cancel() remain enqueued and are unaffected by the cancellation request.

Asynchronous I/O operations that are requested as a single logical operation are either completed or canceled atomically. Once any portion 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 NULL, fildes is ignored.

To use this function, link in the realtime library by specifying -lrt on the compiler or linker command line.

RETURN VALUE

The aio_cancel() function returns one of the following values:

ERRORS

If aio_cancel() detects one of the following error conditions, errno is set to the indicated value:

SEE ALSO

aio_error(2), aio_fsync(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2), lio_listio(2), aio(5).

STANDARDS CONFORMANCE

aio_cancel(): POSIX Realtime Extensions, IEEE Std 1003.1b