PMC_INIT(3)

💖 NAME

pmc_init — initialize library ✨

Okay bestie, you're on the PMC_INIT(3) page, and this is the little manual for pmc_init — the function with main-character energy that wakes up the whole PMC library. It's giving “initialize library,” no cap 💅.

📚 LIBRARY

Performance Counters Library (libpmc, -lpmc) — yes, that's the one, periodt.

✨ SYNOPSIS

#include <pmc.h>

int
pmc_init(void);

🌸 DESCRIPTION

Function pmc_init() initializes the PMC library. This function must be called before any of the other functions in the library. Not “whenever,” not “after a lil snack” — first, bestie 🫶.

Real talk: pmc_init() is the vibe check. Call it before anything else in the library, or the whole thing is gonna be awkward.

🫶 RETURN VALUES

The pmc_init() function returns the value 0 if successful. Otherwise, the value -1 is returned, and the global variable errno is set to indicate the error. So 0 is the slay result; -1 means check errno for the tea 😭.

💀 ERRORS

A call to pmc_init() may fail with the following errors:

• [ENOENT] — The hwpmc(4) module was not found in the kernel.
• [EPROGMISMATCH] — The library's version number did not match that expected by hwpmc(4).
• [ENXIO] — PMC hardware on this system is unsupported.

🔥 SEE ALSO

• pmc(3)
• hwpmc(4)

Signed with Debian sparkle by the PMC_INIT(3) page, dated November 24, 2007 🎀💖✨