papi_native_avail(1)

🦋 NAME

okay so bestie, welcome to papi_native_avail 💖

• the papi_native_avail utility ✨
• file papi_native_avail.c 🎀

and like, what does it actually do? it provides detailed information for PAPI native events. that's the whole vibe. iykyk.

---

🌸 Synopsis

ngl, this section is literally empty in the original — not me showing up with a heading and zero content 💀. moving on, the real tea is below 👇

---

✨ Description

papi_native_avail is a PAPI utility program that reports information about the native events available on the current platform. 🖥️✨

so like… what's a native event? it's an event that's specific to a specific hardware platform — like, this-chip-only energy 🔥. and here's the part you need to know: on many platforms, a specific native event can have a whole bunch of optional settings. and instead of dumping every single possible combination of those settings at you (chaos, no thanks 😭), the utility shows you the native event itself plus the valid settings for it. way more readable, honestly iconic. 👑

for each native event, you get:

• a name
• a description
• specific bit patterns

all three, every event, slay 💅

---

🎀 Options

• --help, -h — print this help message 🫶
• --check, -c — attempts to add each event
• -sde FILE — lists SDEs that are registered by the library or executable in FILE
• -e EVENTNAME — display detailed information about named native event
• -i EVENTSTR — include only event names that contain EVENTSTR
• -x EVENTSTR — exclude any event names that contain EVENTSTR
• --noqual — suppress display of event qualifiers (mask and flag) information

💅 Processor-specific options

these ones are the main character energy, fr fr — they only make sense on certain processors 👑

• --darr — display events supporting Data Address Range Restriction
• --dear — display Data Event Address Register events only
• --iarr — display events supporting Instruction Address Range Restriction
• --iear — display Instruction Event Address Register events only
• --opcm — display events supporting OpCode Matching
• --nogroups — suppress display of Event grouping information

---

💀 Bugs

good news bestie: there are no known bugs in this utility. ✨🦋

but if you do find a bug? don't suffer in silence 😭 — it should be reported to the PAPI Mailing List at ptools-perfapi@icl.utk.edu 📧

---

lowkey important: that email is the actual address, copy it exactly, don't be out here typo-ing it 🙈

---

that's the whole page, bestie 💖 go forth and query those native events ✨

Version 7.2.0.0 · Mon Nov 3 2025 — yeah, that's the version and the date, stamped at the bottom like a little signature. mwah 💋🎀