Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Kernel Statistics Library Functionskstat_read(3KSTAT)


NAME

 kstat_read, kstat_write - read or write kstat data

SYNOPSIS

 
cc [ flag ... ] file ... -lkstat [ library ... ]
#include <kstat.h>
kid_t kstat_read(kstat_ctl_t *kc, kstat_t *ksp, void *buf);
 kid_t kstat_write(kstat_ctl_t *kc, kstat_t *ksp, void *buf);

DESCRIPTION

 

The kstat_read() function gets data from the kernel for the kstat pointed to by ksp. ksp->ks_data is automatically allocated (or reallocated) to be large enough to hold all of the data. ksp->ks_ndata is set to the number of data fields, ksp->ks_data_size is set to the total size of the data, and ksp->ks_snaptime is set to the high-resolution time at which the data snapshot was taken. If buf is non-NULL, the data is copied from ksp->ks_data into buf.

The kstat_write() function writes data from buf, or from ksp->ks_data if buf is NULL, to the corresponding kstat in the kernel. Only the superuser can use kstat_write().

RETURN VALUES

 

On success, kstat_read() and kstat_write() return the current kstat chain ID (KCID). On failure, they return -1.

FILES

 
/dev/kstat
kernel statistics driver

ATTRIBUTES

 

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

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelUnsafe

SEE ALSO

 

kstat(3KSTAT), kstat_chain_update(3KSTAT), kstat_close(3KSTAT), kstat_data_lookup(3KSTAT), kstat_lookup(3KSTAT), kstat_open(3KSTAT), attributes(5)


SunOS 5.9Go To TopLast Changed 27 Jun 2000

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.