dwww Home | Manual pages | Find package

SHMEM_ADD(3)                       Open MPI                       SHMEM_ADD(3)

NAME
       shmem_int_add(3),         shmem_int4_add(3),         shmem_int8_add(3),
       shmem_long_add(3), shmem_longlong_add(3) - Performs an atomic add oper-
       ation.

SYNOPSIS
       C or C++:
       #include <mpp/shmem.h>

       void shmem_int_add(int *target, int value, int pe);
       void shmem_long_add(long *target, long value, int pe);
       void shmem_longlong_add(long long *target, long long value,
         int pe);

       Fortran:
       include 'mpp/shmem.h'

       INTEGER pe

       CALL SHMEM_INT4_ADD(target, value, pe)
       CALL SHMEM_INT8_ADD(target, value, pe)

DESCRIPTION
       The  atomic  add routines add value to the data at address target on PE
       pe.  The operation completes without the possibility 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. If you are using C/C++, the  type  of  target  should
              match that implied in the SYNOPSIS section. If you are using the
              Fortran compiler, it must be of type  integer  with  an  element
              size   of   4   bytes   for   SHMEM_INT4_ADD  and  8  bytes  for
              SHMEM_INT8_ADD.

       value  The value to be atomically added to target.  If  you  are  using
              C/C++, the type of value should match that implied in the SYNOP-
              SIS section. If you are using Fortran, it must be of type  inte-
              ger with an element size of target.

       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).

SEE ALSO
       intro_shmem(3), shmem_cache(3)

4.1.2                            Nov 24, 2021                     SHMEM_ADD(3)

Generated by dwww version 1.14 on Mon Jan 27 09:45:51 CET 2025.