*** UNIX MANUAL PAGE BROWSER ***

aio_cancel(3) Library Functions Manual aio_cancel(3) 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 particu- lar 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 sig- nal delivery occurs for asynchronous I/O operations that are success- fully canceled. If a request cannot be canceled, then the normal asyn- chronous completion process takes place for those requests when they are completed. RETURN VALUES On a successful call to the aio_cancel function, the requested opera- tion 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). delim off aio_cancel(3)