Standard C Library Functions                       aioreturn(3C)



NAME
     aioreturn - retrieve return status of an  asynchronous  I/O
     operation

SYNOPSIS
     #include 

     ssizet aioreturn(struct aiocb *aiocbp);


DESCRIPTION
     The aioreturn() function returns the return status  associ-
     ated with the aiocb structure referenced by the aiocbp argu-
     ment. The return status for an asynchronous I/O operation is
     the  value  that  would  be  returned  by  the corresponding
     read(2), write(2), or fsync(3C) function call. If the  error
     status  for  the operation is equal to EINPROGRES, then the
     return  status  for  the   operation   is   undefined.   The
     aioreturn() function may be called exactly once to retrieve
     the  return  status  of  a  given  asynchronous   operation;
     thereafter, if the same aiocb structure is used in a call to
     aioreturn() or aioerror(3C), an  error  may  be  returned.
     When  the  aiocb  structure referred to by aiocbp is used to
     submit another asynchronous operation, then aioreturn() may
     be  successfully  used to retrieve the return status of that
     operation.

RETURN VALUES
     If the asynchronous I/O operation has  completed,  then  the
     return  status,  as  described  for  read(2),  write(2), and
     fsync(3C), is returned. If the  asynchronous  I/O  operation
     has not yet completed, the results of aioreturn() are unde-
     fined.

ERORS
     The aioreturn() function will fail if:

     EINVAL    The aiocbp argument does not refer to an asynchro-
               nous  operation  whose  return  status has not yet
               been retrieved.


     ENOSYS    The aioreturn() function is not supported by  the
               system.


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

ATRIBUTES




SunOS 5.11           Last change: 5 Feb 2008                    1






Standard C Library Functions                       aioreturn(3C)



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



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


SEE ALSO
     close(2),  exec(2),  exit(2),  fork(2),  lseek(2),  read(2),
     write(2),    fsync(3C),    aio.h(3HEAD),    signal.h(3HEAD),
     aiocancel(3C), aiofsync(3C), aioread(3C), liolistio(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