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

Name

kstat_lookup, kstat_data_lookup - find a kstat by name

Synopsis

cc [ flag... ] file... -lkstat [ library... ]

#include <kstat.h>

kstat_t *kstat_lookup(kstat_ctl_t *kc, char *ks_module, int ks_instance, char *ks_name);

void *kstat_data_lookup(kstat_t *ksp, char *name);

Description

kstat_lookup() walks down the kstat chain, kc->kc_chain, looking for a kstat with the same ks_module, ks_instance, and ks_name fields; this triplet uniquely identifies a kstat. If ks_module is NULL , ks_instance is -1 , or ks_name is NULL , then those fields will be ignored in the search. For example, kstat_lookup(NULL, -1, "foo") will simply find the first kstat with name "foo".

kstat_data_lookup() searches the kstat’s data section for the record with the specified name. This operation is only valid for kstat types which have named data records. Currently, only the KSTAT_TYPE_NAMED and KSTAT_TYPE_TIMER kstats have named data records.

Return Values

kstat_lookup() returns a pointer to the requested kstat if it is found, or NULL if it isn’t.

kstat_data_lookup() returns a pointer to the requested data record if it is found. If the requested record is not found, or if the kstat type is invalid, kstat_data_lookup() returns NULL .

Files

/dev/kstat
kernel statistics driver

See Also

kstat(3K) , kstat_chain_update(3K) , kstat_close(3K) , kstat_open(3K) , kstat_read(3K) , kstat_write(3K)


Table of Contents