SHMEM_ADDR_ACCESSIBLE(3)

📦
version 5.0.10 · 7 versions
, in ubuntu stonking

💖 SHMEM_ADDR_ACCESSIBLE 💖

okay bestie, gather round, we're doing a vibe check on memory addresses today ✨ this is shmem_addr_accessible from the Open MPI manual, section 3, and it answers the question every distributed-memory girlie eventually asks: is this address even reachable from that other PE? 🦋

Basically: it tells you whether an address is accessible via OpenSHMEM operations from the specified remote PE. That's it. That's the whole gig. 💅

🎀 SYNOPSIS 🎀

C or C++ girlies, you're gonna:

#include <mpp/shmem.h>

int shmem_addr_accessible(const void *addr, int pe)

Fortran besties, this is your moment:

INCLUDE "mpp/shmem.fh"

LOGICAL LOG, SHMEM_ADDR_ACCESSIBLE
INTEGER pe

LOG = SHMEM_ADDR_ACCESSIBLE(addr, pe)

🫶 DESCRIPTION 🫶

shmem_addr_accessible is a query function. It does not change anything, it does not move anything, it just 👀 looks.

What it's telling you: whether a local address is accessible via SHMEM operations from the specified remote PE. So like, from the local PE's point of view, can that remote PE actually get to this address? 👑

It's checking two things, lowkey both of them matter:

  • the remote PE is accessible via SHMEM data transfer functions from the local PE, and
  • the address you handed it lives in a symmetric data segment with respect to that remote PE.

Both boxes ticked? You're slaying. One box unticked? It's giving 0, bestie. 😭

✨ RETURN VALUES ✨

C girlies get numbers, Fortran girlies get vibes:

  • C: the return value is 1 if addr is a symmetric data object and accessible via SHMEM operations from the specified remote PE; otherwise, it is 0.
  • Fortran: the return value is .TRUE. if addr is a symmetric data object and accessible via SHMEM operations from the specified remote PE; otherwise, it is .FALSE..
ngl this one is a yes/no situation and that's the entire personality. no cap. 🍓

🌸 SEE ALSO 🌸

go read these next, iykyk:

2003-2026, The Open MPI Community — iconic behavior from the Open MPI Community, protecting this knowledge since 2003 fr fr 💜

and that's the whole page, bestie!! this was the SHMEM_ADDR_ACCESSIBLE(3) page from Open MPI, and it came to you dated Sep 10, 2026 🌈💖 mwah, go check your addresses, love u 🎀

📦 where this page comes from