manページ  — ZONE

ゾーンは伸張性のある同一の大きさの項目の集合です。 ゾーンアロケータはどの項目が使用中かそうでないのかを見失わないようにし、 ゾーンから 項目を割り当てるための関数および解放して戻す (後での使用のために項目を 利用可能にする) ための関数を提供します。

構造体をゾーンアロケータで管理し、 割り当ての間に埋め込み済みのフィールドを残すことにより 型が固定となるゾーンの特性を使用したい場合、 ゾーンアロケータが内部で使用する先頭 2 つのポインタを この構造体が予約しておく必要があります。

struct my_item {
        struct my_item  *z_rsvd1;
        struct my_item  *z_rsvd2;
        /* 構造体の残りの部分 */
};

そうしない場合、各々の割当ての後でこれらのエントリが壊れたとみなすべきです。 項目の最初の割当ての後では、0 にクリアされています。 しかしそれに続く割当てでは、 最近解放されたものが内容として残っているでしょうが、 前述のフィールドは例外です。

uma_zcreate() 関数は、これから項目が割当てられることが可能な新しいゾーンを作成します。 name 引数はデバッグおよびステータスのためのテキストのゾーン名です。 このメモリは、ゾーンの割当てが解放されるまでは、解放されるべきではありません。

引数 ctor と dtor は、それぞれ uma_zalloc() と uma_zfree() の呼び出し時に uma サブシステムから呼ばれる、コールバック関数です。 これらの目的は、資源の割り当て時と解放時に必要となる、 初期化および破壊のためのフックを提供することです。 ctor および dtor のコールバックの良い使い方としては、 割り当てられたオブジェクトのグローバルカウントの調整があるでしょう。

引数 uminit と fini は、ゾーンからのオブジェクト割り当ての最適化に使用されます。 これらは、要求実現またはメモリ圧迫の理由により、 uma サブシステムが複数の項目を割り当てまたは解放する必要があるときに、 呼び出されます。 uminit および fini のコールバックの良い使い方としては、 オブジェクトに含まれるミューテックスの初期化と破壊があるでしょう。 これにより、オブジェクトが uma サブシステムのオブジェクトから返されたときに、 既に初期化済みのミューテックスを再使用可能となります。 これらは、各 uma_zalloc() や uma_zfree() の呼び出し時には呼び出されず、 複数のオブジェクトに対してバッチ的に呼び出されます。