[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    kstat_install(9F) manual page Table of Contents

Name

kstat_install - add a fully initialized kstat to the system

Synopsis


#include <sys/types.h>
#include <sys/kstat.h>

void kstat_install(kstat_t *ksp);

Interface Level

Solaris DDI specific (Solaris DDI)

Arguments

ksp
Pointer to a fully initialized kstat(9S) structure.

Description

kstat_install() is used in conjunction with kstat_create(9F) to allocate and initialize a kstat(9S) structure. The method is generally as follows:


kstat_t *ksp;
ksp = kstat_create(module, instance, name, class, type, ndata, flags);
if (ksp) {
    /* ... provider initialization, if necessary */
    kstat_install(ksp);
}

After a successful call to kstat_create() the driver must perform any necessary initialization of the data section (such as setting the name fields in a kstat of type KSTAT_TYPE_NAMED ). Virtual kstats must have the ks_data field set at this time. The provider may also set the ks_update, ks_private, and ks_lock fields if necessary.

Once the kstat is completely initialized, kstat_install is used to make the kstat accessible to the outside world.

Return Values

None.

Context

kstat_install() can be called from user or kernel context.

See Also

kstat_create(9F) , kstat_delete(9F) , kstat_named_init(9F) , kstat(9S)


Table of Contents