Kernel Statistics Library Functions            kstatopen(3KSTAT)



NAME
     kstatopen,  kstatclose  -  initialize  kernel   statistics
     facility

SYNOPSIS
     cc[ flag... ] file... -lkstat [ library...]
     #include 

     kstatctlt *kstatopen(void);


     int kstatclose(kstatctlt *kc);


DESCRIPTION
     The kstatopen() function initializes a kstat control struc-
     ture  that provides access to the kernel statistics library.
     It returns a pointer to this structure, which must  be  sup-
     plied  as  the  kc  argument in subsequent libkstat function
     calls.


     The kstatclose() function frees  all  resources  that  were
     associated  with  kc.  This  is  performed  automatically on
     exit(2) and execve(2).

RETURN VALUES
     Upon successful completion, kstatopen() returns  a  pointer
     to  a  kstat control structure.  Otherwise, it returns NUL,
     no resources are allocated, and errno is set to indicate the
     error.


     Upon successful completion, kstatclose() returns 0.  Other-
     wise, -1 is returned and errno is set to indicate the error.

ERORS
     The kstatopen() function will fail if:

     ENOMEM       Insufficient storage space is available.


     EAGAIN       The kstat was temporarily unavailable for read-
                  ing or writing.


     ENXIO        The given kstat could not be located for  read-
                  ing.


     EOVERFLOW    The data for the given kstat was too  large  to
                  be stored in the structure.



SunOS 5.11           Last change: 3 Aug 2004                    1






Kernel Statistics Library Functions            kstatopen(3KSTAT)



     The kstatopen() function can also return the  error  values
     for open(2).


     The kstatclose() function can also return the error  values
     for close(2).

FILES
     /dev/kstat    kernel statistics driver


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Stable                      
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     close(2),  execve(2),   open(2),   exit(2),   kstat(3KSTAT),
     kstatchainupdate(3KSTAT),            kstatlookup(3KSTAT),
     kstatread(3KSTAT), attributes(5)

























SunOS 5.11           Last change: 3 Aug 2004                    2