kstat2_hold_bykid, kstat2_rele - hold and release a lock on a v2 kstat
#include <sys/types.h> #include <sys/kstat2.h> kstat2_t *kstat2_hold_bykid(kid_t ks_kid); void kstat2_rele(kstat2_t *ksp);
Solaris DDI specific (Solaris DDI)
ID of a previously created kstat.
v2 kstat handle previously obtained one of the kstat2_hold*() calls.
Before the values in a kstat are modified, the kstat must be locked. These functions provide the operations to search for and lock a kstat and to release that lock once changes have been made.
kstat2_hold_bykid() locates a kstat using its unique ID, locks it and returns a pointer to the kstat to the caller.
kstat2_rele() releases the lock on the given kstat.
The kstat2_hold_bykid() function returns a pointer to the locked kstat or NULL if a kstat is not found.
These functions can be called from any context.
It is recommended that locks be held for the absolute minimum time necessary to prevent kstat readers from blocking for a long time.