kstat_read(3K)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | FILES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO

NAME

kstat_read, kstat_write- Read or write kstat data

SYNOPSIS

cc [flags...] 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

kstat_read() 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 .

kstat_write() writes data from buf , or from ksp->ks_data if buf is NULL, to the corresponding kstat in the kernel. kstat_write() requires the PRIV_SYS_CONFIG privilege and MAC write access to /dev/kstat .

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

SUMMARY OF TRUSTED SOLARIS CHANGES

kstat_write() requires the PRIV_SYS_CONFIG privilege and MAC write access to /dev/kstat .

SEE ALSO

SunOS 5.7 Reference Manual

kstat(3k) , kstat_chain_update(3k) , kstat_close(3k) , kstat_data_lookup(3k) , kstat_lookup(3k) , kstat_open(3k)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | FILES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO