SHMEM\_LONG\_FINC(3) Open MPI SHMEM\_LONG\_FINC(3)

[shmem\_int4\_finc(3)](/man/enterprise-packages/openmpi-cuda-13.3/shmem_int4_finc.3), [shmem\_int8\_finc(3)](/man/enterprise-packages/openmpi-cuda-13.3/shmem_int8_finc.3), shmem\_int\_finc <#shmem-int-finc>(3), [shmem\_long\_finc(3)](/man/enterprise-packages/openmpi-cuda-13.3/shmem_long_finc.3), shmem\_longlong\_finc <#shmem-longlong-finc>(3) - Performs an atomic fetch-and-increment operation on a remote data object

# [SYNOPSIS](#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](#DESCRIPTION)

The fetch and increment routines retrieve the value at address **target** on PE **pe**, and update **target** with the result of incrementing the retrieved value by one. The operation must be completed without the possibility of another process updating **target** between the time of the fetch and the update.

The arguments are as follows:

[**target**](#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.

[**pe**](#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.

# [NOTES](#NOTES)

The term remotely accessible is defined in [*intro\_shmem*(3)](/man/enterprise-packages/openmpi-cuda-13.3/intro_shmem.3).

# [RETURN VALUES](#RETURN_VALUES)

The contents that had been at the target address on the remote PE prior to the increment.

**See also:**

[*intro\_shmem*(3)](/man/enterprise-packages/openmpi-cuda-13.3/intro_shmem.3)

# [Copyright](#Copyright)

2003-2026, The Open MPI Community

October 26, 2026

---

Document: shmem_long_finc(3) from openmpi-cuda-13.3 5.0.11-r1 (Chainguard OS)
Source: https://github.com/open-mpi/ompi