LIBPFM - Online Linux Manual PageSection : 3
Updated : July, 2003
Source :
Note : Linux Programmer's Manual
NAMEpfm_get_impl_pmcs, pfm_get_impl_pmds, pfm_get_impl_counters, pfm_get_num_counters, pfm_get_num_pmcs, pfm_get_num_pmds, pfm_get_hw_counter_width − return bitmask of implemented PMU registers or number of PMU registers
SYNOPSIS#include <perfmon/pfmlib.h>
int pfm_get_impl_pmcs(pfmlib_regmask_t *impl_pmcs);
int pfm_get_impl_pmds(pfmlib_regmask_t *impl_pmds);
int pfm_get_impl_counters(pfmlib_regmask_t *impl_counters);
int pfm_get_num_counters(unsigned int *num);
int pfm_get_num_pmcs(unsigned int *num);
int pfm_get_num_pmds(unsigned int *num);
int pfm_get_num_counters(unsigned int *num);
int pfm_get_hw_counter_width(unsigned int *width);
DESCRIPTION
The pfm_get_impl_*() functions can be used to figure out which PMU registers are implemented on the host CPU. All implemented registers may not necessarily be available to applications. Programs need to query the operating system kernel monitoring interface to figure out the list of available registers. The pfm_get_impl_*() functions all return a bitmask of registers corresponding to the query. The bitmask pointer passed as argument is reset to zero by each function. The returned bitmask must be accessed using the set of functions provided by the library to ensure portability. See related man pages below. The pfm_get_num_*() functions return the number of implemented PMC or PMD registers. Those numbers may be different from the actual number of registers available to applications. The pfm_get_impl_pmcs() function returns in impl_pmcs the bitmask of implemented PMCS. The pfm_get_impl_pmds() function returns in impl_pmds the bitmask of implemented PMDS. The pfm_get_impl_counters() function returns in impl_counters a bitmask of the PMD registers used as counters. Depending on the PMU mode, not all PMD registers are necessarily used as counters. The pfm_get_num_counters() function returns in num the number of PMD used as counters. A counter is a PMD which is used to accumulate the number of occurrences of an event. The pfm_get_num_pmcs() function returns in num the number of implemented PMCs by the host PMU. The pfm_get_num_pmds() function returns in num the number of implemented PMDs by the host PMU. The pfm_get_hw_counter_width() function returns the width in bits of the counters in width. PMU implementations can have different number of bits implemented. For instance, Itanium has 32-bit counters, while Itanium 2 has 47-bits.
RETURNThe function returns whether or not it was successful. A return value of PFMLIB_SUCCESS indicates success, otherwise the value is the error code.
ERRORSPFMLIB_ERR_NOINIT the library has not been initialized properly.
SEE ALSOpfm_regmask_set(3), pfm_regmask_isset(3)
AUTHORStephane Eranian <eranian@hpl.hp.com> 0
Johanes Gumabo
Data Size : 8,471 byte
man-pfm_get_impl_pmds.3Build : 2024-12-05, 20:55 :
Visitor Screen : x
Visitor Counter ( page / site ) : 3 / 199,702
Visitor ID : :
Visitor IP : 3.135.247.237 :
Visitor Provider : AMAZON-02 :
Provider Position ( lat x lon ) : 39.962500 x -83.006100 : x
Provider Accuracy Radius ( km ) : 1000 :
Provider City : Columbus :
Provider Province : Ohio , : ,
Provider Country : United States :
Provider Continent : North America :
Visitor Recorder : Version :
Visitor Recorder : Library :
Online Linux Manual Page : Version : Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page : Library : lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page : Library : lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base : Version : Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base : Library : lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.