Copyright (c) 1999 Softweyr LLC. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or othe...
NAMEaio_cancel - cancel an outstanding asynchronous I/O operation (REALTIME)
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.