kvm_getpcpu man page on FreeBSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
FreeBSD logo
[printable version]

KVM_GETPCPU(3)		 BSD Library Functions Manual		KVM_GETPCPU(3)

NAME
     kvm_getmaxcpu, kvm_getpcpu — access per-CPU data

LIBRARY
     Kernel Data Access Library (libkvm, -lkvm)

SYNOPSIS
     #include <sys/param.h>
     #include <sys/pcpu.h>
     #include <sys/sysctl.h>
     #include <kvm.h>

     int
     kvm_getmaxcpu(kvm_t *kd);

     void *
     kvm_getpcpu(kvm_t *kd, int cpu);

DESCRIPTION
     The kvm_getmaxcpu() and kvm_getpcpu() functions are used to access the
     per-CPU data of active processors in the kernel indicated by kd.  The
     kvm_getmaxcpu() function returns the maximum number of CPUs supported by
     the kernel.  The kvm_getpcpu() function returns a buffer holding the per-
     CPU data for a single CPU.	 This buffer is described by the struct pcpu
     type.  The caller is responsible for releasing the buffer via a call to
     free(3) when it is no longer needed.  If cpu is not active, then NULL is
     returned instead.

CACHING
     These functions cache the nlist values for various kernel variables which
     are reused in successive calls.  You may call either function with kd set
     to NULL to clear this cache.

RETURN VALUES
     On success, the kvm_getmaxcpu() function returns the maximum number of
     CPUs supported by the kernel.  If an error occurs, it returns -1 instead.

     On success, the kvm_getpcpu() function returns a pointer to an allocated
     buffer or NULL. If an error occurs, it returns -1 instead.

     If either function encounters an error, then an error message may be
     retrieved via kvm_geterr(3.)

SEE ALSO
     free(3), kvm(3)

BSD				August 19, 2008				   BSD
[top]

List of man pages available for FreeBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net