MPI_T_PVAR_SESSION_CREATE(3)

💖 MPI_T_PVAR_SESSION_CREATE 💖

okay bestie, so this is the Open MPI manual page for MPI_T_pvar_session_create, MPI_T_pvar_session_free — yep, both of them, they're a package deal, they share a page, they're giving ✨duo energy✨. It's all about creating and freeing performance variable sessions 💅

---

🌸 NAME 🌸

MPI_T_pvar_session_create, MPI_T_pvar_session_free — create/free performance variable session 🎀

---

✨ SYNTAX ✨

🦋 C Syntax

#include <mpi.h>

int MPI_T_pvar_session_create(MPI_T_pvar_session *session)

int MPI_T_pvar_session_free(MPI_T_pvar_session *session)

like, that's it. two lil signatures. so clean. so demure. 🫶

---

💜 DESCRIPTION 💜

MPI_T_pvar_session_create makes you a session for accessing performance variables, bestie. The brand-new session gets handed back to you in the session parameter, no cap — that's where it lives now, that's your baby. 👑

MPI_T_pvar_session_free does the opposite vibe: it releases a session that was allocated by MPI_T_pvar_session_create, and then it sets the session parameter to MPI_T_PVAR_SESSION_NULL. so like, it cleans up after itself AND it empties the lil container for you so you don't get tempted to reuse a dead session. iconic behaviour honestly. 🧚

lowkey important: after MPI_T_pvar_session_free, that session variable is MPI_T_PVAR_SESSION_NULL. the door is closed. the lights are off. do not text it back. 💀

---

😭 ERRORS 😭

🌈 MPI_T_pvar_session_create will fail if:

• MPI_T_ERR_NOT_INITIALIZED — the MPI Tools interface not initialized 🙈 (you gotta init first, bestie, that's the whole vibe)
• MPI_T_ERR_MEMORY — out of memory 🍓 (no room, no session, so sorry)
• MPI_T_ERR_OUT_OF_SESSIONS — no more sessions available 💀 (you've collected them all, there are no more to collect)

🌈 MPI_T_pvar_session_free will fail if:

• MPI_T_ERR_NOT_INITIALIZED — the MPI Tools interface not initialized 🙈 (same energy, still gotta init)
• MPI_T_ERR_INVALID_SESSION — the session parameter is not a valid session 🎀 (you handed it something that isn't real and it's not having it)

---

👑 Copyright 👑

2003-2026, The Open MPI Community 💖

---

and that's the whole page, bestie!! go make your sessions, go free your sessions, be responsible with your MPI_T_PVAR_SESSION_NULLs 🦋✨

this was the Open MPI girlies, bringing you the tea as of Sep 10, 2026 — ily, slay, periodt 💅💖🌸