PMC_GET_DRIVER_STATS(3)

🎀 NAME 🎀

okay so bestie, welcome to PMC_GET_DRIVER_STATS(3), aka the Library Functions Manual page for pmc_get_driver_stats(3) — the function that retrieves driver statistics. That’s the whole assignment. 🫶

📚 LIBRARY 📚

Performance Counters Library (libpmc, -lpmc) — yes, link it like that, slay. ✨

✨ SYNOPSIS ✨

#include <pmc.h>

int
pmc_get_driver_stats(struct pmc_driverstats *gms);

💖 DESCRIPTION 💖

The function pmc_get_driver_statistics() retrieves a snapshot of the usage statistics maintained by hwpmc(4) into the memory area pointed to by argument gms. (That’s the description’s spelling, bestie — don’t come for me 💀.)

The returned structure includes the following fields, no skips:

• pm_intr_ignored — the number of sampling interrupts ignored. 🙈
• pm_intr_processed — the number of sampling interrupts processed. ✅
• pm_intr_bufferfull — the number of sampling interrupts dropped due to lack of space in the sample buffer. 😭
• pm_syscalls — the number of system calls into hwpmc(4). 📞
• pm_syscalls_errors — the number of system calls into hwpmc(4) that failed. 💀
• pm_buffer_requests — the number of log buffer requests so far. 🧾
• pm_buffer_requests_failed — the number of log buffer requests that failed due to lack of buffers. 🫠
• pm_log_sweeps — the number of sample buffer processing sweeps. 🧹

🔁 RETURN VALUES 🔁

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error. So: 0 = slay, -1 = check errno, periodt. 💅

👀 SEE ALSO 👀

pmc(3), hwpmc(4) — go read those too, bestie. 🦋

xoxo, your Debian bestie — this page is from Debian, dated November 25, 2007. 💖✨