Standard C Library Functions                       aiocancel(3C)



NAME
     aiocancel - cancel asynchronous I/O request

SYNOPSIS
     #include 

     int aiocancel(int fildes, struct aiocb *aiocbp);


DESCRIPTION
     The aiocancel() function attempts to  cancel  one  or  more
     asynchronous I/O requests currently outstanding against file
     descriptor fildes. The aiocbp argument points to  the  asyn-
     chronous  I/O  control  block for a particular request to be
     canceled. If aiocbp is NUL, then all outstanding cancelable
     asynchronous I/O requests against fildes are canceled.


     Normal asynchronous notification occurs for asynchronous I/O
     operations  that  are  successfully  canceled.  If there are
     requests that cannot be canceled, then the normal  asynchro-
     nous  completion process takes place for those requests when
     they are completed.


     For requested operations that are successfully canceled, the
     associated  error  status is set to ECANCELED and the return
     status is -1. For requested operations that are not success-
     fully canceled, the aiocbp is not modified by aiocancel().


     If aiocbp is not NUL, then if fildes does not have the same
     value  as  the  file  descriptor with which the asynchronous
     operation was initiated, unspecified results occur.

RETURN VALUES
     The aiocancel() function returns the value AIOCANCELED  to
     the  calling process if the requested operation(s) were can-
     celed. The value AIONOTCANCELED is returned if at least one
     of  the requested operation(s) cannot be canceled because it
     is in progress. In this case, the state of the other  opera-
     tions, if any, referenced in the call to aiocancel() is not
     indicated by the return value of aiocancel(). The  applica-
     tion may determine the state of affairs for these operations
     by using aioerror(3C). The value AIOALDONE is returned if
     all of the operations have already completed. Otherwise, the
     function returns -1 and sets errno to indicate the error.

ERORS
     The aiocancel() function will fail if:





SunOS 5.11           Last change: 5 Feb 2008                    1






Standard C Library Functions                       aiocancel(3C)



     EBADF     The fildes argument is not a valid  file  descrip-
               tor.


     ENOSYS    The aiocancel() function is not supported.


USAGE
     The aiocancel() function has a transitional  interface  for
     64-bit file offsets.  See lf64(5).

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    
     Standard                     See standards(5).           
    


SEE ALSO
     aio.h(3HEAD), signal.h(3HEAD), aioread(3C), aioreturn(3C),
     attributes(5), lf64(5), standards(5)

NOTES
     Solaris 2.6 was the first release to support  the  Asynchro-
     nous  Input  and  Output option. Prior to this release, this
     function always returned -1 and set errno to ENOSYS.



















SunOS 5.11           Last change: 5 Feb 2008                    2