プログラミングインタフェース

lgrp_cookie_stale() の使用法

lgrp_cookie_stale() 関数は、指定のクッキーで表された lgroup 階層のスナップショットが最新のものであるかどうかを判定します。

#include <sys/lgrp_user.h>
int lgrp_cookie_stale(lgrp_cookie_t cookie);

lgrp_init() 関数が返すクッキーは、そのスナップショットを取得した view 引数の種類によって、さまざまな理由により無効になる場合があります。view 引数に LGRP_VIEW_OS を指定して呼び出した lgrp_init() 関数が返すクッキーでは、動的再構成や CPU のオンライン状態の変化などが原因で lgroup 階層に変更があったときに、無効になる場合があります。view 引数に LGRP_VIEW_CALLER を指定した lgrp_init() 関数が返すクッキーでは、呼び出しスレッドのプロセッサセットの変更または lgroup 階層の変化が原因で、無効になる場合があります。無効になったクッキーは、そのクッキーで lgrp_fini() 関数を呼び出し、次に新規クッキーを生成する lgrp_init() 関数を呼び出すことによって新しくなります。

無効なクッキーを指定した場合、lgrp_cookie_stale() 関数は EINVAL を返します。