shmem_iput64

Purpose

Transfers strided data to a specified processing element (PE).

C syntax

#include <shmem.h>
 
void shmem_iput64(void *target, const void *source, ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe);
 

Parameters

INPUT
target
Remotely accessible strided array on the remote PE that receives the data.
source
The strided array on the local PE that contains the data to be transferred.
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.
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.
len
Number of elements in the target and source arrays.
pe
Processing element number of the remote PE.

Description

This routine provides a high-performance method for copying a strided array from the local PE to a contiguous data object on a different PE

This routine returns when the data has been copied out of the source array on the local PE, but not necessarily before the data has been delivered to the remote data object. To enforce the ordering/completion of the iput routines, the use of shmem_fence, shmem_quiet, shmem_barrier or shmem_barrier_all is needed.

The function shmem_iput64() writes strided array where each element is any non character type that has a storage size equal to 64 bits to the remote PE.

IBM NOTES

Please refer to Atomicity and Coherency section for atomicity and coherence model in the OpenSHMEM documentation

C examples



Related information

Subroutines: shmem_barrier, shmem_put, shmem_fence, shmem_iput, shmem_quiet


OpenSHMEM API Index