aio_error()

Get the error status for an asynchronous I/O operation

Synopsis:

#include <aio.h>

int aio_error( const struct aiocb * aiocbptr );

Since:

BlackBerry 10.0.0

Arguments:

aiocbptr
A pointer to an asynchronous I/O control block of type aiocb that you want the error status for.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The aio_error() function returns the error status associated with the aiocb structure referenced by the aiocbptr argument. The error status for an asynchronous I/O operation is the errno value that's set by the corresponding read(), write(), or fsync() operation. If the operation hasn't yet been completed, the error status is EINPROGRESS.

Returns:

One of:

  • 0 if the operation was completed successfully
  • the error status set by read(), write(), or fsync() if the operation wasn't completed successfully
  • EINPROGRESS if the operation hasn't yet been completed

Errors:

EINVAL
The aiocbptr argument doesn't refer to an asynchronous operation whose return status hasn't yet been retrieved.

Classification:

POSIX 1003.1 AIO

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

Caveats:

The first time you call an aio_* function, a thread pool is created, making your process multithreaded if it isn't already. The thread pool isn't destroyed until your process ends.

Last modified: 2014-06-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus