*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> aio_error (2)              


 aio_error(2)                                                   aio_error(2)

 NAME    [Toc]    [Back]
      aio_error() - return error status of an asynchronous I/O operation

 SYNOPSIS    [Toc]    [Back]
      #include <aio.h>

      int aio_error(const struct aiocb *aiocbp);

 DESCRIPTION    [Toc]    [Back]
      The aio_error() function returns the error status of the asynchronous
      I/O operation that was initiated with the aiocb and referenced by
      aiocbp.  The error status for an asynchronous I/O operation is the
      errno value set by the corresponding read(), write(), or fsync()

      To use this function, link in the realtime library by specifying -lrt
      on the compiler or linker command line.

 RETURN VALUE    [Toc]    [Back]
      If the aiocb is invalid or if no asynchronous I/O operation is
      enqueued for the aiocb, aio_error() returns -1 and errno is set to
      indicate the error.  If the operation has been queued but not
      completed, aio_error() returns EINPROGRESS.  Otherwise, aio_error()
      returns the error status of the referenced aiocb.  See aio_read(2),
      read(2), aio_write(2), write(2), aio_fsync(2), fsync(2), and
      lio_listio(2) for relevant error values.

 ERRORS    [Toc]    [Back]
      If aio_error() detects one of the following error conditions, errno is
      set to the indicated value:

           [EINVAL]       There was no asynchronous I/O operation enqueued
                          for the referenced aiocb.

 EXAMPLES    [Toc]    [Back]
      The following code sequence illustrates using aio_error() to retrieve
      the error status of an aio_read() operation.

           #include <fcntl.h>
           #include <errno.h>
           #include <aio.h>
           char buf[4096];
           ssize_t nbytes; int retval;
           struct aiocb myaiocb;
           bzero( &myaiocb, sizeof (struct aiocb));
           myaiocb.aio_fildes = open( "/dev/null", O_RDONLY);
           myaiocb.aio_offset = 0;
           myaiocb.aio_buf = (void *) buf;
           myaiocb.aio_nbytes = sizeof (buf);
           myaiocb.aio_sigevent.sigev_notify = SIGEV_NONE;
           retval = aio_read( &myaiocb );

 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003

 aio_error(2)                                                   aio_error(2)

           if (retval) perror("aio_read:");
           /* continue processing */
           /* wait for completion */
           while ( (retval = aio_error( &myaiocb) ) == EINPROGRESS) ;
           /* free the aiocb */
           nbytes = aio_return( &myaiocb);

 SEE ALSO    [Toc]    [Back]
      aio_cancel(2), aio_fsync(2), aio_read(2), aio_return(2),
      aio_suspend(2), aio_write(2), fsync(2), lio_listio(2), read(2),
      write(2), aio(5).

      aio_error(): POSIX Realtime Extensions, IEEE Std 1003.1b

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
aio_return HP-UX return status of an asynchronous I/O operation
aio_error Tru64 Returns the error status of a specified asynchronous I/O operation (P1003.1b)
aio_error FreeBSD retrieve error status of asynchronous I/O operation (REALTIME)
aio_return FreeBSD retrieve return status of asynchronous I/O operation (REALTIME)
aio_return Tru64 Returns the status of an asynchronous I/O operation (P1003.1b)
tt_int_error HP-UX return the status of an error object
aio_cancel HP-UX cancel an asynchronous I/O operation
aio_suspend HP-UX wait for an asynchronous I/O operation to complete
aio_read HP-UX start an asynchronous read operation
aio_write HP-UX start asynchronous write operation
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service