MPI_Errhandler_c2f(3)

📦
version 7.1.4 · 6 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ MPI_Errhandler_c2f(3) ✨

okay bestie, welcome to the LAM/MPI corner of the manual, pull up a chair 🫶 this one's a lil niche but honestly kinda iconic once you get it.

💖 NAME 💖

MPI_Errhandler_c2f — literally just converts an error handler from its C representation to its Fortran representation. that's the whole vibe. no cap.

🎀 SYNOPSIS 🎀

#include <mpi.h>
MPI_Fint
MPI_Errhandler_c2f(MPI_Errhandler err)

like. she's short. she's simple. she slays. 💅

🌸 INPUT PARAMETER 🌸

  • err — the C error handler, bestie. the one you're handing over to be converted. the main character of this whole operation 🦋

⭐ RETURN VALUE ⭐

  • f_handle — and out the other side comes the Fortran error handler. that's it, that's the trade. 🔥

👑 DESCRIPTION 👑

so, tea time ☕ — this is a non-standard MPI routine. it's not part of the official lineup, she's just here for a very specific reason: ROMIO needs it. that's literally the whole origin story. no grander purpose, no lore, ROMIO asked and she answered. periodt. 💜

🧚 NOTES FOR FORTRAN 🧚

some Fortran housekeeping, bestie, don't skip this part:

  • all MPI routines in Fortran (except for MPI_WTIME and MPI_WTICK) have an extra argument called ierr chillin' at the end of the argument list. 📎
  • ierr is an integer and it means the exact same thing as the return value of the routine in C. same energy, different language.
  • in Fortran, MPI routines are subroutines, and you invoke them with the call statement. so it's giving call MPI_whatever(...).
  • all MPI objects (e.g., MPI_Datatype, MPI_Comm) are of type INTEGER in Fortran. yes, even the fancy ones. all of them. 💫

🌈 ERRORS 🌈

okay this part's important, so listen up bestie:

this function does not return the normal MPI_SUCCESS integer value upon success. 🙈

instead? it returns a handle to the converted object. that's the whole return situation. and if an error occurs, the appropriate NULL handle will be returned. so like, watch out for that. 💀

🍓 SEE ALSO 🍓

  • MPI_Errhandler_c2f(3) — yes bestie, it's referencing itself. she's self-aware. we love a confident queen. 👑

💌 MORE INFORMATION 💌

if you want the deep lore, go check out the official MPI Forum web site, which contains the text of both the MPI-1 and MPI-2 standards. 📚 those documents have the detailed 411 on each MPI function (most of which, lowkey, is not duplicated in these man pages — so like, actually go read them).

http://www.mpi-forum.org/

🦋 LOCATION 🦋

handles.c — that's where she lives, that's her address, don't @ me. 🏠

and that's the whole page, bestie!! you ate that. 💅✨

LAM/MPI 7.1.4 · 6/24/2006 — yeah she's vintage, a true classic from the archives, and we stan a legacy queen. 🎀 sending you off with love and successfully-converted error handlers, mwah 💖🫶

📦 where this page comes from