MPI_T_CATEGORY_GET_CVARS(3)

📦
version 5.0.10 · 7 versions
, in ubuntu stonking

💅 MPI_T_CATEGORY_GET_CVARS 💅

okay bestie, gather round, because we're about to peek inside Open MPI's manual section 3 (that's the library-calls girlies, iykyk) and this one is a certified bop. it's MPI_T_category_get_cvars, and no, that name is not a typo, that's just how the tool interface names things, we don't question it, we stan it. 🫶

✨ NAME ✨

MPI_T_category_get_cvars — query which control variables are in a category 🔍

like… literally just "which cvars live in this category, bestie, show me". that's the whole assignment. periodt.

🦋 SYNTAX 🦋

C Syntax

#include <mpi.h>

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

yes the #include <mpi.h> goes up top, always, no exceptions, that's the entry fee. 💖

🎀 INPUT PARAMETERS 🎀

  • cat_index — the index of the category you're trying to snoop on. it's the category. the one. give it to me. 👑
  • len — the length of the indices array. how much room you're handing over, basically.

🌸 OUTPUT PARAMETERS 🌸

  • indices — an integer array of size len, and it comes back holding control variable indices. it's giving "here are the cvars you asked for, ma'am". ✨

💜 DESCRIPTION 💜

so MPI_T_category_get_cvars can be used to query which control variables are contained in a particular category. that's it. that's the vibe. you name a category, you get the cvars that live there. lowkey iconic behavior honestly. 💅

💀 ERRORS 💀

MPI_T_category_get_cvars will fail if:

  • MPI_T_ERR_NOT_INITIALIZED — the MPI Tools interface is not initialized. babe. babe. you have to init it first. 😭
  • MPI_T_ERR_INVALID_INDEX — the category index is invalid. that index does not exist, that index is a ghost, that index is not real and we do not know her. 🙈

Copyright 2003-2026, The Open MPI Community 🌈

and that's the whole page, bestie!! go forth and query your categories with main character energy. 💖✨

this has been the MPI_T_CATEGORY_GET_CVARS(3) page from Open MPI, dated Sep 10, 2026 — mwah, slay, bye 🎀🦋💅

📦 where this page comes from