aio_cancel(3) Library Functions Manual aio_cancel(3)
NAME
aio_cancel - Cancels one or more asynchronous I/O requests pending against the specified file descriptor (P1003.1b)
LIBRARY
Asynchronous I/O Library (libaio, libaio_raw)
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 success-
fully 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_group_completion_np(3), aio_read(3), aio_results_np(3), aio_write(3), aio_suspend(3)
Guide to Realtime Programming delim off
aio_cancel(3)
