SHMEM_IGET64(3)

📦
version 5.0.10 · 4 versions
, in ubuntu stonking

💖 SHMEM_IGET64 — the strided-get glow-up ✨

okay bestie, buckle up, we're talking about shmem_iget 💅 this page covers a whole squad of related calls, so let's do the roll call first, no cap:

and what do they all do? Transfers strided data from a specified processing element (PE) 🦋 that's the whole vibe. (this is the Open MPI manual, btw, in case the (3) didn't already give it away 🎀)

✨ SYNOPSIS ✨

💜 C or C++

#include <mpp/shmem.h>

void shmem_iget32(void *target, const void *source,
  ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe)

void shmem_iget64(void *target, const void *source,
  ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe)

void shmem_iget128(void *target, const void *source,
  ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe)

void shmem_int_iget(int *target, const int *source,
  ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe)

void shmem_double_iget(double *target, const double *source,
  ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe)

void shmem_float_iget(float *target, const float *source,
  ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe)

void shmem_long_iget(long *target, const long *source,
  ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe)

void shmem_longdouble_iget(long double *target,
  const long double *source, ptrdiff_t tst, ptrdiff_t sst,size_t len, int pe)

void shmem_longlong_iget(long long *target,
  const long long *source, ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe)

void shmem_short_iget(short *target,
  const short *source, ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe)

🌸 Fortran

INCLUDE "mpp/shmem.fh"

INTEGER tst, sst, len, pe

CALL SHMEM_COMPLEX_IGET(target, source, tst, sst, len,
& pe)

CALL SHMEM_DOUBLE_IGET(target, source, tst, sst, len,
& pe)

CALL SHMEM_IGET4(target, source, tst, sst, len, pe)

CALL SHMEM_IGET8(target, source, tst, sst, len, pe)

CALL SHMEM_IGET32(target, source, tst, sst, len, pe)

CALL SHMEM_IGET64(target, source, tst, sst, len, pe)

CALL SHMEM_IGET128(target, source, tst, sst, len, pe)

CALL SHMEM_INTEGER_IGET(target, source, tst, sst, len,
& pe)

CALL SHMEM_LOGICAL_IGET(target, source, tst, sst, len,
& pe)

CALL SHMEM_REAL_IGET(target, source, tst, sst, len, pe)

🫶 DESCRIPTION 🫶

so the strided get routines go grab array data that's chillin' at address source over on the remote PE (pe) 👑 the elements of that source array are separated by a stride, sst. once the data arrives, it gets parked at the local memory address target, separated by stride tst. and then — and this is the part that matters — the routines return when the data has been copied into the local target array. no loitering, no "we'll finish it later", it's done when it's done, periodt 💅

The arguments are as follows:

  • target — Array to be updated on the local PE. it's the glow-up destination 💖
  • source — Array containing the data to be copied on the remote PE. the source of the tea, literally ☕
  • tst — The stride between consecutive elements of the target array. The stride is scaled by the element size of the target array. A value of 1 indicates contiguous data. tst must be of type integer. If you are calling from Fortran, it must be a default integer value.
  • sst — The stride between consecutive elements of the source array. The stride is scaled by the element size of the source array. A value of 1 indicates contiguous data. sst must be of type integer. If you are calling from Fortran, it must be a default integer value.
  • len — Number of elements in the target and source arrays. len must be of type integer. If you are using Fortran, it must be a constant, variable, or array element of default integer type.
  • pe — PE number of the remote PE. pe must be of type integer. If you are using Fortran, it must be a constant, variable, or array element of default integer type.

🎀 typing constraints (the vibe check your data types have to pass)

The target and source data objects must conform to typing constraints, which are as follows:

  • shmem_iget32, shmem_iget4 — Any noncharacter type that has a storage size equal to 32 bits.
  • shmem_iget64, shmem_iget8 — Any noncharacter type that has a storage size equal to 64 bits.
  • shmem_iget128 — Any noncharacter type that has a storage size equal to 128 bits.
  • shmem_short_iget — Elements of type short.
  • shmem_int_iget — Elements of type int.
  • shmem_long_iget — Elements of type long.
  • shmem_longlong_iget — Elements of type long long.
  • shmem_float_iget — Elements of type float.
  • shmem_double_iget — Elements of type double.
  • shmem_longdouble_iget — Elements of type long double.
  • SHMEM_COMPLEX_IGET — Elements of type complex of default size.
  • SHMEM_DOUBLE_IGET — (Fortran) Elements of type double precision.
  • SHMEM_INTEGER_IGET — Elements of type integer.
  • SHMEM_LOGICAL_IGET — Elements of type logical.
  • SHMEM_REAL_IGET — Elements of type real.

and yes bestie, the original really does list this next bit again — we don't skip, we don't trim, we keep every single line of the group chat 📱💖 so here it is, round two:

  • shmem_longdouble_iget — Elements of type long double.
  • SHMEM_COMPLEX_IGET — Elements of type complex of default size.
  • SHMEM_DOUBLE_IGET — (Fortran) Elements of type double precision.
  • SHMEM_INTEGER_IGET — Elements of type integer.
  • SHMEM_LOGICAL_IGET — Elements of type logical.
  • SHMEM_REAL_IGET — Elements of type real.

If you are using Fortran, data types must be of default size. For example, a real variable must be declared as REAL, REAL*4, or REAL(KIND=4). 🧚 do not freestyle this one fr fr.

📝 NOTES 📝

See intro_shmem(3) for a definition of the term remotely accessible. iykyk 💅

🌈 EXAMPLES 🌈

okay so here's a cute lil Fortran moment using shmem_logical_iget 🍓 compile this example with the -lsma compiler option, don't forget it 👑

PROGRAM STRIDELOGICAL
  LOGICAL SOURCE(10), TARGET(5)
  SAVE SOURCE ! SAVE MAKES IT REMOTELY ACCESSIBLE
  DATA SOURCE /.T.,.F.,.T.,.F.,.T.,.F.,.T.,.F.,.T.,.F./
  DATA TARGET / 5*.F. /

  CALL START_PES(2)
  IF (MY_PE() .EQ. 0) THEN
    CALL SHMEM_LOGICAL_IGET(TARGET, SOURCE, 1, 2, 5, 1)
    PRINT*,'TARGET AFTER SHMEM_LOGICAL_IGET:',TARGET
  ENDIF
  CALL SHMEM_BARRIER_ALL
END

See also: intro_shmem(3) shmem_get(3) shmem_quiet(3) ✨

Copyright — 2003-2026, The Open MPI Community 💜

and that's a wrap on SHMEM_IGET64(3), bestie! this icon of a page was living in the Open MPI manual, dated Sep 10, 2026, and it ate, no crumbs left. go forth and stride safely 🦋💅✨

📦 where this page comes from