<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/1822/">https://reviewboard.asterisk.org/r/1822/</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 opticron.</div>


<p style="color: grey;"><i>Updated March 24, 2012, 7:07 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;">Incorporate Tilghman&#39;s suggestion to allow for a variable cause code description length.</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;">Add PVT_CAUSE as a drop-in replacement for SIP_CAUSE that does not incur the overhead of the MASTER_CHANNEL dialplan function.  This feature uses control frames to pass the data and creates a mechanism by which any channel driver can report cause information.  This implementation includes only SIP, but implementations for other channel drivers will be available in the next month.</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;">Verified that this functions identically to SIP_CAUSE in single-channel dials, forked dials, and forked dials behind a local dial.

Sample dialplan:
[foo]
exten =&gt; s,1,Dial(SIP/bar)
 
exten =&gt; h,1,noop()
exten =&gt; h,n,set(PVT_CAUSE_STRING=${HASHKEYS(PVT_CAUSE)})
; start loop
exten =&gt; h,n(pvt_begin),noop()
 
; check exit condition (no more array to check)
exten =&gt; h,n,gotoif($[${LEN(${PVT_CAUSE_STRING})} = 0]?pvt_exit)
 
; pull the next item
exten =&gt; h,n,set(ARRAY(item)=${PVT_CAUSE_STRING})
exten =&gt; h,n,set(PVT_CAUSE_STRING=${PVT_CAUSE_STRING:${LEN(${item})}})
 
; display the channel ID and cause code
exten =&gt; h,n,noop(got channel ID ${item} with pvt cause ${HASH(PVT_CAUSE,${item})})
 
; check exit condition (no more array to check)
exten =&gt; h,n,gotoif($[${LEN(${PVT_CAUSE_STRING})} = 0]?pvt_exit)
 
; we still have entries to process, so strip the leading comma
exten =&gt; h,n,set(PVT_CAUSE_STRING=${PVT_CAUSE_STRING:1})
; go back to the beginning of the loop
exten =&gt; h,n,goto(pvt_begin)
exten =&gt; h,n(pvt_exit),noop(All PVT_CAUSE entries processed)</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/SWP-4221">SWP-4221</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>trunk/CHANGES <span style="color: grey">(360259)</span></li>

 <li>trunk/UPGRADE.txt <span style="color: grey">(360259)</span></li>

 <li>trunk/apps/app_dial.c <span style="color: grey">(360259)</span></li>

 <li>trunk/apps/app_followme.c <span style="color: grey">(360259)</span></li>

 <li>trunk/apps/app_queue.c <span style="color: grey">(360259)</span></li>

 <li>trunk/channels/chan_sip.c <span style="color: grey">(360259)</span></li>

 <li>trunk/funcs/func_frame_trace.c <span style="color: grey">(360259)</span></li>

 <li>trunk/include/asterisk/frame.h <span style="color: grey">(360259)</span></li>

 <li>trunk/main/channel.c <span style="color: grey">(360259)</span></li>

 <li>trunk/main/dial.c <span style="color: grey">(360259)</span></li>

 <li>trunk/main/features.c <span style="color: grey">(360259)</span></li>

 <li>trunk/main/file.c <span style="color: grey">(360259)</span></li>

 <li>trunk/main/rtp_engine.c <span style="color: grey">(360259)</span></li>

</ul>

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




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




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