NAME    [Toc]    [Back]

       aio_group_completion_np    -    Enables    the    use   of
       aio_results_np function

SYNOPSIS    [Toc]    [Back]

       #include <aio.h>

       int aio_group_completion_np ( void );

LIBRARY    [Toc]    [Back]

       Asynchronous I/O Library (libaio, libaio_raw)

PARAMETERS    [Toc]    [Back]

       None.

DESCRIPTION    [Toc]    [Back]

       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 undefined, and  they  may  return  unexpected
 errors.
        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.

RETURN VALUES    [Toc]    [Back]

       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.

ERRORS    [Toc]    [Back]

       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.

SEE ALSO    [Toc]    [Back]

       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)