papi_avail(1)

📦
version 7.2.0 · 9 versions
, in centos-stream 9

💅 papi_avail 💅

okay bestie, gather round, because this is a papi_avail(1) page and honestly it's kind of a big deal. it lives in the PAPI manual, and the source file you're looking at is papi_avail.c — yes, literally that file, no cap.

✨ NAME ✨

papi_avail — the papi_avail utility, fr fr.

also: file papi_avail.c 🫶

🌸 Name 🌸

papi_avail — this is the whole vibe: it hands you the availability info AND the detailed tea on PAPI preset events and user defined events. both. at once. iconic 💅

🦋 Synopsis 🦋

papi_avail [-adht] [-e event]

yes the synopsis has a -t in there. is it in the options list below? no bestie, it is not. i don't make the rules, i just report them 🫠

🎀 Description 🎀

okay so. papi_avail is a PAPI utility program, and what it does is spill the details about your current PAPI installation — plus everything it knows about supported preset events and user defined events. that's the whole job. it's giving "tell me everything, i'm nosy" and honestly? same. 👑

⭐ Options ⭐

  • -h — shows you the help info for this utility. the classic "what does anything do" button 🥺
  • -a — only shows the PAPI events that are actually available. no fluff, no ghost events ✨
  • -c — same energy as -a, but it shows only the available PAPI events after a check. so, verified available. extra thorough 🧚
  • -d — dumps the PAPI event information in a more detailed format. the deluxe version, the director's cut 💅
  • -e <event> — gives you detailed event information for the event you name. and bestie, that event can be a preset event, a user defined event, or a native event — all three are welcome here 🫶 if what you passed is a preset or a user defined event, the output literally shows you the list of native events the event is based on, PLUS the formula that gets used to compute the event's final value. the receipts!! the math!! we love transparency 💖

🌈 Event filtering options 🌈

these are here so you can ask for just one flavour of PAPI preset events instead of the whole buffet:

  • --br — branch related PAPI preset events 🌿
  • --cache — cache related PAPI preset events 🍓
  • --cnd — conditional PAPI preset events 🎀
  • --fp — Floating Point related PAPI preset events 🔥
  • --ins — instruction related PAPI preset events 👑
  • --idl — Stalled or Idle PAPI preset events 💀 (the "nothing is happening" events, very relatable)
  • --l1 — level 1 cache related PAPI preset events ⭐
  • --l2 — level 2 cache related PAPI preset events ⭐⭐
  • --l3 — level 3 cache related PAPI preset events ⭐⭐⭐
  • --mem — memory related PAPI preset events 🧠
  • --msc — miscellaneous PAPI preset events 🙈
  • --tlb — Translation Lookaside Buffer PAPI preset events 🦋

💀 Bugs 💀

ngl, there are no known bugs in this utility. like, zero. pristine. main character energy. 😌

but if you DO find a bug, it should be reported to the PAPI Mailing List at ptools-perfapi@icl.utk.edu — the devs want the tea 🫶

👀 See also 👀

  • PAPI_derived_event_files

okay that's the whole page, bestie!! this was Version 7.2.0.0, dated Mon Nov 3 2025 — mwah, go measure something cute 💖✨🎀🦋🌸💅

📦 where this page comes from