Standard C Library Functions                        aiocancel(3C)



NAME
     aiocancel - cancel an asynchronous operation

SYNOPSIS
     #include 

     int aiocancel(aioresultt *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 pro-
     gress  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.

ERORS
     aiocancel() will fail if any of the following are true:

     EACES    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.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:










SunOS 5.11           Last change: 5 Feb 1997                    1






Standard C Library Functions                        aiocancel(3C)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Safe                        
    


SEE ALSO
     aioread(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.









































SunOS 5.11           Last change: 5 Feb 1997                    2