SHMEM_FINC(3) Open MPI SHMEM_FINC(3)
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
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 retrieve the value at address target
on PE pe, and update target with the result of incrementing the re-
trieved value by one. The operation must be completed without the pos-
sibility of another process updating target between the time of the
fetch and the update.
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.
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 inte-
ger value.
NOTES
The term remotely accessible is defined in intro_shmem(3).
RETURN VALUES
The contents that had been at the target address on the remote PE prior
to the increment.
SEE ALSO
intro_shmem(3)
4.1.2 Nov 24, 2021 SHMEM_FINC(3)
Generated by dwww version 1.14 on Mon Jan 27 08:39:27 CET 2025.