<html>
 <body>
  <div style="font-family: Verdana, Arial, Helvetica, Sans-Serif;">
   <table bgcolor="#f9f3c9" width="100%" cellpadding="8" style="border: 1px #c9c399 solid;">
    <tr>
     <td>
      This is an automatically generated e-mail. To reply, visit:
      <a href="https://reviewboard.asterisk.org/r/2135/">https://reviewboard.asterisk.org/r/2135/</a>
     </td>
    </tr>
   </table>
   <br />


<table bgcolor="#fefadf" width="100%" cellspacing="0" cellpadding="8" style="background-image: url('https://reviewboard.asterisk.org/media/rb/images/review_request_box_top_bg.png'); background-position: left top; background-repeat: repeat-x; border: 1px black solid;">
 <tr>
  <td>

<div>Review request for Asterisk Developers.</div>
<div>By Mark Michelson.</div>


<p style="color: grey;"><i>Updated Oct. 16, 2012, 5:17 p.m.</i></p>



<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Changes</h1>
<table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" style="border: 1px solid #b8b5a0">
 <tr>
  <td>
   <pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;">Addressed Richard&#39;s feedback.</pre>
  </td>
 </tr>
</table>


<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Description </h1>
<table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" style="border: 1px solid #b8b5a0">
 <tr>
  <td>
   <pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;">This is an interesting one. I filed issue ASTERISK-20375 a while back and David Lee fixed it. The problem was that in my setup, a call to ast_waitfor_nandfds() returned in less than a millisecond. The result was that the input-output value passed into ast_waitfor_nandfds() would never decrement the value properly. Thus a 3000 ms timeout would take *days* to actually time out.

David discovered that a similar pattern for determining the passage of time had been used throughout the code. This patch is an attempt to fix all of those. I&#39;ve created a function in time.h called ast_remaining_ms() that will tell the amount of time remaining given a starting timestamp and the duration that the original timeout was. This is useful for determining the timeout to pass to an ast_waitfor() or related function.

Most of the changes here were straightforward, but there were some tricky bits. Focus strongly on the following changes:

1) wait_for_answer() in app_dial.c
2) wait_for_answer() in app_queue.c
3) generic_fax_exec() in res_fax.c
4) places where I have started setting &quot;res&quot; instead of &quot;ms&quot; or something similar in ast_waitfor() calls. Ensure that I have not tainted a return value. I found a few of these places while testing and fixed what I found on my own, but I could have missed some places.
5) places where a timeout is supposed to restart. I&#39;ve tried to find these places, but I may have missed some.

In addition, there has been a change made to the return of ast_waitfor(). Prior to this patch, if a negative timeout were passed to ast_waitfor(), it would be impossible to return a negative value. This meant that it was impossible to detect if an error had occurred. I&#39;ve changed ast_waitfor() to be able to return a negative value if a negative timeout is passed in, but only if the underlying call to ast_waitfor_nandfds() returns NULL.

I did this because I found many places in the code with this construct:

if (ast_waitfor(chan, -1) &lt; 0) {
    ast_log(LOG_ERROR, &quot;ERMAHGERD!\n&quot;);
    return HORRIBLE_ERROR_CONDITION;
}

The problem is that the error return could never actually be reached. It should be possible with my change. Please let me know if my change could cause problems though.</pre>
  </td>
 </tr>
</table>


<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Testing </h1>
<table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" style="border: 1px solid #b8b5a0">
 <tr>
  <td>
   <pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;">I&#39;ve placed many test calls through items that used timeouts like Dial and Queue with a timeout. I&#39;ve also ensured that other apps that use ast_waitfor() such as Answer() and Echo() still function properly.</pre>
  </td>
 </tr>
</table>



<div style="margin-top: 1.5em;">
 <b style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Bugs: </b>


 <a href="https://issues.asterisk.org/jira/browse/ASTERISK-20414">ASTERISK-20414</a>


</div>


<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Diffs</b> (updated)</h1>
<ul style="margin-left: 3em; padding-left: 0;">

 <li>/branches/1.8/apps/app_dial.c <span style="color: grey">(375025)</span></li>

 <li>/branches/1.8/apps/app_jack.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/apps/app_meetme.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/apps/app_queue.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/apps/app_record.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/apps/app_waitforring.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/channels/chan_agent.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/channels/chan_dahdi.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/channels/chan_iax2.c <span style="color: grey">(375025)</span></li>

 <li>/branches/1.8/channels/sig_analog.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/channels/sig_pri.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/include/asterisk/channel.h <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/include/asterisk/time.h <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/main/channel.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/main/pbx.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/main/rtp_engine.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/main/utils.c <span style="color: grey">(374904)</span></li>

 <li>/branches/1.8/res/res_fax.c <span style="color: grey">(374904)</span></li>

</ul>

<p><a href="https://reviewboard.asterisk.org/r/2135/diff/" style="margin-left: 3em;">View Diff</a></p>




  </td>
 </tr>
</table>




  </div>
 </body>
</html>