SYNOPSISIn aio.h Ft int Fn aio_cancel int fildes struct aiocb *iocb
DESCRIPTIONThe Fn aio_cancel system call cancels the outstanding asynchronous I/O request for the file descriptor specified in Fa fildes . If Fa iocb is specified, only that specific asynchronous I/O request is cancelled.
Normal asynchronous notification occurs for cancelled requests. Requests complete with an error result of Er ECANCELED .
RESTRICTIONSThe Fn aio_cancel system call does not cancel asynchronous I/O requests for raw disk devices. The Fn aio_cancel system call will always return AIO_NOTCANCELED for file descriptors associated with raw disk devices.
RETURN VALUESThe Fn aio_cancel system call returns -1 to indicate an error, or one of the following:
- Bq AIO_CANCELED
- All outstanding requests meeting the criteria specified were cancelled.
- Bq AIO_NOTCANCELED
- Some requests were not cancelled, status for the requests should be checked with aio_error2.
- Bq AIO_ALLDONE
- All of the requests meeting the criteria have finished.
ERRORSAn error return from Fn aio_cancel indicates:
- Bq Er EBADF
- The Fa fildes argument is an invalid file descriptor.