<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/2882/">https://reviewboard.asterisk.org/r/2882/</a>
     </td>
    </tr>
   </table>
   <br />



<table bgcolor="#e0e0e0" width="100%" cellpadding="8" style="border: 1px gray solid;">
 <tr>
  <td>
   <h1 style="margin-right: 0.2em; padding: 0; font-size: 10pt;">This change has been discarded.</h1>
  </td>
 </tr>
</table>
<br />


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

<div>Review request for Asterisk Developers, David Lee and Joshua Colp.</div>
<div>By Mark Michelson.</div>


<p style="color: grey;"><i>Updated Nov. 14, 2013, 5:18 p.m.</i></p>









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


<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;">When initial performance testing was done, threadpool usage in stasis appeared to be a big offender, so I set out to simplify threadpools as much as possible.

Here is a listing of the simplifications:

* threadpool listeners have been removed.
* ast_threadpool_set_size() has been removed (and thus there are no longer "zombie" threads)
* There are no longer separate ao2_containers for threads. They are instead kept in a single list, and counters are used to determine how many of any given type there are.
* Pools make use of a semaphore for signaling idle threads to awaken, rather than a boolean, lock, and ast_cond_t per-worker.
* worker thread structures have been simplified. In addition to what has been mentioned, they also no longer have an id, or any state information stored on them.

Because of the removal of threadpool listeners, the unit tests had to be pared down some. They no longer could test the actual threadpool mechanics so much as the API provided by the threadpool. Thus, many tests have been removed, and other tests have been altered to not require a threadpool listener. There are no tests for certain threadpool options such as idle timeout right now since it is not really possible to test that a thread has actually been removed due to idleness.

In addition to the simplifications that have been made, there has also been a modification to threadpool's initial_size option. In addition to being the initial size of the threadpool on creation, it now also serves as a minimum size. Workers that are allocated when the threapdool is created will have no idle timeout, despite how the threadpool may be configured.

These changes seem to have mixed effects when it comes to performance. With a reasonable number of threads (say, number of CPU cores * 2) in the threadpool, these changes introduce a positive change to performance. With a ridiculous number of threads in the threadpool (say 200), this either has no effect or has a slight degradation to performance. Judicious maximum threadpool sizes will result in a net positive effect from these changes. Plus, this removes a *lot* of code that really was just not necessary.</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;">The unit tests all pass.

I ran stock Asterisk 12 with these changes and ensured that the threadpool used by stasis there did not encounter any difficulties.
I also ran a call test with chan_pjsip in the performance branch to ensure that its usage of the threadpool did not cause issues.</pre>
  </td>
 </tr>
</table>


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

 <li>/team/group/performance/include/asterisk/threadpool.h <span style="color: grey">(399869)</span></li>

 <li>/team/group/performance/main/sorcery.c <span style="color: grey">(399869)</span></li>

 <li>/team/group/performance/main/threadpool.c <span style="color: grey">(399869)</span></li>

 <li>/team/group/performance/res/res_pjsip.c <span style="color: grey">(399869)</span></li>

 <li>/team/group/performance/tests/test_threadpool.c <span style="color: grey">(399869)</span></li>

</ul>

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







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




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