MPI_T_CATEGORY_GET_PVARS(3)

💖 MPI_T_CATEGORY_GET_PVARS 💖

okay bestie, welcome to the Open MPI manual, section 3 🎀 — this one's all about MPI_T_category_get_pvars, and it's giving "let me tell you exactly which performance variables live in this category" energy. no cap. let's get into it 🦋

---

✨ NAME ✨

MPI_T_category_get_pvars — query which performance variables are in a category 👑

---

✨ SYNTAX ✨

C Syntax

#include <mpi.h>

int MPI_T_category_get_pvars(int cat_index, int len, int indices[])

---

🌸 INPUT PARAMETERS 🌸

• cat_index — the index of the category you wanna snoop on 🔍
• len — how long your indices array is, i.e. how much room you're giving it 📏

---

🫶 OUTPUT PARAMETERS 🫶

• indices — an integer array of size len, and it's gonna be filled with performance variable indices ✨ literally the whole point

---

💅 DESCRIPTION 💅

so, MPI_T_category_get_pvars is the function you call when you wanna know which performance variables are chillin' inside a particular category. that's it. that's the gig 🎀

heads up though: a category can contain zero or more performance variables. so like… don't come for her if the answer is "none", bestie 💀 she just reports the truth.

---

😭 ERRORS 😭

MPI_T_category_get_pvars will fail if:

• MPI_T_ERR_NOT_INITIALIZED — the MPI Tools interface hasn't been initialized yet 🙈 girl, you gotta set it up first
• MPI_T_ERR_INVALID_INDEX — the category index is invalid 🚫 that index? not it. not a real one. denied.

real talk: these are the failure modes, and they mean exactly what they say. don't skip the init, don't hand her a bogus cat_index. periodt 💅

---

📜 Copyright 📜

2003-2026, The Open MPI Community — iconic, protected, and legally unbothered since 2003 🌈

---

aaaand that's the whole page, babe 🧚 the source is Open MPI, and this edition is dated Sep 10, 2026 — so if you're reading the MPI_T_CATEGORY_GET_PVARS(3) page from the future, hey, you're right on time 💜 go query those performance variables, you absolute main character 👑💖