Files
MPIonCell/documentation/developer/html/d3/d32/group__internal__tm.html
T
2017-10-26 19:57:24 +02:00

388 lines
27 KiB
HTML
Executable File

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>MPI On Cell (Documentation): Test-Macros</title>
<link href="../../doxygen.css" rel="stylesheet" type="text/css">
<link href="../../tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.6 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="../../main.html"><span>Main&nbsp;Page</span></a></li>
<li><a href="../../modules.html"><span>Modules</span></a></li>
<li><a href="../../annotated.html"><span>Data&nbsp;Structures</span></a></li>
<li><a href="../../files.html"><span>Files</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>Test-Macros<br>
<small>
[<a class="el" href="../../dd/df8/group__internal__core.html">Implementation-Core</a>]</small>
</h1>
<p>
<div class="dynheader">
Collaboration diagram for Test-Macros:</div>
<div class="dynsection">
<center><table><tr><td><img src="../../d3/d32/group__internal__tm.png" border="0" alt="" usemap="#d5/d75/d3_2d32_2group____internal____tm_map">
<map name="d5/d75/d3_2d32_2group____internal____tm_map">
<area shape="rect" href="../../dd/df8/group__internal__core.html" title="This section deals with the data&#45;structures and the basic concepts which form the..." alt="" coords="7,5,145,32"></map></td></tr></table></center>
</div>
<hr><a name="_details"></a><h2>Detailed Description</h2>
Predefined Macros for testing the validity of parameters.
<p>
<p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#gfc07f5e570f47525b80a1f3e5a36b3b3">IMOC_TEST_COMM_SEND</a>(comm)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if invalid communicator in a send-operation. <a href="#gfc07f5e570f47525b80a1f3e5a36b3b3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#g7e5044180aa40d4a5a41108f88559871">IMOC_TEST_COMM_RECV</a>(comm)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if invalid communicator in a recv-operation. <a href="#g7e5044180aa40d4a5a41108f88559871"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#g49637a9f588e1c44584d8def5c45e811">IMOC_TEST_TAG_SEND</a>(tag)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if invalid tag in a send-operation. <a href="#g49637a9f588e1c44584d8def5c45e811"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#ge0070a22959ddde28816cc5676687b1d">IMOC_TEST_TAG_RECV</a>(tag)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if invalid tag in a recv-operation. <a href="#ge0070a22959ddde28816cc5676687b1d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#g1dfddaa8f7d9aad32b00248c7dc782d2">IMOC_TEST_RANK</a>(rank)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if invalid rank. <a href="#g1dfddaa8f7d9aad32b00248c7dc782d2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#g796b45379e44e6ad2d1895ac56d80d3c">IMOC_TEST_RANK_RECV</a>(rank)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if invalid rank in a recv-operation. <a href="#g796b45379e44e6ad2d1895ac56d80d3c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#g8026463e106a01cc8efb816d7dc1036a">IMOC_TEST_BYTECOUNT</a>(count)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if invalid byte-count in a recv-operation. <a href="#g8026463e106a01cc8efb816d7dc1036a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#g52f61fd7f3253d10b740a9fc792052c6">IMOC_TEST_BUFFER</a>(buf)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if invalid buffer-pointer. <a href="#g52f61fd7f3253d10b740a9fc792052c6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#g615b65fb3c3ad16711686a178ac7d1c3">IMOC_TEST_PROC_NULL</a>(rank)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if rank is MOC_PROC_NULL and returns with MOC_SUCCESS itself. <a href="#g615b65fb3c3ad16711686a178ac7d1c3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#gf902b6e1cbe077abf0f8d02a488fec8a">IMOC_TEST_PROC_SELF</a>(proc)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if rank is own rank and returns with MOC_SUCCESS itself. <a href="#gf902b6e1cbe077abf0f8d02a488fec8a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d3/d32/group__internal__tm.html#gc89a1f53869fe90c838a714621e20d88">IMOC_TEST_ALIGNMENT</a>(address)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Tests if address is 16-byte aligned. <a href="#gc89a1f53869fe90c838a714621e20d88"></a><br></td></tr>
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="gc89a1f53869fe90c838a714621e20d88"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_ALIGNMENT" ref="gc89a1f53869fe90c838a714621e20d88" args="(address)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_ALIGNMENT </td>
<td>(</td>
<td class="paramtype">address&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ( ((<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span>)(address)) % 16 != 0 ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#g8dd6c4666118378bdd3cb6cfeaeea5b1" title="Base-Adress of Buffer isn&amp;#39;t 16-byte aligned.">MOC_ERR_BAD_ALIGNMENT</a>; }
</pre></div>Tests if address is 16-byte aligned.
<p>
Calls return with appropriate error-code itself.
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00135">135</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d2/db6/moc__bsend__ppu_8c-source.html#l00010">MOC_Bsend()</a>, <a class="el" href="../../df/df8/moc__issend__ppu_8c-source.html#l00010">MOC_ISsend()</a>, <a class="el" href="../../d8/dbc/moc__recv__ppu_8c-source.html#l00011">MOC_Recv()</a>, and <a class="el" href="../../d4/db6/moc__ssend__ppu_8c-source.html#l00010">MOC_Ssend()</a>.</p>
</div>
</div><p>
<a class="anchor" name="g52f61fd7f3253d10b740a9fc792052c6"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_BUFFER" ref="g52f61fd7f3253d10b740a9fc792052c6" args="(buf)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_BUFFER </td>
<td>(</td>
<td class="paramtype">buf&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ( (buf) == 0 ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#gec3f466bf958e93fc3792674d00bfa06" title="Invalid buffer pointer.">MOC_ERR_BUFFER</a>; }
</pre></div>Tests if invalid buffer-pointer.
<p>
Calls return with appropriate error-code itself.
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00116">116</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d2/db6/moc__bsend__ppu_8c-source.html#l00010">MOC_Bsend()</a>, <a class="el" href="../../df/df8/moc__issend__ppu_8c-source.html#l00010">MOC_ISsend()</a>, <a class="el" href="../../d8/dbc/moc__recv__ppu_8c-source.html#l00011">MOC_Recv()</a>, and <a class="el" href="../../d4/db6/moc__ssend__ppu_8c-source.html#l00010">MOC_Ssend()</a>.</p>
</div>
</div><p>
<a class="anchor" name="g8026463e106a01cc8efb816d7dc1036a"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_BYTECOUNT" ref="g8026463e106a01cc8efb816d7dc1036a" args="(count)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_BYTECOUNT </td>
<td>(</td>
<td class="paramtype">count&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ( (count) &lt; 0 || (count) &gt; <a class="code" href="../../d1/d82/moc_8h.html#96f9a08f0625fd26bc341ab4f950d7c1" title="Maximum byte-count of a MOC-message.">MAX_MOC_MESSAGE_SIZE</a> ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#g5adca254d3feab57a4786c17b90d91c4" title="Invalid count argument.">MOC_ERR_COUNT</a>; }
</pre></div>Tests if invalid byte-count in a recv-operation.
<p>
Calls return with appropriate error-code itself.
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00109">109</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d2/db6/moc__bsend__ppu_8c-source.html#l00010">MOC_Bsend()</a>, <a class="el" href="../../dd/d90/moc__dma-get__ppu_8c-source.html#l00009">MOC_Get_data()</a>, <a class="el" href="../../d8/da3/moc__dma-iget__ppu_8c-source.html#l00011">MOC_IGet_data()</a>, <a class="el" href="../../dd/dd5/moc__dma-iput__ppu_8c-source.html#l00011">MOC_IPut_data()</a>, <a class="el" href="../../df/df8/moc__issend__ppu_8c-source.html#l00010">MOC_ISsend()</a>, <a class="el" href="../../da/d4a/moc__dma-put__ppu_8c-source.html#l00009">MOC_Put_data()</a>, <a class="el" href="../../d8/dbc/moc__recv__ppu_8c-source.html#l00011">MOC_Recv()</a>, and <a class="el" href="../../d4/db6/moc__ssend__ppu_8c-source.html#l00010">MOC_Ssend()</a>.</p>
</div>
</div><p>
<a class="anchor" name="g7e5044180aa40d4a5a41108f88559871"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_COMM_RECV" ref="g7e5044180aa40d4a5a41108f88559871" args="(comm)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_COMM_RECV </td>
<td>(</td>
<td class="paramtype">comm&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ( (comm) != <a class="code" href="../../d1/dd1/group__comm__mgt.html#g14e1cb53b99b5e239d4cc6a8d370ad94" title="Specifies a constant that contains all of the processes.">MOC_COMM_WORLD</a> &amp;&amp; (comm) != <a class="code" href="../../d1/dd1/group__comm__mgt.html#gf8c5dfb6bb79027948fe63f4cf6504eb" title="Specifies a constant that contains only the calling process.">MOC_COMM_SELF</a> ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#gc1e776c0e7cb8c97391dd6ac476295a1" title="Invalid communicator.">MOC_ERR_COMM</a>; }
</pre></div>Tests if invalid communicator in a recv-operation.
<p>
Calls return with appropriate error-code itself.
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00074">74</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d8/dbc/moc__recv__ppu_8c-source.html#l00011">MOC_Recv()</a>.</p>
</div>
</div><p>
<a class="anchor" name="gfc07f5e570f47525b80a1f3e5a36b3b3"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_COMM_SEND" ref="gfc07f5e570f47525b80a1f3e5a36b3b3" args="(comm)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_COMM_SEND </td>
<td>(</td>
<td class="paramtype">comm&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ( (comm) != <a class="code" href="../../d1/dd1/group__comm__mgt.html#g14e1cb53b99b5e239d4cc6a8d370ad94" title="Specifies a constant that contains all of the processes.">MOC_COMM_WORLD</a> &amp;&amp; (comm) != <a class="code" href="../../d1/dd1/group__comm__mgt.html#gf8c5dfb6bb79027948fe63f4cf6504eb" title="Specifies a constant that contains only the calling process.">MOC_COMM_SELF</a> ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#gc1e776c0e7cb8c97391dd6ac476295a1" title="Invalid communicator.">MOC_ERR_COMM</a>; }
</pre></div>Tests if invalid communicator in a send-operation.
<p>
Calls return with appropriate error-code itself.
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00067">67</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d2/db6/moc__bsend__ppu_8c-source.html#l00010">MOC_Bsend()</a>, <a class="el" href="../../df/df8/moc__issend__ppu_8c-source.html#l00010">MOC_ISsend()</a>, and <a class="el" href="../../d4/db6/moc__ssend__ppu_8c-source.html#l00010">MOC_Ssend()</a>.</p>
</div>
</div><p>
<a class="anchor" name="g615b65fb3c3ad16711686a178ac7d1c3"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_PROC_NULL" ref="g615b65fb3c3ad16711686a178ac7d1c3" args="(rank)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_PROC_NULL </td>
<td>(</td>
<td class="paramtype">rank&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ((rank) == <a class="code" href="../../d1/d82/moc_8h.html#c9d0a73c0b75a124512f3f3f6cc31787" title="Specifies a rank that can be used to send or receive from no-one.">MOC_PROC_NULL</a> ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#g8a73ed6676bcf0c0607d98482ca1aca4" title="No error.">MOC_SUCCESS</a>; }
</pre></div>Tests if rank is MOC_PROC_NULL and returns with MOC_SUCCESS itself.
<p>
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00122">122</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d2/db6/moc__bsend__ppu_8c-source.html#l00010">MOC_Bsend()</a>, <a class="el" href="../../df/df8/moc__issend__ppu_8c-source.html#l00010">MOC_ISsend()</a>, <a class="el" href="../../d8/dbc/moc__recv__ppu_8c-source.html#l00011">MOC_Recv()</a>, and <a class="el" href="../../d4/db6/moc__ssend__ppu_8c-source.html#l00010">MOC_Ssend()</a>.</p>
</div>
</div><p>
<a class="anchor" name="gf902b6e1cbe077abf0f8d02a488fec8a"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_PROC_SELF" ref="gf902b6e1cbe077abf0f8d02a488fec8a" args="(proc)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_PROC_SELF </td>
<td>(</td>
<td class="paramtype">proc&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ( (proc) == <a class="code" href="../../dd/df8/group__internal__core.html#geed5a271d50368d3cf9a858c4f57c895" title="Information each node knowns about himself and the world.">node_handle</a>.<a class="code" href="../../d8/d93/structmoc__node__handle__ppu__struct.html#9005ee3d6d0ee8b2f15628dcca724710" title="rank of node">rank</a> ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#g8a73ed6676bcf0c0607d98482ca1aca4" title="No error.">MOC_SUCCESS</a>; }
</pre></div>Tests if rank is own rank and returns with MOC_SUCCESS itself.
<p>
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00128">128</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d2/db6/moc__bsend__ppu_8c-source.html#l00010">MOC_Bsend()</a>, <a class="el" href="../../df/df8/moc__issend__ppu_8c-source.html#l00010">MOC_ISsend()</a>, <a class="el" href="../../d8/dbc/moc__recv__ppu_8c-source.html#l00011">MOC_Recv()</a>, and <a class="el" href="../../d4/db6/moc__ssend__ppu_8c-source.html#l00010">MOC_Ssend()</a>.</p>
</div>
</div><p>
<a class="anchor" name="g1dfddaa8f7d9aad32b00248c7dc782d2"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_RANK" ref="g1dfddaa8f7d9aad32b00248c7dc782d2" args="(rank)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_RANK </td>
<td>(</td>
<td class="paramtype">rank&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ( (rank) &lt; 0 || (rank) &gt;= <a class="code" href="../../dd/df8/group__internal__core.html#geed5a271d50368d3cf9a858c4f57c895" title="Information each node knowns about himself and the world.">node_handle</a>.<a class="code" href="../../d8/d93/structmoc__node__handle__ppu__struct.html#3779cc1bda02c45a880389b109173778" title="number of overall processes">comm_size</a> ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#g88202a7ec7634ce5634b0ead0368c802" title="Invalid rank.">MOC_ERR_RANK</a>; }
</pre></div>Tests if invalid rank.
<p>
Calls return with appropriate error-code itself.
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00095">95</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d2/db6/moc__bsend__ppu_8c-source.html#l00010">MOC_Bsend()</a>, <a class="el" href="../../dd/d90/moc__dma-get__ppu_8c-source.html#l00009">MOC_Get_data()</a>, <a class="el" href="../../d8/da3/moc__dma-iget__ppu_8c-source.html#l00011">MOC_IGet_data()</a>, <a class="el" href="../../dd/dd5/moc__dma-iput__ppu_8c-source.html#l00011">MOC_IPut_data()</a>, <a class="el" href="../../df/df8/moc__issend__ppu_8c-source.html#l00010">MOC_ISsend()</a>, <a class="el" href="../../da/d4a/moc__dma-put__ppu_8c-source.html#l00009">MOC_Put_data()</a>, and <a class="el" href="../../d4/db6/moc__ssend__ppu_8c-source.html#l00010">MOC_Ssend()</a>.</p>
</div>
</div><p>
<a class="anchor" name="g796b45379e44e6ad2d1895ac56d80d3c"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_RANK_RECV" ref="g796b45379e44e6ad2d1895ac56d80d3c" args="(rank)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_RANK_RECV </td>
<td>(</td>
<td class="paramtype">rank&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ( rank != <a class="code" href="../../d1/d82/moc_8h.html#deff0c57411502be14ddf5fef3aa6e99" title="Indicates, in a receive, to accept a message from any source.">MOC_ANY_SOURCE</a> &amp;&amp; ((rank) &lt; 0 || (rank) &gt;= <a class="code" href="../../dd/df8/group__internal__core.html#geed5a271d50368d3cf9a858c4f57c895" title="Information each node knowns about himself and the world.">node_handle</a>.<a class="code" href="../../d8/d93/structmoc__node__handle__ppu__struct.html#3779cc1bda02c45a880389b109173778" title="number of overall processes">comm_size</a>) ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#g88202a7ec7634ce5634b0ead0368c802" title="Invalid rank.">MOC_ERR_RANK</a>; }
</pre></div>Tests if invalid rank in a recv-operation.
<p>
Calls return with appropriate error-code itself.
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00102">102</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d8/dbc/moc__recv__ppu_8c-source.html#l00011">MOC_Recv()</a>.</p>
</div>
</div><p>
<a class="anchor" name="ge0070a22959ddde28816cc5676687b1d"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_TAG_RECV" ref="ge0070a22959ddde28816cc5676687b1d" args="(tag)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_TAG_RECV </td>
<td>(</td>
<td class="paramtype">tag&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ( (tag)!=<a class="code" href="../../d1/d82/moc_8h.html#a6d9dac1d01f8d03aa144056921e04dd" title="Indicates, in a receive, to accept a message with any tag value.">MOC_ANY_TAG</a> &amp;&amp; ((tag) &gt; 255 || (tag) &lt; 0) ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#g4dda6446879941989962c0fbdf4ba0e5" title="Invalid tag argument.">MOC_ERR_TAG</a>; }
</pre></div>Tests if invalid tag in a recv-operation.
<p>
Calls return with appropriate error-code itself.
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00088">88</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d8/dbc/moc__recv__ppu_8c-source.html#l00011">MOC_Recv()</a>.</p>
</div>
</div><p>
<a class="anchor" name="g49637a9f588e1c44584d8def5c45e811"></a><!-- doxytag: member="imoc_macros.h::IMOC_TEST_TAG_SEND" ref="g49637a9f588e1c44584d8def5c45e811" args="(tag)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define IMOC_TEST_TAG_SEND </td>
<td>(</td>
<td class="paramtype">tag&nbsp;</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">if</span> ( (tag) &gt; 255 || (tag) &lt; 0 ) \
{ <span class="keywordflow">return</span> <a class="code" href="../../d8/da1/group__environment__error.html#g4dda6446879941989962c0fbdf4ba0e5" title="Invalid tag argument.">MOC_ERR_TAG</a>; }
</pre></div>Tests if invalid tag in a send-operation.
<p>
Calls return with appropriate error-code itself.
<p>Definition at line <a class="el" href="../../d0/d87/imoc__macros_8h-source.html#l00081">81</a> of file <a class="el" href="../../d0/d87/imoc__macros_8h-source.html">imoc_macros.h</a>.</p>
<p>Referenced by <a class="el" href="../../d2/db6/moc__bsend__ppu_8c-source.html#l00010">MOC_Bsend()</a>, <a class="el" href="../../df/df8/moc__issend__ppu_8c-source.html#l00010">MOC_ISsend()</a>, and <a class="el" href="../../d4/db6/moc__ssend__ppu_8c-source.html#l00010">MOC_Ssend()</a>.</p>
</div>
</div><p>
</div>
<hr size="1"><address style="text-align: right;"><small>Generated on Thu Feb 12 13:51:04 2009 for MPI On Cell (Documentation) by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="../../doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
</body>
</html>