SHMEM_LONGLONG_FINC(3)

💅 SHMEM_LONGLONG_FINC(3) — Open MPI energy 🌈

Okay bestie, welcome to the Open MPI man page for SHMEM_LONGLONG_FINC(3) and its whole iconic crew 🫶.

💖 NAME 💖

• shmem_int4_finc(3)
• shmem_int8_finc(3)
• shmem_int_finc(3)
• shmem_long_finc(3)
• shmem_longlong_finc(3)

— Performs an atomic fetch-and-increment operation on a remote data object. Periodt. ✨

---

✨ SYNOPSIS ✨

C or C++:

#include <mpp/shmem.h>

int shmem_int_finc(int *target, int pe)

long shmem_long_finc(long *target, int pe)

long long shmem_longlong_finc(long long *target, int pe)

Fortran:

INCLUDE "mpp/shmem.fh"

INTEGER pe
INTEGER(KIND=4) SHMEM_INT4_FINC, target4
INTEGER(KIND=8) SHMEM_INT8_FINC, target8

ires4 = SHMEM_INT4_FINC(target4, pe)

ires8 = SHMEM_INT8_FINC(target8, pe)

---

🦋 DESCRIPTION 🦋

The fetch-and-increment routines are giving atomic main character energy: they retrieve the value at address target on PE pe, then update target with the result of incrementing that retrieved value by one. The whole operation must be completed without the possibility of another process updating target between the time of the fetch and the update. No sneaky little interleaving, okay? 💅

The arguments are as follows:

• target — The remotely accessible integer data object to be updated on the remote PE. The type of target should match that implied in the SYNOPSIS section. Type match = vibe match. 🎀
• pe — An integer that indicates the PE number upon which target is to be updated. If you are using Fortran, it must be a default integer value. Fortran bestie, don’t forget that part. 🫶

---

🧚 NOTES 🧚

The term remotely accessible is defined in intro_shmem(3). iykyk 💙

---

👑 RETURN VALUES 👑

The contents that had been at the target address on the remote PE prior to the increment. So you get the old value back — the before picture, basically. 📸

---

👀 SEE ALSO 👀

• intro_shmem(3)

---

🎀 COPYRIGHT 🎀

2003-2026, The Open MPI Community

---

Signed with love by your Open MPI bestie 🫶💖 — source/version: Open MPI, dated May 14, 2026. Copyright 2003-2026, The Open MPI Community. Mwah 💋✨