MPI_T_CATEGORY_GET_PVARS(3)

💅 MPI_T_category_get_pvars — the Open MPI tea ☕

okay so bestie, welcome to the MPI_T_category_get_pvars man page (that's the MPI_T_CATEGORY_GET_PVARS(3) one, from the Open MPI manual, if we're being official about it ✨). It's a tiny little function and honestly it's giving "small but mighty" — let's get into it 🫶

---

✨ SYNTAX ✨

🎀 C Syntax

#include <mpi.h>

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

like, that's the whole vibe right there 💅

---

🌸 INPUT PARAMETERS 🌸

• cat_index — the index of the category you're asking about. which category? this one, bestie 🎯
• len — the length of the indices array. yes, you gotta tell it how big your array is, it's not a mind reader 😭

---

🦋 OUTPUT PARAMETERS 🦋

• indices — an integer array of size len, and it comes back filled with performance variable indices. that's the whole point, that's the moment 👑

---

💖 DESCRIPTION 💖

so MPI_T_category_get_pvars is literally the "who's in this category" function. you hand it a category, and it tells you which performance variables live inside it 🏠✨

and the key detail: a category contains zero or more performance variables. zero! could be empty! could be a whole crowd! no cap, plan accordingly 💀

---

🙈 ERRORS 🙈

no bestie, MPI_T_category_get_pvars is not invincible — it will fail if:

• MPI_T_ERR_NOT_INITIALIZED — the MPI Tools interface isn't initialized yet. you gotta set it up first, babes 😤
• MPI_T_ERR_INVALID_INDEX — the category index is invalid. wrong index, wrong timeline, it's giving nothing 🔥

---

ok real talk, if you see one of those error codes, it's not a vibe check you passed 💀 check your init and check your index.

---

🌈 COPYRIGHT 🌈

2003-2026, The Open MPI Community — iconic, protected, periodt 👑

---

and that's the page! special shoutout to the Open MPI crew for this one, dated Sep 11, 2026, page MPI_T_CATEGORY_GET_PVARS(3) — mwah, love that for us 💜🧚‍♀️