MPI_Win_Lock(3)

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

💫 NAME 💫

MPI_Win_Lock — bestie, this one starts an RMA access epoch. that's the whole vibe. ✨

🎀 SYNOPSIS 🎀

#include <mpi.h>
int MPI_Win_lock(int lock_type, int rank, int assert, MPI_Win win)

🌸 INPUT PARAMETERS 🌸

okay so here's what you're handing it, no cap:

  • lock_type — this one's gotta be either MPI_LOCK_EXCLUSIVE or MPI_LOCK_SHARED (it's the state, periodt)
  • rank — the rank of the locked window, and it's a nonnegative integer bestie, keep it cute 💅
  • assert — your program assertion, an integer, lowkey just say what you mean
  • win — the window object, a handle 🫶

😭 NOTES 😭

not me having to tell you this but... this function is currently not implemented in LAM/MPI. fr fr. it's gonna return an MPI_ERR_OTHER run time error. that's it, that's the tea. 💀

🦋 NOTES FOR FORTRAN 🦋

bestie the Fortran lore is real, so listen up:

  • every single MPI routine in Fortran (except for 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. iconic.
  • in Fortran, MPI routines are subroutines, and you invoke them with the call statement. that's the rule. ✨
  • also!! all MPI objects (like MPI_Datatype, MPI_Comm) are of type INTEGER in Fortran. no exceptions, iykyk. 💜

👑 LOCATION 👑

wlock.c — that's where she lives, go say hi 🌈

and that's a wrap, bestie!! this page is from LAM/MPI 7.1.4, dated 6/24/2006 — oldie but a goodie, we stan a vintage manpage 🎀💖 slay, go forth and lock those windows (except, y'know, not in LAM/MPI, see above 🙈) 🍓⭐

📦 where this page comes from