| <html>
|
| <head>
|
| <title>shmem_get</title>
|
| </head>
|
| <h2 id="top">shmem_get</h2>
|
| <h4>Purpose</h4>
|
|
|
|
|
| <p>Transfers data from a specified processing element (PE).
|
| </p>
|
|
|
| <h4>C syntax</h4>
|
|
|
| <pre>
|
| #include <shmem.h>
|
|
|
| void shmem_get(void *target, const void *source, size_t len, int pe);
|
|
|
| </pre>
|
|
|
| <h4>Parameters</h4>
|
|
|
|
|
| <dl>
|
| <dt class="bold">INPUT</dt>
|
| <dd>
|
|
|
| </dd>
|
| <dt class="bold ">target</dt>
|
| <dd>Local data object to be updated.
|
| </dd>
|
| <dt class="bold ">source</dt>
|
| <dd>Remotely accessible data object on the remote PE that contains the data to be copied.
|
| </dd>
|
| <dt class="bold">len</dt>
|
| <dd>Number of elements in the target and source arrays. len must be of type integer.
|
| </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 contiguous data object from the remote PE to a contiguous data object on the local PE</p>
|
| <p>This routine returns when the data has been copied out of the source array on the local PE.</p>
|
| <p>The function shmem_get() reads any non-character type that has a storage size
|
| equal to 64 bits from a 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> |
