blob: ff7e89dfd4e3891796e1e369980ec924b440ab68 [file] [log] [blame]
<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 &lt;shmem.h&gt;
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>