MPI_Win_Test(3)

πŸ’« MPI_Win_Test β€” the LAM/MPI manual page, bestie edition πŸ’«

okay so picture this: you're deep in the LAM/MPI manual (yes, that LAM/MPI, the MPI_Win_Test(3) one) and you land on this page. it's giving "window progress check" energy and honestly? let's get into it. πŸͺŸβœ¨


πŸŽ€ NAME πŸŽ€

MPI_Win_Test β€” literally just testing for progress on a window. that's the whole gig. she's a vibe checker for your window. πŸ’…


🌸 SYNOPSIS 🌸

#include <mpi.h>
int MPI_Win_test(MPI_Win win, int *flag)

look at her. so short. so iconic. πŸ¦‹


✨ INPUT PARAMETERS ✨

  • win β€” the window, as a handle. your window. the one you're checking on. treat her well 🫢

πŸ’– OUTPUT PARAMETERS πŸ’–

  • flag β€” an (integer). yes bestie, that's the entire description, i'm not hiding anything from you, the manpage just said that and i respect the manpage 😭

πŸ”₯ NOTES πŸ”₯

not me having to tell you this 😭 β€” this function is currently not implemented in LAM/MPI. like, at all. she's not built. she doesn't exist yet.

and because she doesn't exist, calling her will return an MPI_ERR_OTHER run time error. so like... don't expect progress. expect an error. that's the whole tea. πŸ’€


🌈 NOTES FOR FORTRAN 🌈

fortran besties, this section is for YOU, and it's important, so no scrolling past it πŸ™ˆ

  • every MPI routine in Fortran (with the two iconic exceptions: MPI_WTIME and MPI_WTICK) gets an additional argument at the very end of the argument list, and that argument is named ierr.
  • ierr is an integer, and it means exactly the 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. periodt.
  • and one more thing: all MPI objects (for example MPI_Datatype, MPI_Comm) are of type INTEGER in Fortran. all of them. every single one. πŸ‘‘

πŸ‘‘ LOCATION πŸ‘‘

wtest.c

that's where she lives. that's her address. 🏠


πŸ¦‹ a lil sign-off πŸ¦‹

this lil masterpiece comes to you from LAM/MPI 7.1.4, dated 6/24/2006. old? yes. iconic? also yes. she's been sitting in the docs this whole time waiting for you to read her, and now you have. slay πŸ’…πŸŽ€βœ¨