| <html>
|
| <head>
|
| <title>shmem_long_wait_until</title>
|
| </head>
|
| <h2 id="top">shmem_long_wait_until</h2>
|
| <h4>Purpose</h4>
|
|
|
|
|
| <p>Waits for a variable on the local processing element (PE) to change.
|
| </p>
|
|
|
| <h4>C syntax</h4>
|
|
|
| <pre>
|
| #include <shmem.h>
|
|
|
| void shmem_long_wait_until(long *var, int cond, long value);
|
|
|
| </pre>
|
|
|
| <h4>Parameters</h4>
|
|
|
|
|
| <dl>
|
| <dt class="bold">INPUT</dt>
|
| <dd>
|
|
|
| </dd>
|
| <dt class="bold ">ivar</dt>
|
| <dd>A remotely accessible integer variable that is being updated by a remote PE.
|
| </dd>
|
| <dt class="bold ">cond</dt>
|
| <dd>The compare operator that compares var with value. The following are the supported cond values:
|
| <p> SHMEM_CMP_EQ Equal </p>
|
| <p> SHMEM_CMP_NE Not equal</p>
|
| <p> SHMEM_CMP_GT Greater then</p>
|
| <p> SHMEM_CMP_LE Less then or equal</p>
|
| <p> SHMEM_CMP_LT Less then operator</p>
|
| <p> SHMEM_CMP_GE Greater then or equal.</p>
|
| </dd>
|
| <dt class="bold ">value</dt>
|
| <dd>The right operand of the compare operator cond.
|
| The left one is the value pointed by var.
|
| </dd>
|
| </dl>
|
| <h4>Description</h4>
|
|
|
| <div class="ledi">
|
| <p>This function is used for point-to-point synchronization. It suspends the execution of the calling PE until the value of the symmetric variable var is changed</p>
|
| <p>The function shmem_long_wait_until() blocks the calling PE until some remote PE
|
| changes the long variable var to satisfy the condition implied by comp and val.</p>
|
|
|
| <h4>C examples</h4>
|
| <pre>
|
| </pre>
|
|
|
| <h4>Related information</h4>
|
|
|
| <p>Subroutines: shmem_put
|
| </p>
|
| <hr><a href="apiIndex.html">OpenSHMEM API Index</a> |
| </html> |