aio_group_completion_np - Enables the use of
int aio_group_completion_np ( void );
Asynchronous I/O Library (libaio, libaio_raw)
The aio_group_completion_np function enables an application
to use aio group completion through the
The function must be called before any other aio function.
After this call, the use of the aio_error and aio_return
functions becomes undefined, and they may return unexpected
The best practice is never to intermix the two forms of
aio completion. Calling the function after the use of any
other aio function results in failure.
If the function returns successfully, the number of completed
aio operations reported on is returned. That is,
the return value is the number of valid entries in the
array. If the value returned is the same as the nent
argument, more aio operations may be complete and can be
reported on by another call to aio_results_np.
On an unsuccessful call, a value of -1 is returned and
errno is set to indicate that an error occurred.
The aio_group_completion_np function fails under the following
conditions: Another aio function has already been
called. Inadequate system resources exist to enable group
completion at this time.
Functions: aio_read(3), aio_results_np(3), aio_suspend(3),
Guide to Realtime Programming
[ Back ]