Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Asynchronous I/O Library Functionsaiocancel(3AIO)


NAME

 aiocancel - cancel an asynchronous operation

SYNOPSIS

 
cc [ flag ... ] file ... -laio [ library ... ]
#include <sys/asynch.h>
int aiocancel(aio_result_t *resultp);

DESCRIPTION

 

aiocancel() cancels the asynchronous operation associated with the result buffer pointed to by resultp. It may not be possible to immediately cancel an operation which is in progress and in this case, aiocancel() 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, aiocancel() returns -1 and sets errno to indicate the error.

ERRORS

 

aiocancel() 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 currently 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 TYPEATTRIBUTE VALUE
MT-LevelSafe

SEE ALSO

 

aioread(3AIO), aiowait(3AIO), 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.


SunOS 5.9Go To TopLast Changed 5 Mar 1997

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.