aio_group_completion_np(3)aio_group_completion_np(3)NAMEaio_group_completion_np - Enables the use of aio_results_np function
SYNOPSIS
#include <aio.h>
int aio_group_completion_np ( void );
LIBRARY
Asynchronous I/O Library (libaio, libaio_raw)
PARAMETERS
None.
DESCRIPTION
The aio_group_completion_np function enables an application to use aio
group completion through the aio_results_np function.
The function must be called before any other aio function. After this
call, the use of the aio_error and aio_return functions becomes unde‐
fined, and they may return unexpected errors.
The best practice is never to intermix the two forms of aio comple‐
tion. Calling the function after the use of any other aio function
results in failure.
RETURN VALUES
If the function returns successfully, the number of completed aio oper‐
ations reported on is returned. That is, the return value is the num‐
ber 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.
ERRORS
The aio_group_completion_np function fails under the following condi‐
tions: Another aio function has already been called. Inadequate system
resources exist to enable group completion at this time.
SEE ALSO
Functions: aio_read(3), aio_results_np(3), aio_suspend(3),
aio_write(3), lio_listio(3)
Guide to Realtime Programming
aio_group_completion_np(3)