kstat_lookup(3K)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | FILES | SEE ALSO

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 is not.

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)

SunOS 5.7  Last Revised 26 May 1994

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | FILES | SEE ALSO