aio_init

名前

aio_init - 非同期 I/O の初期化

書式

#define _GNU_SOURCE         /* See feature_test_macros(7) */
#include <aio.h>

void aio_init(const struct aioinit *init);

-lrt でリンクする。

説明

GNU 固有の aio_init() 関数を使うと、呼び出し側が glibc の POSIX AIO 実装に対して調整 (チューニング) のヒントを与えることができる。この関数は使用しなくてもよいが、この関数が効果を持つには、POSIX AIO API の他の関数を利用する前に呼び出さなければならない。

チューニングの情報は、引数 init が指すバッファーで与える。このバッファーは以下の形式の構造体である。

struct aioinit {
    int aio_threads;    /* Maximum number of threads */
    int aio_num;        /* Number of expected simultaneous
                           requests */
    int aio_locks;      /* Not used */
    int aio_usedba;     /* Not used */
    int aio_debug;      /* Not used */
    int aio_numusers;   /* Not used */
    int aio_idle_time;  /* Number of seconds before idle thread
                           terminates (since glibc 2.2) */
    int aio_reserved;
};

aioinit 構造体のフィールドのうち以下が使用される。

aio_threads: このフィールドは、AIO の実装が使用できるワーカースレッド数の最大値を指定する。完了していない I/O 操作の数がこの上限を超えた場合、超過した操作は空いたワーカースレッドができるまでキューに入る。このフィールドに 1 未満の値を指定した場合には、値 1 が使用される。デフォルト値は 20 である。