NAME
aioinit - asynchronous I/O initialization SYNOPSIS
#define GNUSOURCE /* See featuretestmacros(7) */
#include
void aioinit(const struct aioinit *init); Link with -lrt. DESCRIPTION
The GNU-specific aioinit() function allows the caller to provide tun‐ ing hints to the glibc POSIX AIO implementation. Use of this function is optional, but to be effective, it must be called before employing any other functions in the POSIX AIO API. The tuning information is provided in the buffer pointed to by the argument init. This buffer is a structure of the following form: struct aioinit { int aiothreads; /* Maximum number of threads */ int aionum; /* Number of expected simultaneous requests */ int aiolocks; /* Not used */ int aiousedba; /* Not used */ int aiodebug; /* Not used */ int aionumusers; /* Not used */ int aioidletime; /* Number of seconds before idle thread terminates (since glibc 2.2) */ int aioreserved; }; The following fields are used in the aioinit structure: aiothreads This field specifies the maximum number of worker threads that may be used by the implementation. If the number of outstanding I/O operations exceeds this limit, then excess operations will be queued until a worker thread becomes free. If this field is specified with a value less than 1, the value 1 is used. The default value is 20. aionum This field should specify the maximum number of simulta‐ neous I/O requests that the caller expects to enqueue. If a value less than 32 is specified for this field, it is rounded up to 32. The default value is 64. aioidletime This field specifies the amount of time in seconds that a worker thread should wait for further requests before terminating, after having completed a previous request. The default value is 1. VERSIONS The aioinit() function is available since glibc 2.1. CONFORMING TO This function is a GNU extension. SEE ALSO aio(7) COLOPHON
This page is part of release 3.53 of the Linux man-pages project. A description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
Linux 2012-04-26 AIOINIT(3)