table of contents
KVM_GETCPTIME(3) | Library Functions Manual | KVM_GETCPTIME(3) |
NAME¶
kvm_getcptime
—
fetch global CPU time statistics
LIBRARY¶
Kernel Data Access Library (libkvm, -lkvm)
SYNOPSIS¶
#include
<sys/param.h>
#include <sys/resource.h>
#include <sys/sysctl.h>
#include <kvm.h>
int
kvm_getcptime
(kvm_t
*kd, long
*cp_time);
DESCRIPTION¶
The
kvm_getcptime
()
function stores the global CPU time statistics from the kernel
kd in the array of counters pointed to by
cp_time. Note that cp_time
should point to an array of CPUSTATES
long integers.
The format of the counters is identical to that output by the
kern.cp_time sysctl.
CACHING¶
This function caches the nlist values for various kernel variables
which it reuses in successive calls. You may call the function with
kd set to NULL
to clear this
cache.
RETURN VALUES¶
The kvm_getcptime
function returns 0 on
success and -1 on failure. If an error occurs, then an error message may be
retrieved via kvm_geterr(3).
SEE ALSO¶
August 19, 2008 | Debian |