<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2171/18/9/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Projects">Asterisk 11 Projects</a></h2>
<h4>Page <b>edited</b> by <a href="https://wiki.asterisk.org/wiki/display/~kmoore">Kinsey Moore</a>
</h4>
<div id="versionComment">
<b>Comment:</b>
add comments to indicate the completion of the app_macro task and updates to who hung up<br />
</div>
<br/>
<h4>Changes (5)</h4>
<div id="page-diffs">
<table class="diff" cellpadding="0" cellspacing="0">
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" > <br>* A generic layer that converts the cause codes between specific channel drivers <br></td></tr>
<tr><td class="diff-changed-lines" >* Modification of ast_frame to contain sufficient information for each of the consumers of the event <span class="diff-added-words"style="background-color: #dfd;">(complete, awaiting review)</span> <br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">* Tests to exercise this feature for each channel driver (chan_sip test complete, reviewed) <br>* Test to exercise this feature as a replacement backend for SIP_CAUSE (complete, reviewed) <br></td></tr>
<tr><td class="diff-unchanged" > <br></td></tr>
<tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Note that CEL events already provide some of this information. <br> <br>Both Kobaz and Olle have worked on this feature and may have code in branches that would act as a good starting point. <br> <br></td></tr>
<tr><td class="diff-unchanged" >h1. Named ACLs <br> <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >* Channel Redirecting <br> <br></td></tr>
<tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Kinsey has already done the work on this project, including tests for the Asterisk Test Suite. <br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">This work is now complete, including external tests for both macro-based and gosub-based usage of these facilities. More information is available on the [app_macro Deprecation] subpage. <br></td></tr>
<tr><td class="diff-unchanged" > <br>h1. Coverity Report Fixing <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
</table>
</div> <h4>Full Content</h4>
<div class="notificationGreySide">
<h1><a name="Asterisk11Projects-Overview"></a>Overview</h1>
<p>The following is a listing of projects Digium has committed developer resources to for Asterisk 11. The majority of these were derived from the notes taken from <a href="https://wiki.asterisk.org/wiki/display/AST/AstriDevCon+2011" class="external-link" rel="nofollow">AstriDevCon 2011</a>, held on Monday, October 24th, 2011. The choice of the projects listed on this page was based on the following:</p>
<ul>
<li>The agreement in the community that Asterisk 11 is to be an LTS release (see <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions" class="external-link" rel="nofollow">Asterisk Versions</a>).</li>
<li>That, since Asterisk 11 is an LTS release, no major new features that introduce a significant risk should be included. Items that introduce a large amount of risk should instead be deferred for Asterisk 12.</li>
<li>Priority should be given to those features that either significantly assist the users/developers of Asterisk without much risk, or those that improve the reliability of the product.</li>
</ul>
<p>Some of these criteria are obviously subjective, but they were used as guidelines when determining whether or not a proposed change is appropriate for Asterisk 11. These guidelines should be kept in mind when any new projects are proposed and considered for inclusion in Asterisk 11.</p>
<p>The following subsections provide a brief description of each of the projects. As time progresses, sub-pages will be added to this page that expand upon these descriptions.</p>
<p>If you'd like to assist with any of these projects, please feel free to notify the development community in #asterisk-dev or on the development mailing list.</p>
<div>
<ul>
<li><a href='#Asterisk11Projects-Overview'>Overview</a></li>
<li><a href='#Asterisk11Projects-SIPPathSupport'>SIP Path Support</a></li>
<li><a href='#Asterisk11Projects-PreDialandHangupHandlers'>Pre-Dial and Hangup Handlers</a></li>
<li><a href='#Asterisk11Projects-Documentationimprovements'>Documentation improvements</a></li>
<li><a href='#Asterisk11Projects-OpenSSLinitialization'>OpenSSL initialization</a></li>
<li><a href='#Asterisk11Projects-Opaquificationofastchannel'>Opaquification of ast_channel</a></li>
<li><a href='#Asterisk11Projects-Whohungup'>Who hung up</a></li>
<li><a href='#Asterisk11Projects-NamedACLs'>Named ACLs</a></li>
<li><a href='#Asterisk11Projects-LightweightNAT'>Lightweight NAT</a></li>
<li><a href='#Asterisk11Projects-IPv6foreverything'>IPv6 for everything</a></li>
<li><a href='#Asterisk11Projects-apppagerefactor'>app_page refactor</a></li>
<li><a href='#Asterisk11Projects-Uniqueidentifierforfilteringlogdataforacall'>Unique identifier for filtering log data for a call</a></li>
<li><a href='#Asterisk11Projects-BridgingThreadPool%2FAPIusageexpansion'>Bridging Thread Pool / API usage expansion</a></li>
<li><a href='#Asterisk11Projects-Completeappmacrodeprecation'>Complete app_macro deprecation</a></li>
<li><a href='#Asterisk11Projects-CoverityReportFixing'>Coverity Report Fixing</a></li>
<li><a href='#Asterisk11Projects-SIPTesting'>SIP Testing</a></li>
<li><a href='#Asterisk11Projects-ConfigurationManagement'>Configuration Management</a></li>
<li><a href='#Asterisk11Projects-LeveragingofMediaFormatArchitecture'>Leveraging of Media Format Architecture</a></li>
</ul></div>
<h1><a name="Asterisk11Projects-SIPPathSupport"></a>SIP Path Support</h1>
<p>This project implements RFC 3327 - Path Extension Header Field for SIP in Asterisk. This allows discovery for intermediate proxies during SIP registration and in subsequent requests. A patch (against 1.8) by Klaus Darilion (with assistance from Olle) currently exists at <a href="https://reviewboard.asterisk.org/r/991/" class="external-link" rel="nofollow">https://reviewboard.asterisk.org/r/991/</a>, and may be used as a starting point for this work. If this patch is used as a basis for this project, it will need to be brought up to the current state of Asterisk.</p>
<p>Note that RFC 3327 recommends that the registrar support S/MIME, and attach a signed S/MIME of the response, which Asterisk does not currently support. This project does not include the work that would be necessary to make Asterisk support S/MIME.</p>
<h1><a name="Asterisk11Projects-PreDialandHangupHandlers"></a>Pre-Dial and Hangup Handlers</h1>
<p>Pre-dial allows you to jump to the dialplan after a channel has been created but before the actual dialing takes place. Similarly, hangup handlers let you attach a dialplan extension that is called when a channel is hung up. While similar to the 'h' extension, this is not global to a context or tied to a particular context, but rather follows the lifetime of a particular channel.</p>
<p>Both of these are currently being developed by Kobaz:</p>
<p>Pre-dial review:<a href="https://reviewboard.asterisk.org/r/1229" class="external-link" rel="nofollow">https://reviewboard.asterisk.org/r/1229</a><br/>
Hangup handlers review: <a href="https://reviewboard.asterisk.org/r/1230" class="external-link" rel="nofollow">https://reviewboard.asterisk.org/r/1230</a></p>
<p><a href="/wiki/display/AST/Pre-dial+handlers" title="Pre-dial handlers">Pre-dial handlers</a></p>
<h1><a name="Asterisk11Projects-Documentationimprovements"></a>Documentation improvements</h1>
<p>This project covers a number of improvements to the documentation that is extracted from the Asterisk source:</p>
<ul>
<li>AMI events - this includes some subset of the current AMI events. What is documented includes not only attributes of the event, but also the scenarios in which they are raised.</li>
<li>Technology specific information - currently, there is no way to document information that pertains to a particular technology, but exists outside of that technology specific module. For example, the MessageSend application has technology specific behaviour that is determined in res_jingle and chan_sip, but should be documented with the res_jingle/chan_sip specific documentation. New tags are provided that allow for documentation to be written with the module that defines that behaviour (for example, in res_jingle) - but referenced by the application that uses it and displayed with that application, e.g., in MessageSend.</li>
<li>Config file schemas - up until now, the config files were not a recommended configuration so much as a source of configuration documentation. In Asterisk 11, the configuration schema for each configuration file is instead defined in the source files that use that configuration information, including valid values for a configuration item, required items, optional, etc.</li>
</ul>
<p>Note that with the AMI events documented - or at least a subset thereof - a full specification for AMI will be defined and released. This entails treating the documented events/actions as a new version of AMI.</p>
<h1><a name="Asterisk11Projects-OpenSSLinitialization"></a>OpenSSL initialization</h1>
<p>During the devcon after AstriCon 2010, we got a report that using PostgreSQL from within Asterisk, when the PostgreSQL connections are configured to use SSL/TLS to connect to the database server, can cause random crashes and other bizarre behavior. The reporter said this was known to be an issue with some other packages as well (notably Kamailio), and had to do with both Asterisk and the PostgreSQL libraries assuming they "owned" the OpenSSL libraries in the process' memory space, and thus calling initialization code twice (or worse).</p>
<p>The fix for this problem uses dynamic linker functionality to <b>wrap</b> the real OpenSSL initialization functions (and some other dangerous ones) with versions that don't actually do anything, and then calls the real ones only <b>one</b> time during Asterisk startup. To make this work, the SSL functionality that is normally built into the main Asterisk binary now must be built into a dynamic library (libasteriskssl.so), which is installed into the standard dynamic library location on the system (this is <b>not</b> an Asterisk loadable module, just a regular dynamic library).</p>
<p>As part of this, the usage of ASTLIBDIR throughout the build system to refer to the directory where Asterisk loadable modules are installed was changed to ASTMODDIR (which matches how it is referred to in the source code and in asterisk.conf), and a new definition of ASTLIBDIR was created to point to the system's dynamic library directory.</p>
<p>Note that this patch has already been reviewed and committed to the subversion trunk.</p>
<h1><a name="Asterisk11Projects-Opaquificationofastchannel"></a>Opaquification of ast_channel</h1>
<p>Making the ast_channel an opaque object has several large benefits regarding the maintenance of Asterisk:</p>
<ol>
<li>It greatly simplifies complex operations on the channel, e.g., masquerades</li>
<li>It reduces the complexity in other portions of the code by requiring users of the channel to have a handle to the channel, as opposed to a reference (such as sip_pvt)</li>
</ol>
<p>This is a two-part process. For Asterisk 11, the syntax of the ast_channel is being changed to be opaque, while the semantics are being left alone. This minimizes the risk of negatively impacting chan_sip and other users of the ast_channel object. Changing the semantics of ast_channel will be done in Asterisk 12, which will leverage the work of Asterisk 11 to make the maintenance improvements.</p>
<h1><a name="Asterisk11Projects-Whohungup"></a>Who hung up</h1>
<p>"Who hung up" gives Asterisk, on a failed call, the capability to provide access to the information surrounding the hang up to entities that care about such information. This includes the device that hung up, as well as the technology specific cause codes.</p>
<p>This includes, at a minimum, the following:</p>
<ul>
<li>A generic layer that converts the cause codes between specific channel drivers</li>
<li>Modification of ast_frame to contain sufficient information for each of the consumers of the event (complete, awaiting review)</li>
<li>Tests to exercise this feature for each channel driver (chan_sip test complete, reviewed)</li>
<li>Test to exercise this feature as a replacement backend for SIP_CAUSE (complete, reviewed)</li>
</ul>
<h1><a name="Asterisk11Projects-NamedACLs"></a>Named ACLs</h1>
<p>Named ACLs expand upon Asterisk's current ACL functionality. This may have a starting point using a branch of Olle's, although it would have to be brought up to the current state of Asterisk.</p>
<h1><a name="Asterisk11Projects-LightweightNAT"></a>Lightweight NAT</h1>
<p>Lightweight NAT gives Asterisk a lightweight means of holding a NAT open in SIP (outbound only). This is similar to the qualify options in chan_sip, but consists of an empty UDP message that Asterisk would not expect a response for.</p>
<p>Note that Josh has already performed the work for this project, including tests for the Asterisk Test Suite.</p>
<h1><a name="Asterisk11Projects-IPv6foreverything"></a>IPv6 for everything</h1>
<p>IPv6 support already exists in some modules in Asterisk. This expands on that, making all modules in Asterisk that use IP-based communication IPv6 compatible. This includes all channel drivers, manager, http, database drivers, FastAGI, etc.</p>
<p>Sean Bright has already made progress on this for FastAGI.</p>
<h1><a name="Asterisk11Projects-apppagerefactor"></a>app_page refactor</h1>
<p>Page (app_page) no longer depends upon MeetMe (including using DAHDI as a timing source). Instead, app_page now uses the bridging layer in Asterisk. This is similar to the work that was done for ConfBridge for Asterisk 10, although much more limited in scope (as app_page is a much smaller application).</p>
<h1><a name="Asterisk11Projects-Uniqueidentifierforfilteringlogdataforacall"></a>Unique identifier for filtering log data for a call</h1>
<p>Each call now has a unique identifier associated with it. This unique identifier is associated with every log statement associated with a call. This allows people viewing a lot to easily associate all statements that relate to a particular call, even when other log statements from other calls are interleaved with those they care about.</p>
<p>From an implementation standpoint, there are a number of technical challenges that need to be addressed for this project:</p>
<ol>
<li>How do we handle logging statements that are occurring because a call is about to happen, but before an ast_channel object has been allocated? (The same could be said of those things that occur because of a call, but occur after an ast_channel has been torn down)</li>
<li>Locking semantics may be difficult to surmount without negatively impacting performance</li>
<li>How do we pass around a channel identifier through the various layers of Asterisk without over-complicating the various APIs?</li>
</ol>
<p>Some initial work was done on this during a Google Summer of Code by Clod (JunK-Y) and may be used as a starting point for this work.</p>
<p><a href="/wiki/display/AST/Unique+Call-ID+Logging" title="Unique Call-ID Logging">Unique Call-ID Logging</a></p>
<h1><a name="Asterisk11Projects-BridgingThreadPool%2FAPIusageexpansion"></a>Bridging Thread Pool / API usage expansion</h1>
<p>When multiple channels are bridged, very often the allocated bridge channel threads do very little work. This project gives Asterisk the capability to provide a thread pool that services multiple bridges, reducing the number of necessary context switches.</p>
<p>At the same time, many things in Asterisk continue to use the standard 2-party calls (ast_bridge). These are migrated to use the bridging API instead. This would include making ast_bridge_call use the bridging API underneath.</p>
<h1><a name="Asterisk11Projects-Completeappmacrodeprecation"></a>Complete app_macro deprecation</h1>
<p>This project updates modules that require app_macro to instead prefer app_stack. Applications can continue to support the usage of app_macro for at least Asterisk 11, but everything that can use app_macro has an option for app_gosub instead. This is similar to what was already done for both app_dial and app_queue.</p>
<p>Candidates for this :</p>
<ul>
<li>CCSS</li>
<li>Connected Line</li>
<li>Channel Redirecting</li>
</ul>
<p>This work is now complete, including external tests for both macro-based and gosub-based usage of these facilities. More information is available on the <a href="/wiki/display/AST/app_macro+Deprecation" title="app_macro Deprecation">app_macro Deprecation</a> subpage.</p>
<h1><a name="Asterisk11Projects-CoverityReportFixing"></a>Coverity Report Fixing</h1>
<p>A Coverity static analysis report was generated for Asterisk some time ago. This project entails performing a deep analysis of the results, turning the findings into JIRA issues, and resolving those findings. There are about a dozen "categories" of issues whose fixing would improve the stability of core Asterisk, and most of the findings in each category can be fixed at the same time.</p>
<h1><a name="Asterisk11Projects-SIPTesting"></a>SIP Testing</h1>
<p>In order to improve the stability and maintainability of Asterisk's chan_sip, the Asterisk Test Suite has a new set of SIP tests that expand upon its current capabilities. This includes both nominal tests for a variety of scenarios, as well as some off-nominal scenarios, which will be emulated using SIPp and/or pjsua.</p>
<h1><a name="Asterisk11Projects-ConfigurationManagement"></a>Configuration Management</h1>
<p>Asterisk modules each load their own configuration files. While the configuration objects (ast_config, ast_variable, etc.) abstract away the actual reading of the config files/access of the realtime backends, each module still validates and applies the key/value pairs to its own configuration variables. Unfortunately, this is rarely done in a thread-safe manner, and is not done in a consistent manner across modules.</p>
<p>As there are a large number of configuration files in Asterisk, this task focuses on specifying the correct way to store configuration values such that it is consistent across modules and thread-safe.</p>
<h1><a name="Asterisk11Projects-LeveragingofMediaFormatArchitecture"></a>Leveraging of Media Format Architecture</h1>
<p>The new media architecture in Asterisk 10 <a href="https://wiki.asterisk.org/wiki/display/AST/Media+Overhaul" class="external-link" rel="nofollow">https://wiki.asterisk.org/wiki/display/AST/Media+Overhaul</a> was utilized to an extent by introducing some wide-band audio codecs and translations <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Codecs+and+Audio+Formats" class="external-link" rel="nofollow">https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Codecs+and+Audio+Formats</a>. Currently, attributes are supported by the following codecs:</p>
<ul>
<li>SILK (res_format_attr_silk)</li>
<li>CELT (res_format_attr_celt)</li>
</ul>
<p>Attributes have not been applied for other formats, such as h264. SDP negotiation in chan_sip also does not take into account the format attributes. Additionally, with the current architecture, each codec's specific attributes must be referenced by the entity performing the negotiation. While there may not be any other way to do this, it does imply that chan_sip must have specific domain knowledge of each codec that it supports. (For example, to set the sampling rate of SILK would require it to set the SILK_ATTR_KEY_SAMP_RATE key, while setting the sampling rate of CELT would require it to set the CELT_ATTR_KEY_SAMP_RATE key).</p>
<p>This project continues to leverage the Media Format Architecture in chan_sip, with potential room for growth in other channel drivers (if the maintainers of those channel drivers would like to participate). This includes modifications to the architecture to make it easy for channel drivers to provide attributes to the format modules.</p>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;" class="grey">
<a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
<span style="padding: 0px 5px;">|</span>
<a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Projects">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/pages/diffpagesbyversion.action?pageId=19008034&revisedVersion=8&originalVersion=7">View Changes</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Projects?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>