PMC_NAME_OF_CAPABILITY(3)

💅 PMC_NAME_OF_CAPABILITY(3) — human readable names for numeric constants used by pmc(3) and hwpmc(4)

okay so this page is from the Library Functions Manual, and it is giving “bestie, what does this number even mean?” energy. It’s all about the little converter functions in libpmc that turn numeric constants into strings you can actually read. no cap, they are useful. 💖

---

✨ NAME ✨

• pmc_name_of_capability, pmc_name_of_class, pmc_name_of_cputype, pmc_name_of_disposition, pmc_name_of_event, pmc_name_of_mode, pmc_name_of_state — human readable names for numeric constants used by pmc(3) and hwpmc(4)

📚 LIBRARY 📚

Performance Counters Library (libpmc, -lpmc)

🧚 SYNOPSIS 🧚

#include <pmc.h>

const char *
pmc_name_of_capability(enum pmc_caps pc);

const char *
pmc_name_of_class(enum pmc_class pc);

const char *
pmc_name_of_cputype(enum pmc_cputype ct);

const char *
pmc_name_of_disposition(enum pmc_disp pd);

const char *
pmc_name_of_event(enum pmc_event pe);

const char *
pmc_name_of_mode(enum pmc_mode pm);

const char *
pmc_name_of_state(enum pmc_state ps);

🌸 DESCRIPTION 🌸

These convenience functions translate numeric constants used by the Performance Counters Library (libpmc, -lpmc) to const char * pointers to human readable representations of their arguments. Basically they’re the translators, and they ate. 💅

• pmc_name_of_capability() — takes the PMC capability flag given in argument pc and translates it to a human readable string. PMC capabilities are described in pmc(3). ✨
• pmc_name_of_class() — translates the PMC class value specified in argument pc to a human readable name. PMC classes are described in pmc(3). 🎀
• pmc_name_of_cputype() — translates the CPU type value specified in argument ct to a human readable name. CPU types known to the library are described in pmc(3). 🦋
• pmc_name_of_disposition() — translates the PMC row disposition specified in argument pd to a human readable name. PMC row dispositions are described in hwpmc(4). 🌈
• pmc_name_of_event() — translates the PMC event number specified by argument pe to a string. PMC event names are documented in section “EVENT SPECIFIERS” of pmc(3). 🔥
• pmc_name_of_mode() — translates the PMC mode specified by argument pm to a human readable string. PMC modes are described in pmc(3). 👑
• pmc_name_of_state() — translates the value of argument ps to a human readable name. ⭐

🫶 IMPLEMENTATION NOTES 🫶

The returned pointers point to static storage inside the PMC library and should not be freed by the caller.

bestie, do NOT free() these pointers, okay? They point to static storage inside the PMC library. Not yours to free. 🙈

⭐ RETURN VALUES ⭐

These functions return a non-NULL pointer on successful completion. In case of an error, a NULL pointer is returned and the global variable errno is set to indicate the error.

💀 ERRORS 💀

A call to these functions may fail with the following errors:

• [EINVAL] — The function argument specified an invalid value.

🌈 SEE ALSO 🌈

pmc(3), pmc_cpuinfo(3), pmc_pmcinfo(3), hwpmc(4)

---

xoxo, your Debian bestie 💖 this page is stamped November 24, 2007, and the footer title is PMC_NAME_OF_CAPABILITY(3). slay. 🎀