PAPI_num_cmp_hwctrs(3)

📦
version 7.2.0 · 8 versions
, in nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu resolute, ubuntu stonking

💖 NAME 💖

PAPI_num_cmp_hwctrs — return the number of hardware counters for the specified component. This is the PAPI manual, section 3, bestie 🫶

✨ SYNOPSIS ✨

🌸 Detailed Description 🌸

Okay so PAPI_num_cmp_hwctrs() returns the number of counters present in the specified component. By convention, component 0 is always the cpu. Slay.

On some components, especially for CPUs, the value returned is a theoretical maximum for estimation purposes only. It might not be possible to easily create an EventSet that contains the full number of events. This can be due to a variety of reasons:

  1. Some CPUs (especially Intel and POWER) have the notion of fixed counters that can only measure one thing, usually cycles.
  2. Some CPUs have very explicit rules about which event can run in which counter. In this case it might not be possible to add a wanted event even if counters are free.
  3. Some CPUs halve the number of counters available when running with SMT (multiple CPU threads) enabled.
  4. Some operating systems 'steal' a counter to use for things such as NMI Watchdog timers.
The only sure way to see if events will fit is to attempt adding events to an EventSet, and doing something sensible if an error is generated. No cap, that's the vibe check. 🔥

PAPI_library_init() must be called in order for this function to return anything greater than 0.

💻 C Interface 💻

#include <papi.h>
int PAPI_num_cmp_hwctrs(int  cidx );

🎀 Parameters 🎀

  • cidx — An integer identifier for a component. By convention, component 0 is always the cpu component.

🍓 Example 🍓

// Query the cpu component for the number of counters.
printf(\"%d hardware counters found.\\n\", PAPI_num_cmp_hwctrs(0));

💅 Returns 💅

On success, this function returns a value greater than zero. A zero result usually means the library has not been initialized.

🌈 Author 🌈

Generated automatically by Doxygen for PAPI from the source code.

okay that's the whole page, bestie! 💖 This is from PAPI version 7.2.0.0, dated Wed Jun 25 2025 19:30:48, page PAPI_num_cmp_hwctrs(3) — mwah, bye! 🫶✨

📦 where this page comes from