kstat_lookup man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

kstat_lookup(3KSTAT)  Kernel Statistics Library Functions kstat_lookup(3KSTAT)

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
       The kstat_lookup() function traverses the  kstat	 chain,	 kc->kc_chain,
       searching 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, those fields will be
       ignored in the search.  For example, kstat_lookup(kc, NULL, -1,	"foo")
       will find the first kstat with name "foo".

       The  kstat_data_lookup() function searches the kstat's data section for
       the record with the specified name. This operation is  valid  only  for
       those  kstat  types  that have named data records: KSTAT_TYPE_NAMED and
       KSTAT_TYPE_TIMER.

RETURN VALUES
       The kstat_lookup() function returns a pointer to the requested kstat if
       it  is  found. Otherwise it returns NULL and sets errno to indicate the
       error.

       The kstat_data_lookup() function returns a  pointer  to	the  requested
       data record if it is found. Otherwise it returns NULL and sets errno to
       indicate the error .

ERRORS
       The kstat_lookup() and kstat_data_lookup() functions will fail if:

       EINVAL	       An attempt was made to look up data for	a  kstat  that
		       was not of type KSTAT_TYPE_NAMED or KSTAT_TYPE_TIMER.

       ENOENT	       The requested kstat could not be found.

FILES
       /dev/kstat      kernel statistics driver

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Stable			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Unsafe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       kstat(3KSTAT),	   kstat_chain_update(3KSTAT),	   kstat_open(3KSTAT),
       kstat_read(3KSTAT), attributes(5)

SunOS 5.10			  3 Aug 2004		  kstat_lookup(3KSTAT)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net