AIOCANCEL(3C)AIOCANCEL(3C)NAMEaiocancel - cancel an asynchronous operation
SYNOPSIS
#include <sys/asynch.h>
int aiocancel(aio_result_t *resultp);
DESCRIPTIONaiocancel() cancels the asynchronous operation associated with the
result buffer pointed to by resultp. It may not be possible to immedi‐
ately cancel an operation which is in progress and in this case, aio‐
cancel() will not wait to cancel it.
Upon successful completion, aiocancel() returns 0 and the requested
operation is cancelled. The application will not receive the SIGIO
completion signal for an asynchronous operation that is successfully
cancelled.
RETURN VALUES
Upon successful completion, aiocancel() returns 0. Upon failure, aio‐
cancel() returns −1 and sets errno to indicate the error.
ERRORSaiocancel() will fail if any of the following are true:
EACCES
The parameter resultp does not correspond to any outstanding
asynchronous operation, although there is at least one cur‐
rently outstanding.
EFAULT
resultp points to an address outside the address space of the
requesting process. See NOTES.
EINVAL
There are not any outstanding requests to cancel.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌───────────────┬─────────────────┐
│ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├───────────────┼─────────────────┤
│MT-Level │ Safe │
└───────────────┴─────────────────┘
SEE ALSOaioread(3C), aiowait(3C), attributes(5)NOTES
Passing an illegal address as resultp will result in setting errno to
EFAULT only if it is detected by the application process.
Feb 5, 1997 AIOCANCEL(3C)
