From: scipio <scipio>
Date: Wed, 21 Mar 2007 06:47:18 +0000 (+0000)
Subject: Include cancel
X-Git-Tag: tinyos/2.0.1~124
X-Git-Url: https://oss.titaniummirror.com/gitweb/?a=commitdiff_plain;h=ce057d5bf173b7bbb150f1cfaf4282bcd9b7e2fd;p=tinyos-2.x.git

Include cancel
---

diff --git a/doc/html/tep116.html b/doc/html/tep116.html
index 16f0612f..c53fe9e6 100644
--- a/doc/html/tep116.html
+++ b/doc/html/tep116.html
@@ -303,7 +303,7 @@ ul.auto-toc {
 <td>Philip Levis</td></tr>
 <tr class="field"><th class="docinfo-name">Draft-Created:</th><td class="field-body">10-Dec-2004</td>
 </tr>
-<tr class="field"><th class="docinfo-name">Draft-Version:</th><td class="field-body">1.7</td>
+<tr class="field"><th class="docinfo-name">Draft-Version:</th><td class="field-body">1.8</td>
 </tr>
 <tr class="field"><th class="docinfo-name">Draft-Modified:</th><td class="field-body">2007-03-14</td>
 </tr>
@@ -571,6 +571,13 @@ if (call Send.send(...) == SUCCESS &amp;&amp;
 use a QueueC (found in tos/system) to store pending packet pointers
 and serialize them onto sending interface, or they can introduce
 a new sending interface that supports multiple pending transmissions.</p>
+<p>The cancel command allows a sender to cancel the current transmission.
+A call to cancel when there is no pending sendDone event MUST return FAIL.
+If there is a pending sendDone event and the cancel returns SUCCESS, then
+the packet layer MUST NOT transmit the packet and MUST signal sendDone
+with ECANCEL as its error code. If there is a pending sendDone event
+and cancel returns FAIL, then sendDone SHOULD occur as if the cancel
+was not called.</p>
 </div>
 <div class="section">
 <h2><a id="receive-interface" name="receive-interface">2.3 Receive interface</a></h2>
diff --git a/doc/txt/tep116.txt b/doc/txt/tep116.txt
index b5dcf1b2..ee6b25dc 100644
--- a/doc/txt/tep116.txt
+++ b/doc/txt/tep116.txt
@@ -296,6 +296,14 @@ use a QueueC (found in tos/system) to store pending packet pointers
 and serialize them onto sending interface, or they can introduce
 a new sending interface that supports multiple pending transmissions.
 
+The cancel command allows a sender to cancel the current transmission.
+A call to cancel when there is no pending sendDone event MUST return FAIL.
+If there is a pending sendDone event and the cancel returns SUCCESS, then
+the packet layer MUST NOT transmit the packet and MUST signal sendDone
+with ECANCEL as its error code. If there is a pending sendDone event
+and cancel returns FAIL, then sendDone SHOULD occur as if the cancel
+was not called. 
+
 2.3 Receive interface
 --------------------------------------------------------------------