aio_cancel(3) — Subroutines
Digital
NAME
aio_cancel − cancel one or more asynchronous I/O requests pending against the specified file descriptor (P1003.4/D10)
SYNOPSIS
#include <aio.h>
int aio_cancel (
int fildes ,
struct aiocb ∗aiocbp) ;
PARAMETERS
fildes The file descriptor against which outstanding asynchronous I/O operations are canceled.
aiocbp A pointer to the asynchronous I/O control block for a particular request to be canceled. If the aiocbp argument is NULL, then all queued outstanding asynchronous I/O requests against fildes are canceled.
DESCRIPTION
The aio_cancel function cancels asynchronous I/O requests. The associated error status is set to ECANCELED when an operation is canceled.
RETURN VALUES
On a successful call, AIO_CANCELED is returned to the calling process if the requested operation was canceled. If at least one of the requested operations is not canceled because it is in progress, AIO_NOTCANCELED is returned. The value AIO_ALLDONE is returned if all the operations have already completed.
On an unsuccessful call, a value of −1 is returned and errno is set to indicate that an error occurred.
ERRORS
The aio_cancel function fails under the following conditions:
[EBADF] The fildes argument is not a valid file descriptor.