SHMEM_GET8_NBI(3)

🎀 NAME 🎀

okay so bestie, this is the manual page for SHMEM_GET8_NBI(3) from Open MPI, and honestly? it's a whole family reunion 💖 The nonblocking get routines give you a method for copying data from a contiguous remote data object on the PE you point at, over to your local data object. That's the whole vibe. Copy, remote, local, slay.

The entire squad, roll call 📣:

• shmem_getmem_nbi(3)
• shmem_char_get_nbi(3)
• shmem_short_get_nbi(3)
• shmem_int_get_nbi(3)
• shmem_long_get_nbi(3)
• shmem_longlong_get_nbi(3)
• shmem_float_get_nbi(3)
• shmem_double_get_nbi(3)
• shmem_longdouble_get_nbi(3)
• shmem_get8_nbi(3)
• shmem_get16_nbi(3)
• shmem_get32_nbi(3)
• shmem_get64_nbi(3)
• shmem_get128_nbi(3)

Every single one of them is a nonblocking get routine, and every single one of them copies data from a contiguous remote data object on the specified PE to the local data object. periodt 💅

---

✨ SYNOPSIS ✨

C or C++:

#include <mpp/shmem.h>

void shmem_getmem_nbi(void *dest, const void *source,
  size_t nelems, int pe)

void shmem_char_get(char *dest, const char *source,
  size_t nelems, int pe)

void shmem_short_get(short *dest, const short *source,
  size_t nelems, int pe)

void shmem_int_get(int *dest, const int *source,
  size_t nelems, int pe)

void shmem_long_get(long *dest, const long *source,
  size_t nelems, int pe)

void shmem_longlong_get(long long *dest, const long long *source,
  size_t nelems, int pe)

void shmem_float_get(float *dest, const float *source,
  size_t nelems, int pe)

void shmem_double_get(double *dest, const double *source,
  size_t nelems, int pe)

void shmem_longdouble_get(long double *dest, const long double *source,
  size_t nelems, int pe)

void shmem_get8(void *dest, const void *source,
  size_t nelems, int pe)

void shmem_get16(void *dest, const void *source,
  size_t nelems, int pe)

void shmem_get32(void *dest, const void *source,
  size_t nelems, int pe)

void shmem_get64(void *dest, const void *source,
  size_t nelems, int pe)

void shmem_get128(void *dest, const void *source,
  size_t nelems, int pe)

Fortran:

INCLUDE "mpp/shmem.fh"

INTEGER nelems, pe

CALL SHMEM_GETMEM_NBI(dest, source, nelems, pe)

CALL SHMEM_CHARACTER_GET_NBI(dest, source, nelems, pe)

CALL SHMEM_COMPLEX_GET_NBI(dest, source, nelems, pe)

CALL SHMEM_DOUBLE_GET_NBI(dest, source, nelems, pe)

CALL SHMEM_INTEGER_GET_NBI(dest, source, nelems, pe)

CALL SHMEM_LOGICAL_GET_NBI(dest, source, nelems, pe)

CALL SHMEM_REAL_GET_NBI(dest, source, nelems, pe)

CALL SHMEM_GET4_NBI(dest, source, nelems, pe)

CALL SHMEM_GET8_NBI(dest, source, nelems, pe)

CALL SHMEM_GET32_NBI(dest, source, nelems, pe)

CALL SHMEM_GET64_NBI(dest, source, nelems, pe)

CALL SHMEM_GET128_NBI(dest, source, nelems, pe)

---

💫 DESCRIPTION 💫

So here's the tea 🍓 The get routines provide a method for copying a contiguous symmetric data object from a different PE to a contiguous data object on the local PE.

The routines return after posting the operation. That's it. They bounce. They're not done, they just posted 👑 The operation is considered complete only after a subsequent call to shmem_quiet(3). And at the completion of shmem_quiet(3), the data has officially been delivered to the dest array on the local PE. no cap.

The arguments, bestie, one by one:

• dest — the local data object that's getting updated. this is the one that changes.
• source — the data object sitting on the PE identified by pe, and it holds the data you want copied. this data object must be remotely accessible.
• nelems — number of elements in the target and source arrays. len must be of type integer. If you're writing Fortran, it has to be a constant, a variable, or an array element of default integer type.
• pe — the PE number of the remote PE. pe must be of type integer. And if you're in Fortran, same deal: a constant, a variable, or an array element of default integer type.

🫶 Fortran girlies listen up: if you're using Fortran, data types must be of default size. Like, a real variable has to be declared as REAL, REAL*4, or REAL(KIND=4). don't get cute with it.

---

📌 NOTES 📌

Go read intro_shmem(3) for a definition of the term remotely accessible. it's giving required reading, iykyk 🎀

---

🔥 EXAMPLES 🔥

Consider this simple example, for Fortran:

PROGRAM REDUCTION
  REAL VALUES, SUM
  COMMON /C/ VALUES
  REAL WORK

  CALL START_PES(0) ! ALLOW ANY NUMBER OF PES
  VALUES = MY_PE() ! INITIALIZE IT TO SOMETHING
  CALL SHMEM_BARRIER_ALL
  SUM = 0.0
  DO I = 0,NUM_PES()-1
    CALL SHMEM_REAL_GET_NBI(WORK, VALUES, 1, I)
    CALL SHMEM_QUIET                ! wait for delivery
    SUM = SUM + WORK
  ENDDO
  PRINT *, 'PE ', MY_PE(), ' COMPUTED SUM=', SUM
  CALL SHMEM_BARRIER_ALL
END

See also:

• intro_shmem(3)
• shmem_quiet(3)

---

🦋 Copyright 🦋

2003-2026, The Open MPI Community

---

and that's the whole page, bestie 💖 you made it to the end, so here's the sign-off: this serve was brought to you by the Open MPI girlies, copyright held by The Open MPI Community from 2003-2026, and the timestamp on the original footer said Sep 10, 2026 — so yeah, she's fresh, she's SHMEM_GET8_NBI(3), and she ate. go call shmem_quiet(3) before you assume anything landed 🌸✨