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
    
 
Realtime Library Functionsaio_error(3RT)


NAME

 aio_error - retrieve errors status for an asynchronous I/O operation

SYNOPSIS

 
cc [ flag... ] file... -lrt [ library... ]
#include <aio.h> 
int aio_error(const struct aiocb *aiocbp);

DESCRIPTION

 

The aio_error() function returns the error status associated with the aiocb structure referenced by the aiocbp argument. The error status for an asynchronous I/O operation is the errno value that would be set by the corresponding read(2), write(2), or fsync(3C) operation. If the operation has not yet completed, then the error status will be equal to EINPROGRESS.

RETURN VALUES

 

If the asynchronous I/O operation has completed successfully, then 0 is returned. If the asynchronous operation has completed unsuccessfully, then the error status, as described for read(2), write(2), and fsync(3C), is returned. If the asynchronous I/O operation has not yet completed, then EINPROGRESS is returned.

ERRORS

 

The aio_error() function will fail if:

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

The aio_error() function may fail if:

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

USAGE

 

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

EXAMPLES

 Example 1. The following is an example of an error handling routine using the aio_error function.
 
 
#include <aio.h>
#include <errno.h>
#include <signal.h>
struct aiocb      my_aiocb;
struct sigaction  my_sigaction;
void              my_aio_handler(int, siginfo_t *, void *);
...
my_sigaction.sa_flags = SA_SIGINFO;
my_sigaction.sa_sigaction = my_aio_handler;
sigemptyset(&my_sigaction.sa_mask);
(void) sigaction(SIGRTMIN, &my_sigaction, NULL);
...
my_aiocb.aio_sigevent.sigev_notify = SIGEV_SIGNAL;
my_aiocb.aio_sigevent.sigev_signo = SIGRTMIN;
my_aiocb.aio_sigevent.sigev_value.sival_ptr = &myaiocb;
...
(void) aio_read(&my_aiocb);
...
void
my_aio_handler(int signo, siginfo_t *siginfo, void *context) {
int	my_errno;
struct aiocb	*my_aiocbp;

my_aiocbp = siginfo->si_value.sival_ptr;
        if ((my_errno = aio_error(my_aiocb)) != EINPROGRESS) {
                int my_status = aio_return(my_aiocb);
                if (my_status >= 0){ /* start another operation */
                        ...
                } else        { /* handle I/O error */
                        ...
                }
        }
}

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelAsync-Signal-Safe

SEE ALSO

 

_exit(2), close(2), fork(2), lseek(2), read(2), write(2), aio(3HEAD), aio_cancel(3RT), aio_fsync(3RT), aio_read(3RT), aio_return(3RT), aio_write(3RT), lio_listio(3RT), signal(3HEAD), attributes(5), lf64(5)

NOTES

 

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


SunOS 5.9Go To TopLast Changed 18 Apr 2001

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