NAME

aio_cancel − Cancel one or more asynchronous I/O requests pending against the specified file descriptor (P1003.1b)

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 address of the aiocb structure for a particular request to be canceled. If the aiocbp argument is NULL, all queued outstanding asynchronous I/O requests against the file descriptor are canceled. 

DESCRIPTION

The aio_cancel function cancels asynchronous I/O requests.  Normal signal delivery occurs for asynchronous I/O operations that are successfully canceled. If a request cannot be canceled, then the normal asynchronous completion process takes place for those requests when they are completed. 

RETURN VALUES

On a successful call to the aio_cancel function, the requested operation is canceled, and AIO_CANCELED is returned.  If at least one of the requested operations is not canceled because it is in progress, AIO_NOTCANCELED is returned. If all the operations completed prior to the cancel request, AIO_ALLDONE is returned. 

On an unsuccessful call, a value of −1 is returned and errno is set to indicate that an error occurred. Note that the value of −1 is returned only if the call itself failed. 

ERRORS

The aio_cancel function fails under the following conditions:

[EBADF] The fildes argument is not a valid file descriptor. 

RELATED INFORMATION

Functions: aio_read(3), aio_write(3)