blob: 6b5d62891779bcabe97d3958464a1d9a7d8b60ff [file] [log] [blame]
<html>
<head>
<title>shmem_short_iput</title>
</head>
<h2 id="top">shmem_short_iput</h2>
<h4>Purpose</h4>
<p>Transfers strided data to a specified processing element (PE).
</p>
<h4>C syntax</h4>
<pre>
#include &lt;shmem.h&gt;
void shmem_short_iput(short *target, const short *source, ptrdiff_t tst, ptrdiff_t sst, size_t len, int pe);
</pre>
<h4>Parameters</h4>
<dl>
<dt class="bold">INPUT</dt>
<dd>
</dd>
<dt class="bold ">target</dt>
<dd>Remotely accessible strided array on the remote PE that receives the data.
</dd>
<dt class="bold ">source</dt>
<dd>The strided array on the local PE that contains the data to be transferred.
</dd>
<dt class="bold">tst</dt>
<dd>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.
</dd>
<dt class="bold">sst</dt>
<dd>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.
</dd>
<dt class="bold">len</dt>
<dd>Number of elements in the target and source arrays.
</dd>
<dt class="bold">pe</dt>
<dd>Processing element number of the remote PE.
</dd>
</dl>
<h4>Description</h4>
<div class="ledi">
<p>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</p>
<p>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.</p>
<p>The function shmem_short_iput() writes strided array of type short to the
remote PE.</p>
<h4>IBM NOTES</h4>
<div class="ledi">
<dl>
<p>Please refer to Atomicity and Coherency section for atomicity and coherence model in the OpenSHMEM documentation</p>
</dd>
</dl>
<h4>C examples</h4>
<pre>
</pre>
<h4>Related information</h4>
<p>Subroutines: shmem_barrier, shmem_put, shmem_fence, shmem_iput, shmem_quiet
</p>
<hr><a href="apiIndex.html">OpenSHMEM API Index</a>
</html>