Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

aio_group_completion_np(3) [osf1 man page]

aio_group_completion_np(3)				     Library Functions Manual					aio_group_completion_np(3)

NAME
aio_group_completion_np - Enables the use of aio_results_np function LIBRARY
Asynchronous I/O Library (libaio, libaio_raw) SYNOPSIS
#include <aio.h> int aio_group_completion_np ( void ); PARAMETERS
None. DESCRIPTION
The aio_group_completion_np function enables an application to use aio group completion through the aio_result_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
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
The aio_group_completion_np function fails under the following conditions: [EINVAL] Another aio function has already been called. [EAGAIN] Inadequate system resources exist to enable group completion at this time. RELATED INFORMATION
Functions: aio_read(3), aio_results_np(3), aio_suspend(3), aio_write(3), lio_listio(3) Guide to Realtime Programming delim off aio_group_completion_np(3)

Check Out this Related Man Page

aio_error(3)						     Library Functions Manual						      aio_error(3)

NAME
aio_error - Returns the error status of a specified asynchronous I/O operation (P1003.1b) LIBRARY
Asynchronous I/O Library (libaio, libaio_raw) SYNOPSIS
#include <aio.h> int aio_error (const struct aiocb *aiocbp); PARAMETERS
*aiocbp A pointer to the address of the aiocb structure. DESCRIPTION
The aio_error function returns the error status associated with the aiocb structure referenced by the aiocbp argument. The error status is the errno value that is set by the corresponding asynchronous I/O read, write, or fsync operation. The aio_error function returns EINPROGRESS until the asynchronous I/O operation is complete. When the operation is complete, call the aio_return function to determine if the operation was successful. RETURN VALUES
If the asynchronous I/O operation was successful, a value of 0 is returned. If the asynchronous I/O operation has not yet completed, [EINPROGRESS] is returned. If the aio_error operation was canceled, [ECANCELED] is returned. On an unsuccessful call, the value returned corresponds to those error values returned for a failed read, write, or fsync operation. ERRORS
The aio_error function fails under the following conditions: [EINVAL] The aiocbp argument does not refer to an asynchronous operation whose return status has not yet been retrieved. RELATED INFORMATION
Functions: close(2), exec(2), _exit(2), fork(2), lseek(2), read(2), write(2), aio_cancel(3), aio_group_completion_np(3), aio_read(3), aio_results_np(3), aio_return(3), aio_suspend(3), aio_write(3), lio_listio(3) Guide to Realtime Programming delim off aio_error(3)
Man Page