FreeBSD manual
download PDF document: kvm_getcptime.3.pdf
KVM_GETCPTIME(3) FreeBSD 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
kvm(3)
FreeBSD 14.2-RELEASE August 19, 2008 FreeBSD 14.2-RELEASE