table of contents
KVM_GETCPTIME(3) | Library Functions Manual | KVM_GETCPTIME(3) |
NAME¶
kvm_getcptime — fetch global CPU time statisticsLIBRARY¶
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 ofCPUSTATES
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 toNULL
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¶
kvm(3)August 19, 2008 | Debian |