MPI_Errhandler_f2c(3)

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

💅 MPI_Errhandler_f2c(3) — LAM/MPI, bestie edition

okay so this is a page from the LAM/MPI manual, and it's about turning a Fortran error handler into its C glow-up. literally a translator for vibes between two languages. let's get into it 🦋

✨ NAME ✨

MPI_Errhandler_f2c — convert an error handler from its Fortran representation to its C representation 🎀

✨ SYNOPSIS ✨

#include <mpi.h>
MPI_Errhandler
MPI_Errhandler_f2c(MPI_Fint f_handle)

✨ INPUT PARAMETER ✨

  • f_handle — the Fortran error handler, babes. that's the thing you're handing over to get converted 💖

✨ RETURN VALUE ✨

  • errh — the C error handler. that's your shiny new converted object, no cap ✨

✨ DESCRIPTION ✨

so this is a non-standard MPI routine — like, not part of the official squad, she's doing her own thing 💅. the reason she exists at all? mainly because ROMIO needs it. that's it. that's the whole story. iconic honestly.

✨ NOTES FOR FORTRAN ✨

important lore for the Fortran girlies 🧚:

  • literally every MPI routine in Fortran — except MPI_WTIME and MPI_WTICK — has an extra argument called ierr tacked onto 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. lowkey the same energy, different outfit.
  • in Fortran, MPI routines are subroutines, and you invoke them with the call statement. periodt.
  • every single MPI object (like MPI_Datatype, MPI_Comm, etc.) is of type INTEGER in Fortran. that's just the rules 🎀

✨ ERRORS ✨

bestie, heads up, this one is different 🚨

this function does not return the normal MPI_SUCCESS integer value when it works. instead, it returns a handle to the converted object. so if you're sitting there waiting for MPI_SUCCESS, you're gonna be waiting forever 🙈.

and if an error happens? the appropriate NULL handle gets returned. that's your signal that something went sideways. no integer, no code, just a null handle. it's giving "read the room" 💀

✨ SEE ALSO ✨

✨ MORE INFORMATION ✨

want more? the official MPI Forum web site has the whole tea ☕ — it's got the text of both the MPI-1 and MPI-2 standards. those documents have detailed info about every MPI function, most of which is not duplicated in these man pages, so if you need the deep lore, go there:

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

✨ LOCATION ✨

handles.c — that's where she lives 🏠

LAM/MPI 7.1.4 · 6/24/2006 — mwah, that's the version and the date, bestie, and this page is officially a wrap 💖✨🎀🦋

📦 where this page comes from