Review Board 1.7.16


Add support in AEL for macro return values and direct assignment of them to variables and functions.

Review Request #114 - Created Dec. 30, 2008 and updated

Marquis
/trunk
14629
Reviewers
asterisk-dev
Asterisk
Add support in AEL for macro return values and direct assignment of them to variables and functions.
Ran the AEL regression tests in pbx/ael/ael-test.  Also adapted much of my dialplan (used in general PBXs all over the world) to use the new assignment.
/trunk/CHANGES
Revision 166832 New Change
1
======================================================================
1
======================================================================
2
===
2
===
3
=== This file documents the new and/or enhanced functionality added in
3
=== This file documents the new and/or enhanced functionality added in
4
=== the Asterisk versions listed below. This file does NOT include
4
=== the Asterisk versions listed below. This file does NOT include
5
=== changes in behavior that would not be backwards compatible with
5
=== changes in behavior that would not be backwards compatible with
6
=== previous versions; for that information see the UPGRADE.txt file
6
=== previous versions; for that information see the UPGRADE.txt file
7
=== and the other UPGRADE files for older releases.
7
=== and the other UPGRADE files for older releases.
8
===
8
===
9
======================================================================
9
======================================================================
10

    
   
10

   
11
------------------------------------------------------------------------------
11
------------------------------------------------------------------------------
12
--- Functionality changes from Asterisk 1.6.1 to Asterisk 1.6.2  -------------
12
--- Functionality changes from Asterisk 1.6.1 to Asterisk 1.6.2  -------------
13
------------------------------------------------------------------------------
13
------------------------------------------------------------------------------
14

    
   
14

   
15
SIP Changes
15
SIP Changes
16
-----------
16
-----------
17
 * Added support for SUBSCRIBE/NOTIFY with dialog-info based call pickups.
17
 * Added support for SUBSCRIBE/NOTIFY with dialog-info based call pickups.
18
   Snom phones use this for call pickup of extensions that the phone is
18
   Snom phones use this for call pickup of extensions that the phone is
19
   subscribed to.
19
   subscribed to.
20
 * Added support for subscribing to a voice mailbox on a remote server and
20
 * Added support for subscribing to a voice mailbox on a remote server and
21
   making the new/old message count available to local devices.
21
   making the new/old message count available to local devices.
22
 * Added support for setting the domain in the URI for caller of an
22
 * Added support for setting the domain in the URI for caller of an
23
   outbound call by using the SIPFROMDOMAIN channel variable.
23
   outbound call by using the SIPFROMDOMAIN channel variable.
24
 * Added a new configuration option "remotesecret" for authentication to
24
 * Added a new configuration option "remotesecret" for authentication to
25
   remote services. For backwards compatibility, "secret" still has the
25
   remote services. For backwards compatibility, "secret" still has the
26
   same function as before, but now you can configure both a remote secret and a
26
   same function as before, but now you can configure both a remote secret and a
27
   local secret for mutual authentication.
27
   local secret for mutual authentication.
28
 * Added a new 'faxdetect=yes|no' configuration option to sip.conf.  When this
28
 * Added a new 'faxdetect=yes|no' configuration option to sip.conf.  When this
29
   option is enabled, a SIP channel will go to the fax extension (if it exists)
29
   option is enabled, a SIP channel will go to the fax extension (if it exists)
30
   after T38 is negotiated.  This option is disabled by default.
30
   after T38 is negotiated.  This option is disabled by default.
31
 * If ATTENDED_TRANSFER_COMPLETE_SOUND is set, the sound will be played to the
31
 * If ATTENDED_TRANSFER_COMPLETE_SOUND is set, the sound will be played to the
32
   target of an attended transfer
32
   target of an attended transfer
33
 * Added two new configuration options, "qualifygap" and "qualifypeers", which allow
33
 * Added two new configuration options, "qualifygap" and "qualifypeers", which allow
34
   finer control over how many peers Asterisk will qualify and the gap between them
34
   finer control over how many peers Asterisk will qualify and the gap between them
35
   when all peers need to be qualified at the same time.
35
   when all peers need to be qualified at the same time.
36
 * Added a new 'ignoresdpversion' option to sip.conf.  When this is enabled
36
 * Added a new 'ignoresdpversion' option to sip.conf.  When this is enabled
37
   (either globally or for a specific peer), chan_sip will treat any SDP data
37
   (either globally or for a specific peer), chan_sip will treat any SDP data
38
   it receives as new data and update the media stream accordingly.  By
38
   it receives as new data and update the media stream accordingly.  By
39
   default, Asterisk will only modify the media stream if the SDP session
39
   default, Asterisk will only modify the media stream if the SDP session
40
   version received is different from the current SDP session version.  This
40
   version received is different from the current SDP session version.  This
41
   option is required to interoperate with devices that have non-standard SDP
41
   option is required to interoperate with devices that have non-standard SDP
42
   session version implementations (observed with Microsoft OCS).  This option
42
   session version implementations (observed with Microsoft OCS).  This option
43
   is diabled by default.
43
   is diabled by default.
44

    
   
44

   
45
Skinny Changes
45
Skinny Changes
46
--------------
46
--------------
47
 * The configuration file now holds separate sections for devices and lines.
47
 * The configuration file now holds separate sections for devices and lines.
48
   Please have a look at configs/skinny.conf.sample and change your skinny.conf
48
   Please have a look at configs/skinny.conf.sample and change your skinny.conf
49
   accordingly.
49
   accordingly.
50

    
   
50

   
51
DAHDI Changes
51
DAHDI Changes
52
-------------
52
-------------
53
 * The UK option waitfordialtone has been added for use with BT analog
53
 * The UK option waitfordialtone has been added for use with BT analog
54
   lines.
54
   lines.
55

    
   
55

   
56
Dialplan Functions
56
Dialplan Functions
57
------------------
57
------------------
58
 * Added a new dialplan function, CURLOPT, which permits setting various
58
 * Added a new dialplan function, CURLOPT, which permits setting various
59
   options that may be useful with the CURL dialplan function, such as
59
   options that may be useful with the CURL dialplan function, such as
60
   cookies, proxies, connection timeouts, passwords, etc.
60
   cookies, proxies, connection timeouts, passwords, etc.
61
 * Permit the syntax and synopsis fields of the corresponding dialplan
61
 * Permit the syntax and synopsis fields of the corresponding dialplan
62
   functions to be individually set from func_odbc.conf.
62
   functions to be individually set from func_odbc.conf.
63
 * Added debugging CLI functions to func_odbc, 'odbc read' and 'odbc write'.
63
 * Added debugging CLI functions to func_odbc, 'odbc read' and 'odbc write'.
64
 * func_odbc now may specify an insert query to execute, when the write query
64
 * func_odbc now may specify an insert query to execute, when the write query
65
   affects 0 rows (usually indicating that no such row exists).
65
   affects 0 rows (usually indicating that no such row exists).
66
 * Added a new dialplan function, LISTFILTER, which permits removing elements
66
 * Added a new dialplan function, LISTFILTER, which permits removing elements
67
   from a set list, by name.  Uses the same general syntax as the existing CUT
67
   from a set list, by name.  Uses the same general syntax as the existing CUT
68
   and FIELDQTY dialplan functions, which also manage lists.
68
   and FIELDQTY dialplan functions, which also manage lists.
69
 * Added REALTIME_FIELD and REALTIME_HASH, which should aid users in better
69
 * Added REALTIME_FIELD and REALTIME_HASH, which should aid users in better
70
   obtaining realtime data from the dialplan.
70
   obtaining realtime data from the dialplan.
71
 * Added LOCAL_PEEK, which I have no idea how to use, but Leif Madsen wanted it.
71
 * Added LOCAL_PEEK, which I have no idea how to use, but Leif Madsen wanted it.
72
   Russell says it's, like, a scope resolution function for LOCAL variables.
72
   Russell says it's, like, a scope resolution function for LOCAL variables.
73
   Totally.  Hopefully, that means more to you than it does to me.
73
   Totally.  Hopefully, that means more to you than it does to me.
74
 * Added AUDIOHOOK_INHERIT. For information on its use, please see the output
74
 * Added AUDIOHOOK_INHERIT. For information on its use, please see the output
75
   of "core show function AUDIOHOOK_INHERIT" from the CLI
75
   of "core show function AUDIOHOOK_INHERIT" from the CLI
76

    
   
76

   
77
Applications
77
Applications
78
------------
78
------------
79
 * Scheduled meetme conferences may now have their end times extended by
79
 * Scheduled meetme conferences may now have their end times extended by
80
   using MeetMeAdmin.
80
   using MeetMeAdmin.
81
 * app_authenticate now gives the ability to select a prompt other than
81
 * app_authenticate now gives the ability to select a prompt other than
82
   the default.
82
   the default.
83
 * app_directory now pays attention to the searchcontexts setting in
83
 * app_directory now pays attention to the searchcontexts setting in
84
   voicemail.conf and will look through all contexts, if no context is
84
   voicemail.conf and will look through all contexts, if no context is
85
   specified in the initial argument.
85
   specified in the initial argument.
86
 * A new application, Originate, has been introduced, that allows asynchronous
86
 * A new application, Originate, has been introduced, that allows asynchronous
87
   call origination from the dialplan.
87
   call origination from the dialplan.
88

    
   
88

   
89
Miscellaneous
89
Miscellaneous
90
-------------
90
-------------
91
 * The Asterisk CLI has a new command, "channel redirect", which is similar in
91
 * The Asterisk CLI has a new command, "channel redirect", which is similar in
92
   operation to the AMI Redirect action.
92
   operation to the AMI Redirect action.
93
 * res_jabber: autoprune has been disabled by default, to avoid misconfiguration 
93
 * res_jabber: autoprune has been disabled by default, to avoid misconfiguration 
94
   that would end up being interpreted as a bug once Asterisk started removing 
94
   that would end up being interpreted as a bug once Asterisk started removing 
95
   the contacts from a user list.
95
   the contacts from a user list.
96
 * extensions.conf now allows you to use keyword "same" to define an extension
96
 * extensions.conf now allows you to use keyword "same" to define an extension
97
   without actually specifying an extension.  It uses exactly the same pattern
97
   without actually specifying an extension.  It uses exactly the same pattern
98
   as previously used on the last "exten" line.  For example:
98
   as previously used on the last "exten" line.  For example:
99
     exten => 123,1,NoOp(something)
99
     exten => 123,1,NoOp(something)
100
     same  =>     n,SomethingElse()
100
     same  =>     n,SomethingElse()
101
 * musiconhold.conf classes of type 'files' can now use relative directory paths,
101
 * musiconhold.conf classes of type 'files' can now use relative directory paths,
102
   which are interpreted as relative to the astvarlibdir setting in asterisk.conf.
102
   which are interpreted as relative to the astvarlibdir setting in asterisk.conf.
103
 * All deprecated CLI commands are removed from the sourcecode. They are now handled
103
 * All deprecated CLI commands are removed from the sourcecode. They are now handled
104
   by the new clialiases module. See cli_aliases.conf.sample file.
104
   by the new clialiases module. See cli_aliases.conf.sample file.
105
 * Times within timespecs are now accurate down to the minute.  This is a change
105
 * Times within timespecs are now accurate down to the minute.  This is a change
106
   from historical Asterisk, which only provided timespecs rounded to the nearest
106
   from historical Asterisk, which only provided timespecs rounded to the nearest
107
   even (read: evenly divisible by 2) minute mark.
107
   even (read: evenly divisible by 2) minute mark.
108
 * The realtime switch now supports an option flag, 'p', which disables searches for
108
 * The realtime switch now supports an option flag, 'p', which disables searches for
109
   pattern matches.
109
   pattern matches.
110
 * In addition to a time range and date range, timespecs now accept a 5th optional
110
 * In addition to a time range and date range, timespecs now accept a 5th optional
111
   argument, timezone.  This allows you to perform time checks on alternate
111
   argument, timezone.  This allows you to perform time checks on alternate
112
   timezones, especially if those daylight savings time ranges vary from your
112
   timezones, especially if those daylight savings time ranges vary from your
113
   machine's native timezone.  See GotoIfTime, ExecIfTime, IFTIME(), and timed
113
   machine's native timezone.  See GotoIfTime, ExecIfTime, IFTIME(), and timed
114
   includes.
114
   includes.
115

    
   
115

   
116
Asterisk Manager Interface
116
Asterisk Manager Interface
117
--------------------------
117
--------------------------
118
 * When using the AMI over HTTP, you can now include a 'SuppressEvents' header (with
118
 * When using the AMI over HTTP, you can now include a 'SuppressEvents' header (with
119
   a non-empty value) in your request. If you do this, any pending AMI events will
119
   a non-empty value) in your request. If you do this, any pending AMI events will
120
   *not* be included in the response to your request as they would normally, but
120
   *not* be included in the response to your request as they would normally, but
121
   will be left in the event queue for the next request you make to retrieve. For
121
   will be left in the event queue for the next request you make to retrieve. For
122
   some applications, this will allow you to guarantee that you will only see
122
   some applications, this will allow you to guarantee that you will only see
123
   events in responses to 'WaitEvent' actions, and can better know when to expect them.
123
   events in responses to 'WaitEvent' actions, and can better know when to expect them.
124
   To know whether the Asterisk server supports this header or not, your client can
124
   To know whether the Asterisk server supports this header or not, your client can
125
   inspect the first response back from the server to see if it includes this header:
125
   inspect the first response back from the server to see if it includes this header:
126

    
   
126

   
127
   Pragma: SuppressEvents
127
   Pragma: SuppressEvents
128

    
   
128

   
129
   If this is included, the server supports event suppression.
129
   If this is included, the server supports event suppression.
130

    
   
130

   

    
   
131
AEL

    
   
132
---

    
   
133
* Macros now support returning a value, and direct assignment of that value to a

    
   
134
  variable or function.  For example:

    
   
135

   

    
   
136
    macro returnmacro() {

    
   
137
	MYVAR=10;

    
   
138
	return ${MYVAR};

    
   
139
    }

    
   
140

   

    
   
141
   FOO=&returnmacro();

    
   
142

   

    
   
143

   
131
------------------------------------------------------------------------------
144
------------------------------------------------------------------------------
132
--- Functionality changes from Asterisk 1.6.0 to Asterisk 1.6.1  -------------
145
--- Functionality changes from Asterisk 1.6.0 to Asterisk 1.6.1  -------------
133
------------------------------------------------------------------------------
146
------------------------------------------------------------------------------
134

    
   
147

   
135
Device State Handling
148
Device State Handling
136
---------------------
149
---------------------
137
 * The event infrastructure in Asterisk got another big update to help support
150
 * The event infrastructure in Asterisk got another big update to help support
138
    distributed events.  It currently supports distributed device state and
151
    distributed events.  It currently supports distributed device state and
139
    distributed Voicemail MWI (Message Waiting Indication).  A new module has
152
    distributed Voicemail MWI (Message Waiting Indication).  A new module has
140
    been merged, res_ais, which facilitates communicating events between servers.
153
    been merged, res_ais, which facilitates communicating events between servers.
141
    It uses the SAForum AIS (Service Availability Forum Application Interface
154
    It uses the SAForum AIS (Service Availability Forum Application Interface
142
    Specification) CLM (Cluster Management) and EVT (Event) services to maintain
155
    Specification) CLM (Cluster Management) and EVT (Event) services to maintain
143
    a cluster of Asterisk servers, and to share events between them.  For more
156
    a cluster of Asterisk servers, and to share events between them.  For more
144
    information on setting this up, see doc/distributed_devstate.txt.
157
    information on setting this up, see doc/distributed_devstate.txt.
145

    
   
158

   
146
Dialplan Functions
159
Dialplan Functions
147
------------------
160
------------------
148
 * Added a new dialplan function, AST_CONFIG(), which allows you to access
161
 * Added a new dialplan function, AST_CONFIG(), which allows you to access
149
   variables from an Asterisk configuration file.
162
   variables from an Asterisk configuration file.
150
 * The JACK_HOOK function now has a c() option to supply a custom client name.
163
 * The JACK_HOOK function now has a c() option to supply a custom client name.
151
 * Added two new dialplan functions from libspeex for audio gain control and 
164
 * Added two new dialplan functions from libspeex for audio gain control and 
152
   denoise, AGC() and DENOISE(). Both functions can be applied to the tx and 
165
   denoise, AGC() and DENOISE(). Both functions can be applied to the tx and 
153
   rx directions of a channel from the dialplan.
166
   rx directions of a channel from the dialplan.
154
 * The SMDI_MSG_RETRIEVE function now has the ability to search for SMDI messages
167
 * The SMDI_MSG_RETRIEVE function now has the ability to search for SMDI messages
155
   based on other parameters.  The default is still to search based on the
168
   based on other parameters.  The default is still to search based on the
156
   forwarding station ID.  However, there are new options that allow you to search
169
   forwarding station ID.  However, there are new options that allow you to search
157
   based on the message desk terminal ID, or the message desk number.
170
   based on the message desk terminal ID, or the message desk number.
158
 * TIMEOUT() has been modified to be accurate down to the millisecond.
171
 * TIMEOUT() has been modified to be accurate down to the millisecond.
159
 * ENUM*() functions now include the following new options:
172
 * ENUM*() functions now include the following new options:
160
     - 'u' returns the full URI and does not strip off the URI-scheme.
173
     - 'u' returns the full URI and does not strip off the URI-scheme.
161
     - 's' triggers ISN specific rewriting
174
     - 's' triggers ISN specific rewriting
162
     - 'i' looks for branches into an Infrastructure ENUM tree
175
     - 'i' looks for branches into an Infrastructure ENUM tree
163
     - 'd' for a direct DNS lookup without any flipping of digits.
176
     - 'd' for a direct DNS lookup without any flipping of digits.
164
 * TXCIDNAME() has a new zone-suffix parameter (which defaults to 'e164.arpa')
177
 * TXCIDNAME() has a new zone-suffix parameter (which defaults to 'e164.arpa')
165
 * CHANNEL() now has options for the maximum, minimum, and standard or normal
178
 * CHANNEL() now has options for the maximum, minimum, and standard or normal
166
   deviation of jitter, rtt, and loss for a call using chan_sip.
179
   deviation of jitter, rtt, and loss for a call using chan_sip.
167

    
   
180

   
168
DAHDI channel driver (chan_dahdi) Changes
181
DAHDI channel driver (chan_dahdi) Changes
169
----------------------------------------
182
----------------------------------------
170
 * Channels can now be configured using named sections in chan_dahdi.conf, just
183
 * Channels can now be configured using named sections in chan_dahdi.conf, just
171
   like other channel drivers, including the use of templates.
184
   like other channel drivers, including the use of templates.
172
 * The default for pridialplan has changed from 'national' to 'unknown'.
185
 * The default for pridialplan has changed from 'national' to 'unknown'.
173

    
   
186

   
174
PBX Changes
187
PBX Changes
175
-----------
188
-----------
176
 * It is now possible to specify a pattern match as a hint. Once a phone subscribes
189
 * It is now possible to specify a pattern match as a hint. Once a phone subscribes
177
   to something that matches the pattern a hint will be created using the contents
190
   to something that matches the pattern a hint will be created using the contents
178
   and variables evaluated.
191
   and variables evaluated.
179
 * Dialplan matching has been extended to allow an extension to return to the
192
 * Dialplan matching has been extended to allow an extension to return to the
180
   PBX core to wait for more digits.  This is done by using the new dialplan
193
   PBX core to wait for more digits.  This is done by using the new dialplan
181
   application called "Incomplete".  This will permit a whole new level of
194
   application called "Incomplete".  This will permit a whole new level of
182
   extension control, by giving the administrator more control over early
195
   extension control, by giving the administrator more control over early
183
   matches employing one of the short-circuit pattern match operators.  Note
196
   matches employing one of the short-circuit pattern match operators.  Note
184
   that custom applications can trigger this same behavior by returning the
197
   that custom applications can trigger this same behavior by returning the
185
   special value AST_PBX_INCOMPLETE.
198
   special value AST_PBX_INCOMPLETE.
186

    
   
199

   
187
Application Changes
200
Application Changes
188
-------------------
201
-------------------
189
 * Directory now permits both first and last names to be matched at the same
202
 * Directory now permits both first and last names to be matched at the same
190
   time.  In addition, the number of digits to enter of the name can be set in
203
   time.  In addition, the number of digits to enter of the name can be set in
191
   the arguments to Directory; previously, you could enter only 3, regardless
204
   the arguments to Directory; previously, you could enter only 3, regardless
192
   of how many names are in your company.  For large companies, this should be
205
   of how many names are in your company.  For large companies, this should be
193
   quite helpful.
206
   quite helpful.
194
 * Voicemail now permits a mailbox setting to wrap around from first to last
207
 * Voicemail now permits a mailbox setting to wrap around from first to last
195
   messages, if the "messagewrap" option is set to a true value.
208
   messages, if the "messagewrap" option is set to a true value.
196
 * Voicemail now permits an external script to be run, for password validation.
209
 * Voicemail now permits an external script to be run, for password validation.
197
   The script should output "VALID" or "INVALID" on stdout, depending upon the
210
   The script should output "VALID" or "INVALID" on stdout, depending upon the
198
   wish to validate or invalidate the password given.  Arguments are:
211
   wish to validate or invalidate the password given.  Arguments are:
199
   "mailbox" "context" "oldpass" "newpass".  See the sample voicemail.conf for
212
   "mailbox" "context" "oldpass" "newpass".  See the sample voicemail.conf for
200
   more details
213
   more details
201
 * Dial has a new option: F(context^extension^pri), which permits a callee to
214
 * Dial has a new option: F(context^extension^pri), which permits a callee to
202
   continue in the dialplan, at the specified label, if the caller hangs up.
215
   continue in the dialplan, at the specified label, if the caller hangs up.
203
 * ChanSpy and ExtenSpy have a new option, 's' which suppresses speaking the
216
 * ChanSpy and ExtenSpy have a new option, 's' which suppresses speaking the
204
   technology name (e.g. SIP, IAX, etc) of the channel being spied on.
217
   technology name (e.g. SIP, IAX, etc) of the channel being spied on.
205
 * The Jack application now has a c() option to supply a custom client name.
218
 * The Jack application now has a c() option to supply a custom client name.
206
 * Chanspy has a new option, 'B', which can be used to "barge" on a call. This is
219
 * Chanspy has a new option, 'B', which can be used to "barge" on a call. This is
207
   like the pre-existing whisper mode, except that the spy can also talk to the
220
   like the pre-existing whisper mode, except that the spy can also talk to the
208
   participant on the bridged channel as well.
221
   participant on the bridged channel as well.
209
 * Chanspy has a new option, 'n', which will allow for the spied-on party's name
222
 * Chanspy has a new option, 'n', which will allow for the spied-on party's name
210
   to be spoken instead of the channel name or number. For more information on the
223
   to be spoken instead of the channel name or number. For more information on the
211
   use of this option, issue the command "core show application ChanSpy" from the 
224
   use of this option, issue the command "core show application ChanSpy" from the 
212
   Asterisk CLI.
225
   Asterisk CLI.
213
 * Chanspy has a new option, 'd', which allows the spy to use DTMF to swap between
226
 * Chanspy has a new option, 'd', which allows the spy to use DTMF to swap between
214
   spy modes. Use of this feature overrides the typical use of numeric DTMF. In other
227
   spy modes. Use of this feature overrides the typical use of numeric DTMF. In other
215
   words, if using the 'd' option, it is not possible to enter a number to append to
228
   words, if using the 'd' option, it is not possible to enter a number to append to
216
   the first argument to Chanspy(). Pressing 4 will change to spy mode, pressing 5 will
229
   the first argument to Chanspy(). Pressing 4 will change to spy mode, pressing 5 will
217
   change to whisper mode, and pressing 6 will change to barge mode.
230
   change to whisper mode, and pressing 6 will change to barge mode.
218
 * ExternalIVR now takes several options that affect the way it performs, as
231
 * ExternalIVR now takes several options that affect the way it performs, as
219
   well as having several new commands.  Please see doc/externalivr.txt for the
232
   well as having several new commands.  Please see doc/externalivr.txt for the
220
   complete documentation.
233
   complete documentation.
221
 * Added ability to communicate over a TCP socket instead of forking a child process for the 
234
 * Added ability to communicate over a TCP socket instead of forking a child process for the 
222
   ExternalIVR application.
235
   ExternalIVR application.
223
 * ChanIsAvail has a new option, 'a', which will return all available channels instead
236
 * ChanIsAvail has a new option, 'a', which will return all available channels instead
224
   of just the first one if you give the function more then one channel to check.
237
   of just the first one if you give the function more then one channel to check.
225
 * PrivacyManager now takes an option where you can specify a context where the 
238
 * PrivacyManager now takes an option where you can specify a context where the 
226
   given number will be matched. This way you have more control over who is allowed
239
   given number will be matched. This way you have more control over who is allowed
227
   and it stops the people who blindly enter 10 digits.
240
   and it stops the people who blindly enter 10 digits.
228
 * ForkCDR has new options: 'a' updates the answer time on the new CDR; 'A' locks
241
 * ForkCDR has new options: 'a' updates the answer time on the new CDR; 'A' locks
229
   answer times, disposition, on orig CDR against updates; 'D' Copies the disposition
242
   answer times, disposition, on orig CDR against updates; 'D' Copies the disposition
230
   from the orig CDR to the new CDR after reset; 'e' sets the 'end' time on the
243
   from the orig CDR to the new CDR after reset; 'e' sets the 'end' time on the
231
   original CDR; 'R' prevents the new CDR from being reset; 's(var=val)' adds/changes
244
   original CDR; 'R' prevents the new CDR from being reset; 's(var=val)' adds/changes
232
   the 'var' variable on the original CDR; 'T' forces ast_cdr_end(), ast_cdr_answer(),
245
   the 'var' variable on the original CDR; 'T' forces ast_cdr_end(), ast_cdr_answer(),
233
   obey the LOCKED flag on cdr's in the chain, and also the ast_cdr_setvar() func.
246
   obey the LOCKED flag on cdr's in the chain, and also the ast_cdr_setvar() func.
234
 * The Dial() application no longer copies the language used by the caller to the callee's
247
 * The Dial() application no longer copies the language used by the caller to the callee's
235
   channel. If you desire for the caller's channel's language to be used for file playback
248
   channel. If you desire for the caller's channel's language to be used for file playback
236
   to the callee, then the file specified may be prepended with "${CHANNEL(language)}/" .
249
   to the callee, then the file specified may be prepended with "${CHANNEL(language)}/" .
237
 * SendImage() no longer hangs up the channel on error; instead, it sets the
250
 * SendImage() no longer hangs up the channel on error; instead, it sets the
238
   status variable SENDIMAGESTATUS to one of 'SUCCESS', 'FAILURE', or
251
   status variable SENDIMAGESTATUS to one of 'SUCCESS', 'FAILURE', or
239
   'UNSUPPORTED'.  This change makes SendImage() more consistent with other
252
   'UNSUPPORTED'.  This change makes SendImage() more consistent with other
240
   applications.
253
   applications.
241
 * Park has a new option, 's', which silences the announcement of the parking space number.
254
 * Park has a new option, 's', which silences the announcement of the parking space number.
242
 * A non-numeric, zero, or negative timeout specified to Dial() will now be interpreted as
255
 * A non-numeric, zero, or negative timeout specified to Dial() will now be interpreted as
243
   invalid input and will be assumed to mean that no timeout is desired.
256
   invalid input and will be assumed to mean that no timeout is desired.
244

    
   
257

   
245
SIP Changes
258
SIP Changes
246
-----------
259
-----------
247
 * Added DNS manager support to registrations for peers referencing peer entries.
260
 * Added DNS manager support to registrations for peers referencing peer entries.
248
   DNS manager runs in the background which allows DNS lookups to be run asynchronously 
261
   DNS manager runs in the background which allows DNS lookups to be run asynchronously 
249
   as well as periodically updating the IP address. These properties allow for
262
   as well as periodically updating the IP address. These properties allow for
250
   better performance as well as recovery in the event of an IP change.
263
   better performance as well as recovery in the event of an IP change.
251
 * Performance improvements via using hash tables (astobj2) and doubly-linked lists to improve 
264
 * Performance improvements via using hash tables (astobj2) and doubly-linked lists to improve 
252
   load/reload of large numbers of peers/users by ~40x (for large lists of peers.
265
   load/reload of large numbers of peers/users by ~40x (for large lists of peers.
253
   Initially, we saw 4x improvement in call setup/destruction, but at the time
266
   Initially, we saw 4x improvement in call setup/destruction, but at the time
254
   of merging, this gain has disappeared; further research will be done to try
267
   of merging, this gain has disappeared; further research will be done to try
255
   and restore this performance improvement. Astobj2 refcounting is now used
268
   and restore this performance improvement. Astobj2 refcounting is now used
256
   for users, peers, and dialogs.  Users are encouraged to assist in regression
269
   for users, peers, and dialogs.  Users are encouraged to assist in regression
257
   testing and problem reporting!
270
   testing and problem reporting!
258
 * Added ability to specify registration expiry time on a per registration basis in
271
 * Added ability to specify registration expiry time on a per registration basis in
259
   the register line.
272
   the register line.
260
 * Added support for T140 RED - redundancy in T.140 to prevent text loss due to
273
 * Added support for T140 RED - redundancy in T.140 to prevent text loss due to
261
   lost packets.
274
   lost packets.
262
 * Added t38pt_usertpsource option. See sip.conf.sample for details.
275
 * Added t38pt_usertpsource option. See sip.conf.sample for details.
263
 * Added SIPnotify AMI command, for sending arbitrary SIP notify commands.
276
 * Added SIPnotify AMI command, for sending arbitrary SIP notify commands.
264
 * 'sip show peers' and 'sip show users' display their entries sorted in
277
 * 'sip show peers' and 'sip show users' display their entries sorted in
265
    alphabetical order, as opposed to the order they were in, in the config 
278
    alphabetical order, as opposed to the order they were in, in the config 
266
    file or database. 
279
    file or database. 
267
 * Videosupport now supports an additional option, "always", which always sets
280
 * Videosupport now supports an additional option, "always", which always sets
268
    up video RTP ports, even on clients that don't support it.  This helps with
281
    up video RTP ports, even on clients that don't support it.  This helps with
269
    callfiles and certain transfers to ensure that if two video phones are
282
    callfiles and certain transfers to ensure that if two video phones are
270
    connected, they will always share video feeds.
283
    connected, they will always share video feeds.
271

    
   
284

   
272
IAX Changes
285
IAX Changes
273
-----------
286
-----------
274
 * Existing DNS manager lookups extended to check for SRV records.
287
 * Existing DNS manager lookups extended to check for SRV records.
275
 * IAX2 encryption support has been improved to support periodic key rotation
288
 * IAX2 encryption support has been improved to support periodic key rotation
276
   within a call for enhanced security.  The option "keyrotate" has been
289
   within a call for enhanced security.  The option "keyrotate" has been
277
   provided to disable this functionality to preserve backwards compatibility
290
   provided to disable this functionality to preserve backwards compatibility
278
   with older versions of IAX2 that do not support key rotation.
291
   with older versions of IAX2 that do not support key rotation.
279

    
   
292

   
280
CLI Changes
293
CLI Changes
281
-----------
294
-----------
282
  * New CLI command, "config reload <file.conf>" which reloads any module that
295
  * New CLI command, "config reload <file.conf>" which reloads any module that
283
     references that particular configuration file.  Also added "config list"
296
     references that particular configuration file.  Also added "config list"
284
     which shows which configuration files are in use.
297
     which shows which configuration files are in use.
285
  * New CLI commands, "pri show version" and "ss7 show version" that will
298
  * New CLI commands, "pri show version" and "ss7 show version" that will
286
     display which version of libpri and libss7 are being used, respectively.
299
     display which version of libpri and libss7 are being used, respectively.
287
     A new API call was added so trunk will now have to be compiled against
300
     A new API call was added so trunk will now have to be compiled against
288
     a versions of libpri and libss7 that have them or it will not know that
301
     a versions of libpri and libss7 that have them or it will not know that
289
     these libraries exist.
302
     these libraries exist.
290
  * The commands "core show globals", "core set global" and "core set chanvar" has
303
  * The commands "core show globals", "core set global" and "core set chanvar" has
291
     been deprecated in favor of the more semanticly correct "dialplan show globals",
304
     been deprecated in favor of the more semanticly correct "dialplan show globals",
292
     "dialplan set chanvar" and "dialplan set global".
305
     "dialplan set chanvar" and "dialplan set global".
293
  * New CLI command "dialplan show chanvar" to list all variables associated
306
  * New CLI command "dialplan show chanvar" to list all variables associated
294
    with a given channel.
307
    with a given channel.
295

    
   
308

   
296
DNS manager changes
309
DNS manager changes
297
-------------------
310
-------------------
298
  * Addresses managed by DNS manager now can check to see if there is a DNS
311
  * Addresses managed by DNS manager now can check to see if there is a DNS
299
    SRV record for a given domain and will use that hostname/port if present.
312
    SRV record for a given domain and will use that hostname/port if present.
300

    
   
313

   
301
AMI - The manager (TCP/TLS/HTTP)
314
AMI - The manager (TCP/TLS/HTTP)
302
--------------------------------
315
--------------------------------
303
  * The Status command now takes an optional list of variables to display
316
  * The Status command now takes an optional list of variables to display
304
    along with channel status.
317
    along with channel status.
305
  * The QueueEntry event now also includes the channel's uniqueid
318
  * The QueueEntry event now also includes the channel's uniqueid
306

    
   
319

   
307
ODBC Changes
320
ODBC Changes
308
------------
321
------------
309
  * res_odbc no longer has a limit of 1023 total possible unshared connections,
322
  * res_odbc no longer has a limit of 1023 total possible unshared connections,
310
    as some people were running into this limit.  This limit has been increased
323
    as some people were running into this limit.  This limit has been increased
311
    to 4.2 billion.
324
    to 4.2 billion.
312

    
   
325

   
313
Queue changes
326
Queue changes
314
-------------
327
-------------
315
  * The TRANSFER queue log entry now includes the the caller's original
328
  * The TRANSFER queue log entry now includes the the caller's original
316
    position in the transferred-from queue.
329
    position in the transferred-from queue.
317
  * A new configuration option, "timeoutpriority" has been added. Please see the section labeled
330
  * A new configuration option, "timeoutpriority" has been added. Please see the section labeled
318
    "QUEUE TIMING OPTIONS" in configs/queues.conf.sample for a detailed explanation of the option
331
    "QUEUE TIMING OPTIONS" in configs/queues.conf.sample for a detailed explanation of the option
319
    as well as an explanation about timeout options in general
332
    as well as an explanation about timeout options in general
320

    
   
333

   
321
Realtime changes
334
Realtime changes
322
----------------
335
----------------
323
  * Several (ODBC, Postgres, MySQL, SQLite) realtime drivers have been given
336
  * Several (ODBC, Postgres, MySQL, SQLite) realtime drivers have been given
324
    adaptive capabilities.  What this means in practical terms is that if your
337
    adaptive capabilities.  What this means in practical terms is that if your
325
    realtime table lacks critical fields, Asterisk will now emit warnings to
338
    realtime table lacks critical fields, Asterisk will now emit warnings to
326
    that effect.  Also, some of the realtime drivers have the ability (if
339
    that effect.  Also, some of the realtime drivers have the ability (if
327
    configured) to automatically add those columns to the table with the
340
    configured) to automatically add those columns to the table with the
328
    correct type and length.
341
    correct type and length.
329

    
   
342

   
330
Miscellaneous
343
Miscellaneous
331
-------------
344
-------------
332
  * The channel variable ATTENDED_TRANSFER_COMPLETE_SOUND can now be set using
345
  * The channel variable ATTENDED_TRANSFER_COMPLETE_SOUND can now be set using
333
    the 'setvar' option to cause a given audio file to be played upon completion
346
    the 'setvar' option to cause a given audio file to be played upon completion
334
    of an attended transfer.  Currently it works for DAHDI, IAX2, SIP, and
347
    of an attended transfer.  Currently it works for DAHDI, IAX2, SIP, and
335
    Skinny channels only.
348
    Skinny channels only.
336
  * You can now compile Asterisk against the Hoard Memory Allocator, see doc/hoard.txt
349
  * You can now compile Asterisk against the Hoard Memory Allocator, see doc/hoard.txt
337
    for more information.
350
    for more information.
338
  * Config file variables may now be appended to, by using the '+=' append
351
  * Config file variables may now be appended to, by using the '+=' append
339
    operator.  This is most helpful when working with long SQL queries in
352
    operator.  This is most helpful when working with long SQL queries in
340
    func_odbc.conf, as the queries no longer need to be specified on a single
353
    func_odbc.conf, as the queries no longer need to be specified on a single
341
    line.
354
    line.
342
  * CDR config file, cdr.conf, has an added option, "initiatedseconds", 
355
  * CDR config file, cdr.conf, has an added option, "initiatedseconds", 
343
    which will add a second to the billsec when the ending
356
    which will add a second to the billsec when the ending
344
    time is set, if the number in the microseconds field of the end time is 
357
    time is set, if the number in the microseconds field of the end time is 
345
    greater than the number of microseconds in the answer time. This allows
358
    greater than the number of microseconds in the answer time. This allows
346
    users to count the 'initiated' seconds in their billing records. 
359
    users to count the 'initiated' seconds in their billing records. 
347

    
   
360

   
348
------------------------------------------------------------------------------
361
------------------------------------------------------------------------------
349
--- Functionality changes from Asterisk 1.4.X to Asterisk 1.6.0  -------------
362
--- Functionality changes from Asterisk 1.4.X to Asterisk 1.6.0  -------------
350
------------------------------------------------------------------------------
363
------------------------------------------------------------------------------
351

    
   
364

   
352
AMI - The manager (TCP/TLS/HTTP)
365
AMI - The manager (TCP/TLS/HTTP)
353
--------------------------------
366
--------------------------------
354
  * Manager has undergone a lot of changes, all of them documented
367
  * Manager has undergone a lot of changes, all of them documented
355
    in doc/manager_1_1.txt
368
    in doc/manager_1_1.txt
356
  * Manager version has changed to 1.1
369
  * Manager version has changed to 1.1
357
  * Added a new action 'CoreShowChannels' to list currently defined channels
370
  * Added a new action 'CoreShowChannels' to list currently defined channels
358
     and some information about them. 
371
     and some information about them. 
359
  * Added a new action 'SIPshowregistry' to list SIP registrations.
372
  * Added a new action 'SIPshowregistry' to list SIP registrations.
360
  * Added TLS support for the manager interface and HTTP server
373
  * Added TLS support for the manager interface and HTTP server
361
  * Added the URI redirect option for the built-in HTTP server
374
  * Added the URI redirect option for the built-in HTTP server
362
  * The output of CallerID in Manager events is now more consistent.
375
  * The output of CallerID in Manager events is now more consistent.
363
     CallerIDNum is used for number and CallerIDName for name.
376
     CallerIDNum is used for number and CallerIDName for name.
364
  * Enable https support for builtin web server.
377
  * Enable https support for builtin web server.
365
     See configs/http.conf.sample for details.
378
     See configs/http.conf.sample for details.
366
  * Added a new action, GetConfigJSON, which can return the contents of an
379
  * Added a new action, GetConfigJSON, which can return the contents of an
367
     Asterisk configuration file in JSON format.  This is intended to help
380
     Asterisk configuration file in JSON format.  This is intended to help
368
     improve the performance of AJAX applications using the manager interface
381
     improve the performance of AJAX applications using the manager interface
369
     over HTTP.
382
     over HTTP.
370
  * SIP and IAX manager events now use "ChannelType" in all cases where we 
383
  * SIP and IAX manager events now use "ChannelType" in all cases where we 
371
     indicate channel driver. Previously, we used a mixture of "Channel"
384
     indicate channel driver. Previously, we used a mixture of "Channel"
372
     and "ChannelDriver" headers.
385
     and "ChannelDriver" headers.
373
  * Added a "Bridge" action which allows you to bridge any two channels that
386
  * Added a "Bridge" action which allows you to bridge any two channels that
374
     are currently active on the system.
387
     are currently active on the system.
375
  * Added a "ListAllVoicemailUsers" action that allows you to get a list of all
388
  * Added a "ListAllVoicemailUsers" action that allows you to get a list of all
376
     the voicemail users setup.
389
     the voicemail users setup.
377
  * Added 'DBDel' and 'DBDelTree' manager commands.
390
  * Added 'DBDel' and 'DBDelTree' manager commands.
378
  * cdr_manager now reports events via the "cdr" level, separating it from
391
  * cdr_manager now reports events via the "cdr" level, separating it from
379
     the very verbose "call" level.
392
     the very verbose "call" level.
380
  * Manager users are now stored in memory. If you change the manager account
393
  * Manager users are now stored in memory. If you change the manager account
381
    list (delete or add accounts) you need to reload manager.
394
    list (delete or add accounts) you need to reload manager.
382
  * Added Masquerade manager event for when a masquerade happens between
395
  * Added Masquerade manager event for when a masquerade happens between
383
     two channels.
396
     two channels.
384
  * Added "manager reload" command for the CLI
397
  * Added "manager reload" command for the CLI
385
  * Lots of commands that only provided information are now allowed under the
398
  * Lots of commands that only provided information are now allowed under the
386
     Reporting privilege, instead of only under Call or System.
399
     Reporting privilege, instead of only under Call or System.
387
  * The IAX* commands now require either System or Reporting privilege, to
400
  * The IAX* commands now require either System or Reporting privilege, to
388
     mirror the privileges of the SIP* commands.
401
     mirror the privileges of the SIP* commands.
389
  * Added ability to retrieve list of categories in a config file.
402
  * Added ability to retrieve list of categories in a config file.
390
  * Added ability to retrieve the content of a particular category.
403
  * Added ability to retrieve the content of a particular category.
391
  * Added ability to empty a context.
404
  * Added ability to empty a context.
392
  * Created new action to create a new file.
405
  * Created new action to create a new file.
393
  * Updated delete action to allow deletion by line number with respect to category.
406
  * Updated delete action to allow deletion by line number with respect to category.
394
  * Added new action insert to add new variable to category at specified line.
407
  * Added new action insert to add new variable to category at specified line.
395
  * Updated action newcat to allow new category to be inserted in file above another
408
  * Updated action newcat to allow new category to be inserted in file above another
396
    existing category.
409
    existing category.
397
  * Added new event "JitterBufStats" in the IAX2 channel
410
  * Added new event "JitterBufStats" in the IAX2 channel
398
  * Originate now requires the Originate privilege and, if you want to call out
411
  * Originate now requires the Originate privilege and, if you want to call out
399
    to a subshell, it requires the System privilege, as well.  This was done to
412
    to a subshell, it requires the System privilege, as well.  This was done to
400
    enhance manager security.
413
    enhance manager security.
401
  * Originate now accepts codec settings with "Codecs: alaw, ulaw, h264" 
414
  * Originate now accepts codec settings with "Codecs: alaw, ulaw, h264" 
402
  * New command: Atxfer. See doc/manager_1_1.txt for more details or 
415
  * New command: Atxfer. See doc/manager_1_1.txt for more details or 
403
    manager show command Atxfer from the CLI
416
    manager show command Atxfer from the CLI
404
  * New command: IAXregistry. See doc/manager_1_1.txt for more details or
417
  * New command: IAXregistry. See doc/manager_1_1.txt for more details or
405
    manager show command IAXregistry from the CLI
418
    manager show command IAXregistry from the CLI
406

    
   
419

   
407
Dialplan functions
420
Dialplan functions
408
------------------
421
------------------
409
  * Added the DEVICE_STATE() dialplan function which allows retrieving any device
422
  * Added the DEVICE_STATE() dialplan function which allows retrieving any device
410
     state in the dialplan, as well as creating custom device states that are
423
     state in the dialplan, as well as creating custom device states that are
411
     controllable from the dialplan.
424
     controllable from the dialplan.
412
  * Extend CALLERID() function with "pres" and "ton" parameters to
425
  * Extend CALLERID() function with "pres" and "ton" parameters to
413
     fetch string representation of calling number presentation indicator
426
     fetch string representation of calling number presentation indicator
414
     and numeric representation of type of calling number value.
427
     and numeric representation of type of calling number value.
415
  * MailboxExists converted to dialplan function
428
  * MailboxExists converted to dialplan function
416
  * A new option to Dial() for telling IP phones not to count the call
429
  * A new option to Dial() for telling IP phones not to count the call
417
     as "missed" when dial times out and cancels.
430
     as "missed" when dial times out and cancels.
418
  * Added LOCK(), TRYLOCK(), and UNLOCK(), which provide a single level dialplan
431
  * Added LOCK(), TRYLOCK(), and UNLOCK(), which provide a single level dialplan
419
     mutex.  No deadlocks are possible, as LOCK() only allows a single lock to be
432
     mutex.  No deadlocks are possible, as LOCK() only allows a single lock to be
420
     held for any given channel.  Also, locks are automatically freed when a
433
     held for any given channel.  Also, locks are automatically freed when a
421
     channel is hung up.
434
     channel is hung up.
422
  * Added HINT() dialplan function that allows retrieving hint information.
435
  * Added HINT() dialplan function that allows retrieving hint information.
423
     Hints are mappings between extensions and devices for the sake of 
436
     Hints are mappings between extensions and devices for the sake of 
424
     determining the state of an extension.  This function can retrieve the list
437
     determining the state of an extension.  This function can retrieve the list
425
     of devices or the name associated with a hint.
438
     of devices or the name associated with a hint.
426
  * Added EXTENSION_STATE() dialplan function which allows retrieving the state
439
  * Added EXTENSION_STATE() dialplan function which allows retrieving the state
427
    of any extension.
440
    of any extension.
428
  * Added SYSINFO() dialplan function which allows retrieval of system information
441
  * Added SYSINFO() dialplan function which allows retrieval of system information
429
  * Added a new dialplan function, DIALPLAN_EXISTS(), which allows you to check for
442
  * Added a new dialplan function, DIALPLAN_EXISTS(), which allows you to check for
430
     the existence of a dialplan target.
443
     the existence of a dialplan target.
431
  * Added two new dialplan functions, TOUPPER and TOLOWER, which convert a string to
444
  * Added two new dialplan functions, TOUPPER and TOLOWER, which convert a string to
432
     upper and lower case, respectively.
445
     upper and lower case, respectively.
433
  * When bridging, Asterisk sets the BRIDGEPVTCALLID to the channel drivers unique
446
  * When bridging, Asterisk sets the BRIDGEPVTCALLID to the channel drivers unique
434
     ID for the call (not the Asterisk call ID or unique ID), provided that the
447
     ID for the call (not the Asterisk call ID or unique ID), provided that the
435
     channel driver supports this. For SIP, you get the SIP call-ID for the
448
     channel driver supports this. For SIP, you get the SIP call-ID for the
436
     bridged channel which you can store in the CDR with a custom field.
449
     bridged channel which you can store in the CDR with a custom field.
437

    
   
450

   
438
CLI Changes
451
CLI Changes
439
-----------
452
-----------
440
  * Added CLI permissions, config file: cli_permissions.conf
453
  * Added CLI permissions, config file: cli_permissions.conf
441
     default is to allow all commands for every local user/group.
454
     default is to allow all commands for every local user/group.
442
     Also this new feature added three new CLI commands:
455
     Also this new feature added three new CLI commands:
443
      - cli check permissions {<username>|@<groupname>|<username>@<groupname>} [<command>]
456
      - cli check permissions {<username>|@<groupname>|<username>@<groupname>} [<command>]
444
      - cli reload permissions
457
      - cli reload permissions
445
      - cli show permissions
458
      - cli show permissions
446
  * New CLI command "core show hint" (usage: core show hint <exten>)
459
  * New CLI command "core show hint" (usage: core show hint <exten>)
447
  * New CLI command "core show settings"
460
  * New CLI command "core show settings"
448
  * Added 'core show channels count' CLI command.
461
  * Added 'core show channels count' CLI command.
449
  * Added the ability to set the core debug and verbose values on a per-file basis.
462
  * Added the ability to set the core debug and verbose values on a per-file basis.
450
  * Added 'queue pause member' and 'queue unpause member' CLI commands
463
  * Added 'queue pause member' and 'queue unpause member' CLI commands
451
  * Ability to set process limits ("ulimit") without restarting Asterisk
464
  * Ability to set process limits ("ulimit") without restarting Asterisk
452
  * Enhanced "agi debug" to print the channel name as a prefix to the debug
465
  * Enhanced "agi debug" to print the channel name as a prefix to the debug
453
     output to make debugging on busy systems much easier.
466
     output to make debugging on busy systems much easier.
454
  * New CLI commands "dialplan set extenpatternmatching true/false"
467
  * New CLI commands "dialplan set extenpatternmatching true/false"
455
  * New CLI command: "core set chanvar" to set a channel variable from the CLI.
468
  * New CLI command: "core set chanvar" to set a channel variable from the CLI.
456
  * Added an easy way to execute Asterisk CLI commands at startup.  Any commands
469
  * Added an easy way to execute Asterisk CLI commands at startup.  Any commands
457
    listed in the startup_commands section of cli.conf will get executed.
470
    listed in the startup_commands section of cli.conf will get executed.
458
  * Added a CLI command, "devstate change", which allows you to set custom device
471
  * Added a CLI command, "devstate change", which allows you to set custom device
459
     states from the func_devstate module that provides the DEVICE_STATE() function
472
     states from the func_devstate module that provides the DEVICE_STATE() function
460
     and handling of the "Custom:" devices.
473
     and handling of the "Custom:" devices.
461
  * New CLI command: "sip show sched" which shows all ast_sched entries for sip,
474
  * New CLI command: "sip show sched" which shows all ast_sched entries for sip,
462
    sorted into the different possible callbacks, with the number of entries
475
    sorted into the different possible callbacks, with the number of entries
463
    currently scheduled for each. Gives you a feel for how busy the sip channel
476
    currently scheduled for each. Gives you a feel for how busy the sip channel
464
    driver is.
477
    driver is.
465
  * Added 'skinny show lines verbose' CLI command. This will show the subs for every channel.
478
  * Added 'skinny show lines verbose' CLI command. This will show the subs for every channel.
466
  * Cleanup another bunch of CLI commands. Now all modules follow the same schema.
479
  * Cleanup another bunch of CLI commands. Now all modules follow the same schema.
467
    (Done by lmadsen, junky and mvanbaak during the devcon 2008)
480
    (Done by lmadsen, junky and mvanbaak during the devcon 2008)
468

    
   
481

   
469
SIP changes
482
SIP changes
470
-----------
483
-----------
471
  * Improved NAT and STUN support.
484
  * Improved NAT and STUN support.
472
     chan_sip now can use port numbers in bindaddr, externip and externhost
485
     chan_sip now can use port numbers in bindaddr, externip and externhost
473
     options, as well as contact a STUN server to detect its external address
486
     options, as well as contact a STUN server to detect its external address
474
     for the SIP socket. See sip.conf.sample, 'NAT' section.
487
     for the SIP socket. See sip.conf.sample, 'NAT' section.
475
  * The default SIP useragent= identifier now includes the Asterisk version
488
  * The default SIP useragent= identifier now includes the Asterisk version
476
  * A new option, match_auth_username in sip.conf changes the matching of incoming requests.
489
  * A new option, match_auth_username in sip.conf changes the matching of incoming requests.
477
     If set, and the incoming request carries authentication info,
490
     If set, and the incoming request carries authentication info,
478
     the username to match in the users list is taken from the Digest header
491
     the username to match in the users list is taken from the Digest header
479
     rather than from the From: field. This feature is considered experimental.
492
     rather than from the From: field. This feature is considered experimental.
480
  * The "musiconhold" and "musicclass" settings in sip.conf are now removed,
493
  * The "musiconhold" and "musicclass" settings in sip.conf are now removed,
481
     since they where replaced by "mohsuggest" and "mohinterpret" in version 1.4
494
     since they where replaced by "mohsuggest" and "mohinterpret" in version 1.4
482
  * The "localmask" setting was removed in version 1.2 and the reminder about it
495
  * The "localmask" setting was removed in version 1.2 and the reminder about it
483
     being removed is now also removed.
496
     being removed is now also removed.
484
  * A new option "busylevel" for setting a level of calls where asterisk reports
497
  * A new option "busylevel" for setting a level of calls where asterisk reports
485
     a device as busy, to separate it from call-limit. This value is also added
498
     a device as busy, to separate it from call-limit. This value is also added
486
     to the SIP_PEER dialplan function.
499
     to the SIP_PEER dialplan function.
487
  * A new realtime family called "sipregs" is now supported to store SIP registration
500
  * A new realtime family called "sipregs" is now supported to store SIP registration
488
     data. If this family is defined, "sippeers" will be used for configuration and
501
     data. If this family is defined, "sippeers" will be used for configuration and
489
     "sipregs" for registrations. If it's not defined, "sippeers" will be used for
502
     "sipregs" for registrations. If it's not defined, "sippeers" will be used for
490
     registration data, as before.
503
     registration data, as before.
491
  * The SIPPEER function have new options for port address, call and pickup groups
504
  * The SIPPEER function have new options for port address, call and pickup groups
492
  * Added support for T.140 realtime text in SIP/RTP
505
  * Added support for T.140 realtime text in SIP/RTP
493
  * The "checkmwi" option has been removed from sip.conf, as it is no longer
506
  * The "checkmwi" option has been removed from sip.conf, as it is no longer
494
     required due to the restructuring of how MWI is handled.  See the descriptions 
507
     required due to the restructuring of how MWI is handled.  See the descriptions 
495
     in this file of the "pollmailboxes" and "pollfreq" options to voicemail.conf 
508
     in this file of the "pollmailboxes" and "pollfreq" options to voicemail.conf 
496
     for more information.
509
     for more information.
497
  * Added rtpdest option to CHANNEL() dialplan function.
510
  * Added rtpdest option to CHANNEL() dialplan function.
498
  * Added SIPREFERRINGCONTEXT and SIPREFERREDBYHDR variables which are set when a transfer takes place.
511
  * Added SIPREFERRINGCONTEXT and SIPREFERREDBYHDR variables which are set when a transfer takes place.
499
  * SIP now adds a header to the CANCEL if the call was answered by another phone
512
  * SIP now adds a header to the CANCEL if the call was answered by another phone
500
     in the same dial command, or if the new c option in dial() is used.
513
     in the same dial command, or if the new c option in dial() is used.
501
  * The new default is that 100 Trying is not sent on REGISTER attempts as the RFC specifically
514
  * The new default is that 100 Trying is not sent on REGISTER attempts as the RFC specifically
502
     states it is not needed. For phones, however, that do require it the "registertrying" option
515
     states it is not needed. For phones, however, that do require it the "registertrying" option
503
     has been added so it can be enabled. 
516
     has been added so it can be enabled. 
504
  * A new option called "callcounter" (global/peer/user level) enables call counters needed
517
  * A new option called "callcounter" (global/peer/user level) enables call counters needed
505
     for better status reports needed for queues and SIP subscriptions. (Call-Limit was previously
518
     for better status reports needed for queues and SIP subscriptions. (Call-Limit was previously
506
     used to enable this functionality).
519
     used to enable this functionality).
507
  * New settings for timer T1 and timer B on a global level or per device. This makes it 
520
  * New settings for timer T1 and timer B on a global level or per device. This makes it 
508
     possible to force timeout faster on non-responsive SIP servers. These settings are
521
     possible to force timeout faster on non-responsive SIP servers. These settings are
509
     considered advanced, so don't use them unless you have a problem.
522
     considered advanced, so don't use them unless you have a problem.
510
  * Added a dial string option to be able to set the To: header in an INVITE to any
523
  * Added a dial string option to be able to set the To: header in an INVITE to any
511
     SIP uri.
524
     SIP uri.
512
  * Added a new global and per-peer option, qualifyfreq, which allows you to configure
525
  * Added a new global and per-peer option, qualifyfreq, which allows you to configure
513
     the qualify frequency.
526
     the qualify frequency.
514
  * Added SIP Session Timers support (RFC 4028).  This prevents stuck SIP sessions that
527
  * Added SIP Session Timers support (RFC 4028).  This prevents stuck SIP sessions that
515
     were not properly torn down due to network or endpoint failures during an established
528
     were not properly torn down due to network or endpoint failures during an established
516
     SIP session.
529
     SIP session.
517
  * Added experimental TCP and TLS support for SIP.  See doc/siptls.txt and 
530
  * Added experimental TCP and TLS support for SIP.  See doc/siptls.txt and 
518
     configs/sip.conf.sample for more information on how it is used.
531
     configs/sip.conf.sample for more information on how it is used.
519
  * Added a new configuration option "authfailureevents" that enables manager events when
532
  * Added a new configuration option "authfailureevents" that enables manager events when
520
    a peer can't authenticate properly. 
533
    a peer can't authenticate properly. 
521
  * Added DNS manager support to registrations for peers not referencing a peer entry.
534
  * Added DNS manager support to registrations for peers not referencing a peer entry.
522

    
   
535

   
523
IAX2 changes
536
IAX2 changes
524
------------
537
------------
525
  * Added the trunkmaxsize configuration option to chan_iax2.
538
  * Added the trunkmaxsize configuration option to chan_iax2.
526
  * Added the srvlookup option to iax.conf
539
  * Added the srvlookup option to iax.conf
527
  * Added support for OSP.  The token is set and retrieved through the CHANNEL()
540
  * Added support for OSP.  The token is set and retrieved through the CHANNEL()
528
     dialplan function.
541
     dialplan function.
529

    
   
542

   
530
XMPP Google Talk/Jingle changes
543
XMPP Google Talk/Jingle changes
531
-------------------------------
544
-------------------------------
532
  * Added the bindaddr option to gtalk.conf.
545
  * Added the bindaddr option to gtalk.conf.
533

    
   
546

   
534
Skinny changes
547
Skinny changes
535
-------------
548
-------------
536
  * Added skinny show device, skinny show line, and skinny show settings CLI commands.
549
  * Added skinny show device, skinny show line, and skinny show settings CLI commands.
537
  * Proper codec support in chan_skinny.
550
  * Proper codec support in chan_skinny.
538
  * Added settings for IP and Ethernet QoS requests
551
  * Added settings for IP and Ethernet QoS requests
539

    
   
552

   
540
MGCP changes
553
MGCP changes
541
------------
554
------------
542
  * Added separate settings for media QoS in mgcp.conf
555
  * Added separate settings for media QoS in mgcp.conf
543

    
   
556

   
544
Console Channel Driver changes
557
Console Channel Driver changes
545
------------------------------
558
------------------------------
546
  * Added experimental support for video send & receive to chan_oss.
559
  * Added experimental support for video send & receive to chan_oss.
547
    This requires SDL and ffmpeg/avcodec, plus Video4Linux or X11 to act as
560
    This requires SDL and ffmpeg/avcodec, plus Video4Linux or X11 to act as
548
    a video source.
561
    a video source.
549

    
   
562

   
550
Phone channel changes (chan_phone)
563
Phone channel changes (chan_phone)
551
----------------------------------
564
----------------------------------
552
  * Added G729 passthrough support to chan_phone for Sigma Designs boards.
565
  * Added G729 passthrough support to chan_phone for Sigma Designs boards.
553

    
   
566

   
554
H.323 channel Changes
567
H.323 channel Changes
555
---------------------
568
---------------------
556
  * H323 remote hold notification support added (by NOTIFY message
569
  * H323 remote hold notification support added (by NOTIFY message
557
     and/or H.450 supplementary service)
570
     and/or H.450 supplementary service)
558

    
   
571

   
559
Local channel changes
572
Local channel changes
560
---------------------
573
---------------------
561
  * The device state functionality in the Local channel driver has been updated
574
  * The device state functionality in the Local channel driver has been updated
562
     to indicate INUSE or NOT_INUSE when a Local channel is being used as opposed
575
     to indicate INUSE or NOT_INUSE when a Local channel is being used as opposed
563
     to just UNKNOWN if the extension exists.
576
     to just UNKNOWN if the extension exists.
564
  * Added jitterbuffer support for chan_local.  This allows you to use the
577
  * Added jitterbuffer support for chan_local.  This allows you to use the
565
     generic jitterbuffer on incoming calls going to Asterisk applications.
578
     generic jitterbuffer on incoming calls going to Asterisk applications.
566
     For example, this would allow you to use a jitterbuffer for an incoming
579
     For example, this would allow you to use a jitterbuffer for an incoming
567
     SIP call to Voicemail by putting a Local channel in the middle.  This
580
     SIP call to Voicemail by putting a Local channel in the middle.  This
568
     feature is enabled by using the 'j' option in the Dial string to the Local
581
     feature is enabled by using the 'j' option in the Dial string to the Local
569
     channel in conjunction with the existing 'n' option for local channels.
582
     channel in conjunction with the existing 'n' option for local channels.
570
  * A 'b' option has been added which causes chan_local to return the actual channel
583
  * A 'b' option has been added which causes chan_local to return the actual channel
571
     that is behind it when queried. This is useful for transfer scenarios as the
584
     that is behind it when queried. This is useful for transfer scenarios as the
572
     actual channel will be transferred, not the Local channel.
585
     actual channel will be transferred, not the Local channel.
573

    
   
586

   
574
Agent channel changes
587
Agent channel changes
575
----------------------
588
----------------------
576
  * The ackcall and endcall options are now supplemented with options acceptdtmf
589
  * The ackcall and endcall options are now supplemented with options acceptdtmf
577
    and enddtmf. These allow for the DTMF keypress to be configurable. The options
590
    and enddtmf. These allow for the DTMF keypress to be configurable. The options
578
    default to their old hard-coded values ('#' and '*' respectively) so this should
591
    default to their old hard-coded values ('#' and '*' respectively) so this should
579
    not break any existing agent installations.
592
    not break any existing agent installations.
580

    
   
593

   
581
DAHDI channel driver (chan_dahdi) Changes
594
DAHDI channel driver (chan_dahdi) Changes
582
----------------------------------------
595
----------------------------------------
583
  * SS7 support (via libss7 library)
596
  * SS7 support (via libss7 library)
584
  * In India, some carriers transmit CID via dtmf. Some code has been added
597
  * In India, some carriers transmit CID via dtmf. Some code has been added
585
     that will handle some situations. The cidstart=polarity_IN choice has been added for
598
     that will handle some situations. The cidstart=polarity_IN choice has been added for
586
     those carriers that transmit CID via dtmf after a polarity change.
599
     those carriers that transmit CID via dtmf after a polarity change.
587
  * CID matching information is now shown when doing 'dialplan show'.
600
  * CID matching information is now shown when doing 'dialplan show'.
588
  * Added dahdi show version CLI command.
601
  * Added dahdi show version CLI command.
589
  * Added setvar support to chan_dahdi.conf channel entries.
602
  * Added setvar support to chan_dahdi.conf channel entries.
590
  * Added two new options: mwimonitor and mwimonitornotify.  These options allow
603
  * Added two new options: mwimonitor and mwimonitornotify.  These options allow
591
     you to enable MWI monitoring on FXO lines.  When the MWI state changes,
604
     you to enable MWI monitoring on FXO lines.  When the MWI state changes,
592
     the script specified in the mwimonitornotify option is executed.  An internal
605
     the script specified in the mwimonitornotify option is executed.  An internal
593
     event indicating the new state of the mailbox is also generated, so that
606
     event indicating the new state of the mailbox is also generated, so that
594
     the normal MWI facilities in Asterisk work as usual.
607
     the normal MWI facilities in Asterisk work as usual.
595
  * Added signalling type 'auto', which attempts to use the same signalling type
608
  * Added signalling type 'auto', which attempts to use the same signalling type
596
     for a channel as configured in DAHDI. This is primarily designed for analog
609
     for a channel as configured in DAHDI. This is primarily designed for analog
597
     ports, but will also work for digital ports that are configured for FXS or FXO
610
     ports, but will also work for digital ports that are configured for FXS or FXO
598
     signalling types. This mode is also the default now, so if your chan_dahdi.conf
611
     signalling types. This mode is also the default now, so if your chan_dahdi.conf
599
     does not specify signalling for a channel (which is unlikely as the sample
612
     does not specify signalling for a channel (which is unlikely as the sample
600
     configuration file has always recommended specifying it for every channel) then
613
     configuration file has always recommended specifying it for every channel) then
601
     the 'auto' mode will be used for that channel if possible.
614
     the 'auto' mode will be used for that channel if possible.
602
  * Added a 'dahdi set dnd' command to allow CLI control of the Do-Not-Disturb
615
  * Added a 'dahdi set dnd' command to allow CLI control of the Do-Not-Disturb
603
     state for a channel; also ensured that the DNDState Manager event is
616
     state for a channel; also ensured that the DNDState Manager event is
604
     emitted no matter how the DND state is set or cleared.
617
     emitted no matter how the DND state is set or cleared.
605

    
   
618

   
606
New Channel Drivers
619
New Channel Drivers
607
-------------------
620
-------------------
608
  * Added a new channel driver, chan_unistim.  See doc/unistim.txt and
621
  * Added a new channel driver, chan_unistim.  See doc/unistim.txt and
609
     configs/unistim.conf.sample for details.  This new channel driver allows
622
     configs/unistim.conf.sample for details.  This new channel driver allows
610
     you to use Nortel i2002, i2004, and i2050 phones with Asterisk.
623
     you to use Nortel i2002, i2004, and i2050 phones with Asterisk.
611
  * Added a new channel driver, chan_console, which uses portaudio as a cross
624
  * Added a new channel driver, chan_console, which uses portaudio as a cross
612
     platform audio interface.  It was written as a channel driver that would
625
     platform audio interface.  It was written as a channel driver that would
613
     work with Mac CoreAudio, but portaudio supports a number of other audio
626
     work with Mac CoreAudio, but portaudio supports a number of other audio
614
     interfaces, as well. Note that this channel driver requires v19 or higher
627
     interfaces, as well. Note that this channel driver requires v19 or higher
615
     of portaudio; older versions have a different API.
628
     of portaudio; older versions have a different API.
616
 
629
 
617
DUNDi changes
630
DUNDi changes
618
-------------
631
-------------
619
  * Added the ability to specify arguments to the Dial application when using
632
  * Added the ability to specify arguments to the Dial application when using
620
     the DUNDi switch in the dialplan.
633
     the DUNDi switch in the dialplan.
621
  * Added the ability to set weights for responses dynamically.  This can be
634
  * Added the ability to set weights for responses dynamically.  This can be
622
     done using a global variable or a dialplan function.  Using the SHELL()
635
     done using a global variable or a dialplan function.  Using the SHELL()
623
     function would allow you to have an external script set the weight for
636
     function would allow you to have an external script set the weight for
624
     each response.
637
     each response.
625
  * Added two new dialplan functions, DUNDIQUERY and DUNDIRESULT.  These
638
  * Added two new dialplan functions, DUNDIQUERY and DUNDIRESULT.  These
626
     functions will allow you to initiate a DUNDi query from the dialplan,
639
     functions will allow you to initiate a DUNDi query from the dialplan,
627
     find out how many results there are, and access each one.
640
     find out how many results there are, and access each one.
628

    
   
641

   
629
ENUM changes
642
ENUM changes
630
------------
643
------------
631
  * Added two new dialplan functions, ENUMQUERY and ENUMRESULT.  These
644
  * Added two new dialplan functions, ENUMQUERY and ENUMRESULT.  These
632
     functions will allow you to initiate an ENUM lookup from the dialplan,
645
     functions will allow you to initiate an ENUM lookup from the dialplan,
633
     and Asterisk will cache the results.  ENUMRESULT can be used to access
646
     and Asterisk will cache the results.  ENUMRESULT can be used to access
634
     the results without doing multiple DNS queries.
647
     the results without doing multiple DNS queries.
635

    
   
648

   
636
Voicemail Changes
649
Voicemail Changes
637
-----------------
650
-----------------
638
  * Added the ability to customize which sound files are used for some of the
651
  * Added the ability to customize which sound files are used for some of the
639
     prompts within the Voicemail application by changing them in voicemail.conf
652
     prompts within the Voicemail application by changing them in voicemail.conf
640
  * Added the ability for the "voicemail show users" CLI command to show users
653
  * Added the ability for the "voicemail show users" CLI command to show users
641
     configured by the dynamic realtime configuration method.
654
     configured by the dynamic realtime configuration method.
642
  * MWI (Message Waiting Indication) handling has been significantly
655
  * MWI (Message Waiting Indication) handling has been significantly
643
     restructured internally to Asterisk.  It is now totally event based
656
     restructured internally to Asterisk.  It is now totally event based
644
     instead of polling based.  The voicemail application will notify other
657
     instead of polling based.  The voicemail application will notify other
645
     modules that have subscribed to MWI events when something in the mailbox
658
     modules that have subscribed to MWI events when something in the mailbox
646
     changes.
659
     changes.
647
    This also means that if any other entity outside of Asterisk is changing
660
    This also means that if any other entity outside of Asterisk is changing
648
     the contents of mailboxes, then the voicemail application still needs to
661
     the contents of mailboxes, then the voicemail application still needs to
649
     poll for changes.  Examples of situations that would require this option
662
     poll for changes.  Examples of situations that would require this option
650
     are web interfaces to voicemail or an email client in the case of using
663
     are web interfaces to voicemail or an email client in the case of using
651
     IMAP storage.  So, two new options have been added to voicemail.conf
664
     IMAP storage.  So, two new options have been added to voicemail.conf
652
     to account for this: "pollmailboxes" and "pollfreq".  See the sample
665
     to account for this: "pollmailboxes" and "pollfreq".  See the sample
653
     configuration file for details.
666
     configuration file for details.
654
  * Added "tw" language support
667
  * Added "tw" language support
655
  * Added support for storage of greetings using an IMAP server
668
  * Added support for storage of greetings using an IMAP server
656
  * Added ability to customize forward, reverse, stop, and pause keys for message playback
669
  * Added ability to customize forward, reverse, stop, and pause keys for message playback
657
  * SMDI is now enabled in voicemail using the smdienable option.
670
  * SMDI is now enabled in voicemail using the smdienable option.
658
  * A "lockmode" option has been added to asterisk.conf to configure the file
671
  * A "lockmode" option has been added to asterisk.conf to configure the file
659
     locking method used for voicemail, and potentially other things in the
672
     locking method used for voicemail, and potentially other things in the
660
     future.  The default is the old behavior, lockfile.  However, there is a
673
     future.  The default is the old behavior, lockfile.  However, there is a
661
     new method, "flock", that uses a different method for situations where the
674
     new method, "flock", that uses a different method for situations where the
662
     lockfile will not work, such as on SMB/CIFS mounts.
675
     lockfile will not work, such as on SMB/CIFS mounts.
663
  * Added the ability to backup deleted messages, to ease recovery in the case
676
  * Added the ability to backup deleted messages, to ease recovery in the case
664
     that a user accidentally deletes a message, and discovers that they need it.
677
     that a user accidentally deletes a message, and discovers that they need it.
665
  * Reworked the SMDI interface in Asterisk.  The new way to access SMDI information
678
  * Reworked the SMDI interface in Asterisk.  The new way to access SMDI information
666
     is through the new functions, SMDI_MSG_RETRIEVE() and SMDI_MSG().  The file
679
     is through the new functions, SMDI_MSG_RETRIEVE() and SMDI_MSG().  The file
667
     smdi.conf can now be configured with options to map SMDI station IDs to Asterisk
680
     smdi.conf can now be configured with options to map SMDI station IDs to Asterisk
668
     voicemail boxes.  The SMDI interface can also poll for MWI changes when some
681
     voicemail boxes.  The SMDI interface can also poll for MWI changes when some
669
     outside entity is modifying the state of the mailbox (such as IMAP storage or
682
     outside entity is modifying the state of the mailbox (such as IMAP storage or
670
     a web interface of some kind).
683
     a web interface of some kind).
671
  * Added the support for marking messages as "urgent." There are two methods to accomplish
684
  * Added the support for marking messages as "urgent." There are two methods to accomplish
672
     this. One is to pass the 'U' option to VoiceMail(). Another way to mark a message as urgent
685
     this. One is to pass the 'U' option to VoiceMail(). Another way to mark a message as urgent
673
     is to specify "review=yes" in voicemail.conf. Doing this will cause allow the user to mark
686
     is to specify "review=yes" in voicemail.conf. Doing this will cause allow the user to mark
674
     the message as urgent after he has recorded a voicemail by following the voice instructions.
687
     the message as urgent after he has recorded a voicemail by following the voice instructions.
675
    When listening to voicemails using VoiceMailMain urgent messages will be presented before other
688
    When listening to voicemails using VoiceMailMain urgent messages will be presented before other
676
     messages
689
     messages
677

    
   
690

   
678
Queue changes
691
Queue changes
679
-------------
692
-------------
680
  * Added the general option 'shared_lastcall' so that member's wrapuptime may be
693
  * Added the general option 'shared_lastcall' so that member's wrapuptime may be
681
     used across multiple queues.
694
     used across multiple queues.
682
  * Added QUEUE_VARIABLES function to set queue variables added setqueuevar and 
695
  * Added QUEUE_VARIABLES function to set queue variables added setqueuevar and 
683
     setqueueentryvar options for each queue, see queues.conf.sample for details.
696
     setqueueentryvar options for each queue, see queues.conf.sample for details.
684
  * Added keepstats option to queues.conf which will keep queue
697
  * Added keepstats option to queues.conf which will keep queue
685
     statistics during a reload.
698
     statistics during a reload.
686
  * setinterfacevar option in queues.conf also now sets a variable
699
  * setinterfacevar option in queues.conf also now sets a variable
687
     called MEMBERNAME which contains the member's name.
700
     called MEMBERNAME which contains the member's name.
688
  * Added 'Strategy' field to manager event QueueParams which represents
701
  * Added 'Strategy' field to manager event QueueParams which represents
689
     the queue strategy in use. 
702
     the queue strategy in use. 
690
  * Added option to run macro when a queue member is connected to a caller, 
703
  * Added option to run macro when a queue member is connected to a caller, 
691
     see queues.conf.sample for details.
704
     see queues.conf.sample for details.
692
  * app_queue now has a 'loose' option which is almost exactly like 'strict' except it
705
  * app_queue now has a 'loose' option which is almost exactly like 'strict' except it
693
     does not count paused queue members as unavailable.
706
     does not count paused queue members as unavailable.
694
  * Added min-announce-frequency option to queues.conf which allows you to control the
707
  * Added min-announce-frequency option to queues.conf which allows you to control the
695
     minimum amount of time between queue announcements for use when the caller's queue
708
     minimum amount of time between queue announcements for use when the caller's queue
696
     position changes frequently.
709
     position changes frequently.
697
  * Added additional information to EXITWITHTIMEOUT and EXITWITHKEY events in the
710
  * Added additional information to EXITWITHTIMEOUT and EXITWITHKEY events in the
698
     queue log.
711
     queue log.
699
  * Added ability for non-realtime queues to have realtime members
712
  * Added ability for non-realtime queues to have realtime members
700
  * Added the "linear" strategy to queues.
713
  * Added the "linear" strategy to queues.
701
  * Added the "wrandom" strategy to queues.
714
  * Added the "wrandom" strategy to queues.
702
  * Added new channel variable QUEUE_MIN_PENALTY
715
  * Added new channel variable QUEUE_MIN_PENALTY
703
  * QUEUE_MAX_PENALTY and QUEUE_MIN_PENALTY may be adjusted in mid-call by defining
716
  * QUEUE_MAX_PENALTY and QUEUE_MIN_PENALTY may be adjusted in mid-call by defining
704
     rules in queuerules.conf. See configs/queuerules.conf.sample for details
717
     rules in queuerules.conf. See configs/queuerules.conf.sample for details
705
  * Added a new parameter for member definition, called state_interface. This may be
718
  * Added a new parameter for member definition, called state_interface. This may be
706
    used so that a member may be called via one interface but have a different interface's
719
    used so that a member may be called via one interface but have a different interface's
707
    device state reported.
720
    device state reported.
708
  * New configuration option: randomperiodicannounce. If a list of periodic announcements is
721
  * New configuration option: randomperiodicannounce. If a list of periodic announcements is
709
    specified by the periodic-announce option, then one will be chosen randomly when it is time
722
    specified by the periodic-announce option, then one will be chosen randomly when it is time
710
    to play a periodic announcment
723
    to play a periodic announcment
711
  * New configuration options: announce-position now takes two more values in addition to "yes" and
724
  * New configuration options: announce-position now takes two more values in addition to "yes" and
712
    "no." Two new options, "limit" and "more," are allowed. These are tied to another option,
725
    "no." Two new options, "limit" and "more," are allowed. These are tied to another option,
713
    announce-position-limit. By setting announce-position to "limit" callers will only have their
726
    announce-position-limit. By setting announce-position to "limit" callers will only have their
714
    position announced if their position is less than what is specified by announce-position-limit.
727
    position announced if their position is less than what is specified by announce-position-limit.
715
    If announce-position is set to "more" then callers beyond the position specified by announce-position-limit
728
    If announce-position is set to "more" then callers beyond the position specified by announce-position-limit
716
    will be told that their are more than announce-position-limit callers waiting.
729
    will be told that their are more than announce-position-limit callers waiting.
717
  * Two new queue log events have been added. An ADDMEMBER event will be logged
730
  * Two new queue log events have been added. An ADDMEMBER event will be logged
718
    when a realtime queue member is added and a REMOVEMEMBER event will be logged
731
    when a realtime queue member is added and a REMOVEMEMBER event will be logged
719
    when a realtime queue member is removed. Since there is no calling channel associated
732
    when a realtime queue member is removed. Since there is no calling channel associated
720
    with these events, the string "REALTIME" is placed where the channel's unique id
733
    with these events, the string "REALTIME" is placed where the channel's unique id
721
    is typically placed.
734
    is typically placed.
722
  * The configuration method for the "joinempty" and "leavewhenempty" options has
735
  * The configuration method for the "joinempty" and "leavewhenempty" options has
723
    changed to a comma-separated list of methods of determining member availability
736
    changed to a comma-separated list of methods of determining member availability
724
	instead of vague terms such as "yes," "loose," "no," and "strict." These old four
737
	instead of vague terms such as "yes," "loose," "no," and "strict." These old four
725
	values are still accepted for backwards-compatibility, though.
738
	values are still accepted for backwards-compatibility, though.
726

    
   
739

   
727
MeetMe Changes
740
MeetMe Changes
728
--------------
741
--------------
729
  * The 'o' option to provide an optimization has been removed and its functionality 
742
  * The 'o' option to provide an optimization has been removed and its functionality 
730
     has been enabled by default.
743
     has been enabled by default.
731
  * When a conference is created, the UNIQUEID of the channel that caused it to be
744
  * When a conference is created, the UNIQUEID of the channel that caused it to be
732
     created is stored.  Then, every channel that joins the conference will have the
745
     created is stored.  Then, every channel that joins the conference will have the
733
     MEETMEUNIQUEID channel variable set with this ID.  This can be used to relate
746
     MEETMEUNIQUEID channel variable set with this ID.  This can be used to relate
734
     callers that come and go from long standing conferences.
747
     callers that come and go from long standing conferences.
735
  * Added a new application, MeetMeChannelAdmin, which is similar to MeetMeAdmin,
748
  * Added a new application, MeetMeChannelAdmin, which is similar to MeetMeAdmin,
736
     except it does operations on a channel by name, instead of number in a conference.
749
     except it does operations on a channel by name, instead of number in a conference.
737
     This is a very useful feature in combination with the 'X' option to ChanSpy.
750
     This is a very useful feature in combination with the 'X' option to ChanSpy.
738
  * Added 'C' option to Meetme which causes a caller to continue in the dialplan
751
  * Added 'C' option to Meetme which causes a caller to continue in the dialplan
739
     when kicked out.
752
     when kicked out.
740
  * Added new RealTime functionality to provide support for scheduled conferencing.
753
  * Added new RealTime functionality to provide support for scheduled conferencing.
741
     This includes optional messages to the caller if they attempt to join before
754
     This includes optional messages to the caller if they attempt to join before
742
     the schedule start time, or to allow the caller to join the conference early.
755
     the schedule start time, or to allow the caller to join the conference early.
743
     Also included is optional support for limiting the number of callers per
756
     Also included is optional support for limiting the number of callers per
744
     RealTime conference.
757
     RealTime conference.
745
  * Added the S() and L() options to the MeetMe application.  These are pretty
758
  * Added the S() and L() options to the MeetMe application.  These are pretty
746
     much identical to the S() and L() options to Dial().  They let you set
759
     much identical to the S() and L() options to Dial().  They let you set
747
     timeouts for the conference, as well as have warning sounds played to
760
     timeouts for the conference, as well as have warning sounds played to
748
     let the caller know how much time is left, and when it is running out.
761
     let the caller know how much time is left, and when it is running out.
749
  * Added the ability to do "meetme concise" with the "meetme" CLI command.
762
  * Added the ability to do "meetme concise" with the "meetme" CLI command.
750
     This extends the concise capabilities of this CLI command to include
763
     This extends the concise capabilities of this CLI command to include
751
     listing all conferences, instead of an addition to the other sub commands
764
     listing all conferences, instead of an addition to the other sub commands
752
     for the "meetme" command.
765
     for the "meetme" command.
753
  * Added the ability to specify the music on hold class used to play into the
766
  * Added the ability to specify the music on hold class used to play into the
754
     conference when there is only one member and the M option is used.
767
     conference when there is only one member and the M option is used.
755
  * Added MEETME_INFO dialplan function which provides a way to query
768
  * Added MEETME_INFO dialplan function which provides a way to query
756
     various properties of a Meetme conference.
769
     various properties of a Meetme conference.
757

    
   
770

   
758
Other Dialplan Application Changes
771
Other Dialplan Application Changes
759
----------------------------------
772
----------------------------------
760
  * Argument support for Gosub application
773
  * Argument support for Gosub application
761
  * From the to-do lists: straighten out the app timeout args:
774
  * From the to-do lists: straighten out the app timeout args:
762
     Wait() app now really does 0.3 seconds- was truncating arg to an int.
775
     Wait() app now really does 0.3 seconds- was truncating arg to an int.
763
     WaitExten() same as Wait().
776
     WaitExten() same as Wait().
764
     Congestion() - Now takes floating pt. argument.
777
     Congestion() - Now takes floating pt. argument.
765
     Busy() - now takes floating pt. argument.
778
     Busy() - now takes floating pt. argument.
766
     Read() - timeout now can be floating pt.
779
     Read() - timeout now can be floating pt.
767
     WaitForRing() now takes floating pt timeout arg.
780
     WaitForRing() now takes floating pt timeout arg.
768
     SpeechBackground() -- clarified in the docstrings that the timeout is an integer seconds.
781
     SpeechBackground() -- clarified in the docstrings that the timeout is an integer seconds.
769
  * Added 's' option to Page application.
782
  * Added 's' option to Page application.
770
  * Added an optional timeout argument to the Page application.
783
  * Added an optional timeout argument to the Page application.
771
  * Added 'E', 'V', and 'P' commands to ExternalIVR.
784
  * Added 'E', 'V', and 'P' commands to ExternalIVR.
772
  * Added 'o' and 'X' options to Chanspy.
785
  * Added 'o' and 'X' options to Chanspy.
773
  * Added a new dialplan application, Bridge, which allows you to bridge the
786
  * Added a new dialplan application, Bridge, which allows you to bridge the
774
     calling channel to any other active channel on the system.
787
     calling channel to any other active channel on the system.
775
  * Added the ability to specify a music on hold class to play instead of ringing
788
  * Added the ability to specify a music on hold class to play instead of ringing
776
     for the SLATrunk application.
789
     for the SLATrunk application.
777
  * The Read application no longer exits the dialplan on error.  Instead, it sets
790
  * The Read application no longer exits the dialplan on error.  Instead, it sets
778
     READSTATUS to ERROR, which you can catch and handle separately.
791
     READSTATUS to ERROR, which you can catch and handle separately.
779
  * Added 'm' option to Directory, which lists out names, 8 at a time, instead
792
  * Added 'm' option to Directory, which lists out names, 8 at a time, instead
780
     of asking for verification of each name, one at a time.
793
     of asking for verification of each name, one at a time.
781
  * Privacy() no longer uses privacy.conf, as all options are specifyable as
794
  * Privacy() no longer uses privacy.conf, as all options are specifyable as
782
     direct options to the app.
795
     direct options to the app.
783
  * AMD() has a new "maximum word length" option. "show application AMD" from the CLI
796
  * AMD() has a new "maximum word length" option. "show application AMD" from the CLI
784
     for more details
797
     for more details
785
  * GotoIfTime() now may branch based on a "false" condition, like other Goto-related applications
798
  * GotoIfTime() now may branch based on a "false" condition, like other Goto-related applications
786
  * The ChannelRedirect application no longer exits the dialplan if the given channel
799
  * The ChannelRedirect application no longer exits the dialplan if the given channel
787
     does not exist. It will now set the CHANNELREDIRECT_STATUS variable to SUCCESS upon success
800
     does not exist. It will now set the CHANNELREDIRECT_STATUS variable to SUCCESS upon success
788
     or NOCHANNEL if the given channel was not found.
801
     or NOCHANNEL if the given channel was not found.
789
  * The silencethreshold setting that was previously configurable in multiple
802
  * The silencethreshold setting that was previously configurable in multiple
790
     applications is now settable globally via dsp.conf.
803
     applications is now settable globally via dsp.conf.
791

    
   
804

   
792
Music On Hold Changes
805
Music On Hold Changes
793
---------------------
806
---------------------
794
  * A new option, "digit", has been added for music on hold classes in 
807
  * A new option, "digit", has been added for music on hold classes in 
795
     musiconhold.conf.  If this is set for a music on hold class, a caller
808
     musiconhold.conf.  If this is set for a music on hold class, a caller
796
     listening to music on hold can press this digit to switch to listening
809
     listening to music on hold can press this digit to switch to listening
797
     to this music on hold class.
810
     to this music on hold class.
798
  * Support for realtime music on hold has been added.
811
  * Support for realtime music on hold has been added.
799
  * In conjunction with the realtime music on hold, a general section has
812
  * In conjunction with the realtime music on hold, a general section has
800
     been added to musiconhold.conf, its sole variable is cachertclasses. If this
813
     been added to musiconhold.conf, its sole variable is cachertclasses. If this
801
     is set, then music on hold classes found in realtime will be cached in memory.
814
     is set, then music on hold classes found in realtime will be cached in memory.
802

    
   
815

   
803
AEL Changes
816
AEL Changes
804
-----------
817
-----------
805
  * AEL upgraded to use the Gosub with Arguments instead
818
  * AEL upgraded to use the Gosub with Arguments instead
806
     of Macro application, to hopefully reduce the problems
819
     of Macro application, to hopefully reduce the problems
807
     seen with the artificially low stack ceiling that 
820
     seen with the artificially low stack ceiling that 
808
     Macro bumps into. Macros can only call other Macros
821
     Macro bumps into. Macros can only call other Macros
809
     to a depth of 7. Tests run using gosub, show depths
822
     to a depth of 7. Tests run using gosub, show depths
810
     limited only by virtual memory. A small test demonstrated
823
     limited only by virtual memory. A small test demonstrated
811
     recursive call depths of 100,000 without problems.
824
     recursive call depths of 100,000 without problems.
812
     -- in addition to this, all apps that allowed a macro
825
     -- in addition to this, all apps that allowed a macro
813
     to be called, as in Dial, queues, etc, are now allowing
826
     to be called, as in Dial, queues, etc, are now allowing
814
     a gosub call in similar fashion.
827
     a gosub call in similar fashion.
815
  * AEL now generates LOCAL(argname) declarations when it
828
  * AEL now generates LOCAL(argname) declarations when it
816
     Set()'s the each arg name to the value of ${ARG1}, ${ARG2),
829
     Set()'s the each arg name to the value of ${ARG1}, ${ARG2),
817
     etc. That makes the arguments local in scope. The user
830
     etc. That makes the arguments local in scope. The user
818
     can define their own local variables in macros, now,
831
     can define their own local variables in macros, now,
819
     by saying "local myvar=someval;"  or using Set() in this
832
     by saying "local myvar=someval;"  or using Set() in this
820
     fashion:  Set(LOCAL(myvar)=someval);  ("local" is now
833
     fashion:  Set(LOCAL(myvar)=someval);  ("local" is now
821
     an AEL keyword).
834
     an AEL keyword).
822
  * utils/conf2ael introduced. Will convert an extensions.conf
835
  * utils/conf2ael introduced. Will convert an extensions.conf
823
     file into extensions.ael. Very crude and unfinished, but 
836
     file into extensions.ael. Very crude and unfinished, but 
824
     will be improved as time goes by. Should be useful for a
837
     will be improved as time goes by. Should be useful for a
825
     first pass at conversion.
838
     first pass at conversion.
826
  * aelparse will now read extensions.conf to see if a referenced
839
  * aelparse will now read extensions.conf to see if a referenced
827
     macro or context is there before issueing a warning.
840
     macro or context is there before issueing a warning.
828
  * AEL parser sets a local channel variable ~~EXTEN~~, to 
841
  * AEL parser sets a local channel variable ~~EXTEN~~, to 
829
    preserve the value of ${EXTEN} thru switch statements.
842
    preserve the value of ${EXTEN} thru switch statements.
830
  * New operator in $[...] expressions: the ~~ operator serves
843
  * New operator in $[...] expressions: the ~~ operator serves
831
    as a concatenation operator. AT THE MOMENT, it is really only
844
    as a concatenation operator. AT THE MOMENT, it is really only
832
    necessary and useful in AEL, especially in if() expressions.
845
    necessary and useful in AEL, especially in if() expressions.
833
    Operation: ${a} ~~ ${b|  with force both a and b to strings, strip 
846
    Operation: ${a} ~~ ${b|  with force both a and b to strings, strip 
834
    any enclosing double-quotes, and evaluate to the value of a
847
    any enclosing double-quotes, and evaluate to the value of a
835
    concatenated with the value of b.  For example if a is set to
848
    concatenated with the value of b.  For example if a is set to
836
    "xyz"  and b has the value "abc", then ${a} ~~ ${b| would
849
    "xyz"  and b has the value "abc", then ${a} ~~ ${b| would
837
    evaluate to xyzabc .
850
    evaluate to xyzabc .
838

    
   
851

   
839

    
   
852

   
840
Call Features (res_features) Changes
853
Call Features (res_features) Changes
841
------------------------------------
854
------------------------------------
842
  * Added the parkedcalltransfers option to features.conf
855
  * Added the parkedcalltransfers option to features.conf
843
  * The built-in method for doing attended transfers has been updated to
856
  * The built-in method for doing attended transfers has been updated to
844
     include some new options that allow you to have the transferee sent
857
     include some new options that allow you to have the transferee sent
845
     back to the person that did the transfer if the transfer is not successful.
858
     back to the person that did the transfer if the transfer is not successful.
846
     See the options "atxferdropcall", "atxferloopdelay", and "atxfercallbackretries"
859
     See the options "atxferdropcall", "atxferloopdelay", and "atxfercallbackretries"
847
     in features.conf.sample.
860
     in features.conf.sample.
848
  * Added support for configuring named groups of custom call features in
861
  * Added support for configuring named groups of custom call features in
849
     features.conf.  This means that features can be written a single time, and
862
     features.conf.  This means that features can be written a single time, and
850
     then mapped into groups of features for different key mappings or easier
863
     then mapped into groups of features for different key mappings or easier
851
     access control.
864
     access control.
852
  * Updated the ParkedCall application to allow you to not specify a parking
865
  * Updated the ParkedCall application to allow you to not specify a parking
853
     extension.  If you don't specify a parking space to pick up, it will grab
866
     extension.  If you don't specify a parking space to pick up, it will grab
854
     the first one available.
867
     the first one available.
855
  * Added cli command 'features reload' to reload call features from features.conf
868
  * Added cli command 'features reload' to reload call features from features.conf
856
  * Moved into core asterisk binary.
869
  * Moved into core asterisk binary.
857
  * Changed the default setting for featuredigittimeout to 2000 ms from 500 ms.
870
  * Changed the default setting for featuredigittimeout to 2000 ms from 500 ms.
858

    
   
871

   
859
Language Support Changes
872
Language Support Changes
860
------------------------
873
------------------------
861
  * Brazilian Portuguese (pt-BR) in VM, and say.c was added
874
  * Brazilian Portuguese (pt-BR) in VM, and say.c was added
862
  * Added support for the Hungarian language for saying numbers, dates, and times.
875
  * Added support for the Hungarian language for saying numbers, dates, and times.
863

    
   
876

   
864
AGI Changes
877
AGI Changes
865
-----------
878
-----------
866
  * Added SPEECH commands for speech recognition. A complete listing can be found
879
  * Added SPEECH commands for speech recognition. A complete listing can be found
867
     using agi show.
880
     using agi show.
868
  * If app_stack is loaded, GOSUB is a native AGI command that may be used to
881
  * If app_stack is loaded, GOSUB is a native AGI command that may be used to
869
    invoke subroutines in the dialplan.  Note that calling EXEC with Gosub
882
    invoke subroutines in the dialplan.  Note that calling EXEC with Gosub
870
    does not behave as expected; the native command needs to be used, instead.
883
    does not behave as expected; the native command needs to be used, instead.
871

    
   
884

   
872
Logger changes
885
Logger changes
873
--------------
886
--------------
874
  * Added rotatestrategy option to logger.conf, along with two new options:
887
  * Added rotatestrategy option to logger.conf, along with two new options:
875
     "timestamp" which will use the time to name the logger files instead of
888
     "timestamp" which will use the time to name the logger files instead of
876
     sequence number; and "rotate", which rotates the names of the logfiles,
889
     sequence number; and "rotate", which rotates the names of the logfiles,
877
     similar to the way syslog rotates files.
890
     similar to the way syslog rotates files.
878
  * Added exec_after_rotate option to logger.conf, which allows a system
891
  * Added exec_after_rotate option to logger.conf, which allows a system
879
     command to be run after rotation.  This is primarily useful with
892
     command to be run after rotation.  This is primarily useful with
880
     rotatestrategry=rotate, to allow a limit on the number of logfiles kept
893
     rotatestrategry=rotate, to allow a limit on the number of logfiles kept
881
     and to ensure that the oldest log file gets deleted.
894
     and to ensure that the oldest log file gets deleted.
882
  * Added realtime support for the queue log
895
  * Added realtime support for the queue log
883

    
   
896

   
884
Call Detail Records 
897
Call Detail Records 
885
-------------------
898
-------------------
886
  * The cdr_manager module has a [mappings] feature, like cdr_custom,
899
  * The cdr_manager module has a [mappings] feature, like cdr_custom,
887
    to add fields to the manager event from the CDR variables.
900
    to add fields to the manager event from the CDR variables.
888
  * Added cdr_adaptive_odbc, a new module that adapts to the structure of your
901
  * Added cdr_adaptive_odbc, a new module that adapts to the structure of your
889
     backend database CDR table.  Specifically, additional, non-standard
902
     backend database CDR table.  Specifically, additional, non-standard
890
     columns are supported, merely by setting the corresponding CDR variable in
903
     columns are supported, merely by setting the corresponding CDR variable in
891
     your dialplan.  In addition, you may alias any column to another name (for
904
     your dialplan.  In addition, you may alias any column to another name (for
892
     example, if you want the 'src' CDR variable to be column 'ANI' in the DB,
905
     example, if you want the 'src' CDR variable to be column 'ANI' in the DB,
893
     simply "alias src => ANI" in the configuration file).  Records may be
906
     simply "alias src => ANI" in the configuration file).  Records may be
894
     posted to more than one backend, simply by specifying multiple categories
907
     posted to more than one backend, simply by specifying multiple categories
895
     in the configuration file.  And finally, you may filter which CDRs get
908
     in the configuration file.  And finally, you may filter which CDRs get
896
     posted to each backend, by specifying a filter (which the record must
909
     posted to each backend, by specifying a filter (which the record must
897
     match) for the particular category.  Filters are additive (meaning all
910
     match) for the particular category.  Filters are additive (meaning all
898
     rules must match to post that CDR).
911
     rules must match to post that CDR).
899
  * The Postgres CDR module now supports some features of the cdr_adaptive_odbc
912
  * The Postgres CDR module now supports some features of the cdr_adaptive_odbc
900
     module.  Specifically, you may add additional columns into the table and
913
     module.  Specifically, you may add additional columns into the table and
901
     they will be set, if you set the corresponding CDR variable name.  Also,
914
     they will be set, if you set the corresponding CDR variable name.  Also,
902
     if you omit columns in your database table, they will be silently skipped
915
     if you omit columns in your database table, they will be silently skipped
903
     (but a record will still be inserted, based on what columns remain).  Note
916
     (but a record will still be inserted, based on what columns remain).  Note
904
     that the other two features from cdr_adaptive_odbc (alias and filter) are
917
     that the other two features from cdr_adaptive_odbc (alias and filter) are
905
     not currently supported.
918
     not currently supported.
906
  * The ResetCDR application now has an 'e' option that re-enables a CDR if it
919
  * The ResetCDR application now has an 'e' option that re-enables a CDR if it
907
     has been disabled using the NoCDR application.
920
     has been disabled using the NoCDR application.
908

    
   
921

   
909
Miscellaneous New Modules
922
Miscellaneous New Modules
910
-------------------------
923
-------------------------
911
  * Added a new CDR module, cdr_sqlite3_custom.
924
  * Added a new CDR module, cdr_sqlite3_custom.
912
  * Added a new realtime configuration module, res_config_sqlite
925
  * Added a new realtime configuration module, res_config_sqlite
913
  * Added a new codec translation module, codec_resample, which re-samples
926
  * Added a new codec translation module, codec_resample, which re-samples
914
     signed linear audio between 8 kHz and 16 kHz to help support wideband
927
     signed linear audio between 8 kHz and 16 kHz to help support wideband
915
     codecs.
928
     codecs.
916
  * Added a new module, res_phoneprov, which allows auto-provisioning of phones
929
  * Added a new module, res_phoneprov, which allows auto-provisioning of phones
917
     based on configuration templates that use Asterisk dialplan function and
930
     based on configuration templates that use Asterisk dialplan function and
918
     variable substitution.  It should be possible to create phone profiles and
931
     variable substitution.  It should be possible to create phone profiles and
919
     templates that work for the majority of phones provisioned over http. It
932
     templates that work for the majority of phones provisioned over http. It
920
     is currently only intended to provision a single user account per phone.
933
     is currently only intended to provision a single user account per phone.
921
     An example profile and set of templates for Polycom phones is provided.
934
     An example profile and set of templates for Polycom phones is provided.
922
     NOTE: Polycom firmware is not included, but should be placed in
935
     NOTE: Polycom firmware is not included, but should be placed in
923
     AST_DATA_DIR/phoneprov/configs to match up with the included templates.
936
     AST_DATA_DIR/phoneprov/configs to match up with the included templates.
924
  * Added a new module, app_jack, which provides interfaces to JACK, the Jack
937
  * Added a new module, app_jack, which provides interfaces to JACK, the Jack
925
     Audio Connection Kit (http://www.jackaudio.org/).  Two interfaces are
938
     Audio Connection Kit (http://www.jackaudio.org/).  Two interfaces are
926
     provided; there is a JACK() application, and a JACK_HOOK() function.  Both
939
     provided; there is a JACK() application, and a JACK_HOOK() function.  Both
927
     interfaces create an input and output JACK port.  The application makes
940
     interfaces create an input and output JACK port.  The application makes
928
     these ports the endpoint of the call.  The audio coming from the channel
941
     these ports the endpoint of the call.  The audio coming from the channel
929
     goes out the output port and whatever comes back in on the input port is
942
     goes out the output port and whatever comes back in on the input port is
930
     what gets sent to the channel.  The JACK_HOOK() function turns on a JACK
943
     what gets sent to the channel.  The JACK_HOOK() function turns on a JACK
931
     audiohook on the channel.  This lets you run the audio coming from a
944
     audiohook on the channel.  This lets you run the audio coming from a
932
     channel through JACK, and whatever comes back in is what gets forwarded
945
     channel through JACK, and whatever comes back in is what gets forwarded
933
     on as the channel's audio.  This is very useful for building custom
946
     on as the channel's audio.  This is very useful for building custom
934
     vocoders or doing recording or analysis of the channel's audio in another
947
     vocoders or doing recording or analysis of the channel's audio in another
935
     application.
948
     application.
936
  * Added a new module, res_config_curl, which permits using a HTTP POST url
949
  * Added a new module, res_config_curl, which permits using a HTTP POST url
937
     to retrieve, create, update, and delete realtime information from a remote
950
     to retrieve, create, update, and delete realtime information from a remote
938
     web server.  Note that this module requires func_curl.so to be loaded for
951
     web server.  Note that this module requires func_curl.so to be loaded for
939
     backend functionality.
952
     backend functionality.
940
  * Added a new module, res_config_ldap, which permits the use of an LDAP
953
  * Added a new module, res_config_ldap, which permits the use of an LDAP
941
     server for realtime data access.
954
     server for realtime data access.
942
  * Added support for writing and running your dialplan in lua using the pbx_lua
955
  * Added support for writing and running your dialplan in lua using the pbx_lua
943
     module.  See configs/extensions.lua.sample for examples of how to do this.
956
     module.  See configs/extensions.lua.sample for examples of how to do this.
944

    
   
957

   
945
Miscellaneous 
958
Miscellaneous 
946
-------------
959
-------------
947
  * Ability to use libcap to set high ToS bits when non-root
960
  * Ability to use libcap to set high ToS bits when non-root
948
     on Linux. If configure is unable to find libcap then you
961
     on Linux. If configure is unable to find libcap then you
949
     can use --with-cap to specify the path.
962
     can use --with-cap to specify the path.
950
  * Added maxfiles option to options section of asterisk.conf which allows you to specify
963
  * Added maxfiles option to options section of asterisk.conf which allows you to specify
951
     what Asterisk should set as the maximum number of open files when it loads.
964
     what Asterisk should set as the maximum number of open files when it loads.
952
  * Added the jittertargetextra configuration option.
965
  * Added the jittertargetextra configuration option.
953
  * Added support for setting the CoS for VLAN traffic (802.1p).  See the sample
966
  * Added support for setting the CoS for VLAN traffic (802.1p).  See the sample
954
     configuration files for the IP channel drivers.  The new option is "cos".
967
     configuration files for the IP channel drivers.  The new option is "cos".
955
     This information is also documented in doc/qos.tex, or the IP Quality of Service
968
     This information is also documented in doc/qos.tex, or the IP Quality of Service
956
     section of asterisk.pdf.
969
     section of asterisk.pdf.
957
  * When originating a call using AMI or pbx_spool that fails the reason for failure
970
  * When originating a call using AMI or pbx_spool that fails the reason for failure
958
     will now be available in the failed extension using the REASON dialplan variable.
971
     will now be available in the failed extension using the REASON dialplan variable.
959
  * Added support for reading the TOUCH_MONITOR_PREFIX channel variable.
972
  * Added support for reading the TOUCH_MONITOR_PREFIX channel variable.
960
     It allows you to configure a prefix for auto-monitor recordings.
973
     It allows you to configure a prefix for auto-monitor recordings.
961
  * A new extension pattern matching algorithm, based on a trie, is introduced
974
  * A new extension pattern matching algorithm, based on a trie, is introduced
962
     here, that could noticeably speed up mid-sized to large dialplans.
975
     here, that could noticeably speed up mid-sized to large dialplans.
963
     It is NOT used by default, as duplicating the behaviour of the old pattern
976
     It is NOT used by default, as duplicating the behaviour of the old pattern
964
     matcher is still under development. A config file option, in extensions.conf,
977
     matcher is still under development. A config file option, in extensions.conf,
965
     in the [general] section, called "extenpatternmatchingnew", is by default
978
     in the [general] section, called "extenpatternmatchingnew", is by default
966
     set to false; setting that to true will force the use of the new algorithm.
979
     set to false; setting that to true will force the use of the new algorithm.
967
     Also, the cli commands "dialplan set extenpatternmatchingnew true/false" can
980
     Also, the cli commands "dialplan set extenpatternmatchingnew true/false" can
968
     be used to switch the algorithms at run time.
981
     be used to switch the algorithms at run time.
969
  * A new option when starting a remote asterisk (rasterisk, asterisk -r) for
982
  * A new option when starting a remote asterisk (rasterisk, asterisk -r) for
970
     specifying which socket to use to connect to the running Asterisk daemon
983
     specifying which socket to use to connect to the running Asterisk daemon
971
     (-s)
984
     (-s)
972
  * Performance enhancements to the sched facility, which is used in
985
  * Performance enhancements to the sched facility, which is used in
973
    the channel drivers, etc. Added hashtabs and doubly-linked lists
986
    the channel drivers, etc. Added hashtabs and doubly-linked lists
974
    to speed up deletion; start at the beginning or end of list to
987
    to speed up deletion; start at the beginning or end of list to
975
    speed up insertion.
988
    speed up insertion.
976
  * Added Doubly-linked lists after the fashion of linkedlists.h. They are in
989
  * Added Doubly-linked lists after the fashion of linkedlists.h. They are in
977
    dlinkedlists.h. Doubly-linked lists feature fast deletion times.
990
    dlinkedlists.h. Doubly-linked lists feature fast deletion times.
978
    Added regression tests to the tests/ dir, also.
991
    Added regression tests to the tests/ dir, also.
979
  * Added a refcount trace feature to astobj2 for those trying to balance
992
  * Added a refcount trace feature to astobj2 for those trying to balance
980
    object creation, deletion; work, play; space and time. See the
993
    object creation, deletion; work, play; space and time. See the
981
    notes in astobj2.h. Also, see utils/refcounter as well, as a
994
    notes in astobj2.h. Also, see utils/refcounter as well, as a
982
    quick way to find unbalanced refcounts in what could be a sea
995
    quick way to find unbalanced refcounts in what could be a sea
983
    of objects that were balanced.
996
    of objects that were balanced.
984
  * Added logging to 'make update' command.  See update.log
997
  * Added logging to 'make update' command.  See update.log
985
  * Added strictrtp option to rtp.conf. If enabled this will drop RTP packets that
998
  * Added strictrtp option to rtp.conf. If enabled this will drop RTP packets that
986
     do not come from the remote party.
999
     do not come from the remote party.
987
  * Added the 'n' option to the SpeechBackground application to tell it to not
1000
  * Added the 'n' option to the SpeechBackground application to tell it to not
988
     answer the channel if it has not already been answered.
1001
     answer the channel if it has not already been answered.
989
  * Added a compiler flag, CHANNEL_TRACE, which permits channel tracing to be
1002
  * Added a compiler flag, CHANNEL_TRACE, which permits channel tracing to be
990
     turned on, via the CHANNEL(trace) dialplan function.  Could be useful for
1003
     turned on, via the CHANNEL(trace) dialplan function.  Could be useful for
991
     dialplan debugging.
1004
     dialplan debugging.
992
  * iLBC source code no longer included (see UPGRADE.txt for details)
1005
  * iLBC source code no longer included (see UPGRADE.txt for details)
993
  * If compiled with DETECT_DEADLOCKS enabled and if you have glibc, then if 
1006
  * If compiled with DETECT_DEADLOCKS enabled and if you have glibc, then if 
994
     deadlock is detected, a backtrace of the stack which led to the lock calls
1007
     deadlock is detected, a backtrace of the stack which led to the lock calls
995
     will be output to the CLI.
1008
     will be output to the CLI.
996
  * If compiled with DEBUG_THREADS enabled and if you have glibc, then issuing
1009
  * If compiled with DEBUG_THREADS enabled and if you have glibc, then issuing
997
     the "core show locks" CLI command will give lock information output as well
1010
     the "core show locks" CLI command will give lock information output as well
998
     as a backtrace of the stack which led to the lock calls.
1011
     as a backtrace of the stack which led to the lock calls.
999
  * users.conf now sports an optional alternateexts property, which permits
1012
  * users.conf now sports an optional alternateexts property, which permits
1000
    allocation of additional extensions which will reach the specified user.
1013
    allocation of additional extensions which will reach the specified user.
1001
  * A new option for the configure script, --enable-internal-poll, has been added
1014
  * A new option for the configure script, --enable-internal-poll, has been added
1002
    for use with systems which may have a buggy implementation of the poll system
1015
    for use with systems which may have a buggy implementation of the poll system
1003
    call. If you notice odd behavior such as the CLI being unresponsive on remote
1016
    call. If you notice odd behavior such as the CLI being unresponsive on remote
1004
    consoles, you may want to try using this option. This option is enabled by default
1017
    consoles, you may want to try using this option. This option is enabled by default
1005
    on Darwin systems since it is known that the Darwin poll() implementation has
1018
    on Darwin systems since it is known that the Darwin poll() implementation has
1006
    odd issues.
1019
    odd issues.
1007

    
   
1020

   
1008
Timer Changes
1021
Timer Changes
1009
--------------------
1022
--------------------
1010
* In addition to timing from DAHDI, there is a new timing module called
1023
* In addition to timing from DAHDI, there is a new timing module called
1011
  res_timing_timerfd. In order to use this, you must be running Linux with
1024
  res_timing_timerfd. In order to use this, you must be running Linux with
1012
  a kernel version 2.6.25 or newer as well as glibc 2.8 or newer. The configure
1025
  a kernel version 2.6.25 or newer as well as glibc 2.8 or newer. The configure
1013
  script will be able to tell if you have the requirements. From menuselect, select
1026
  script will be able to tell if you have the requirements. From menuselect, select
1014
  res_timing_timerfd from the Resource Modules menu.
1027
  res_timing_timerfd from the Resource Modules menu.
/trunk/include/asterisk/ael_structs.h
Revision 166832 New Change
 
/trunk/include/asterisk/pval.h
Revision 166832 New Change
 
/trunk/pbx/ael/ael-test/ref.ael-vtest26
New File
 
/trunk/pbx/ael/ael-test/ael-vtest26/extensions.ael
New File
 
/trunk/res/ael/ael.y
Revision 166863 New Change
 
/trunk/res/ael/ael.flex
Revision 166863 New Change
 
/trunk/res/ael/pval.c
Revision 166863 New Change
 
  1. /trunk/CHANGES: Loading...
  2. /trunk/include/asterisk/ael_structs.h: Loading...
  3. /trunk/include/asterisk/pval.h: Loading...
  4. /trunk/pbx/ael/ael-test/ref.ael-vtest26: Loading...
  5. /trunk/pbx/ael/ael-test/ael-vtest26/extensions.ael: Loading...
  6. /trunk/res/ael/ael.y: Loading...
  7. /trunk/res/ael/ael.flex: Loading...
  8. /trunk/res/ael/pval.c: Loading...

https://reviewboard.asterisk.org/ runs on a server provided by Digium, Inc. and uses bandwidth donated to the open source Asterisk community by API Digital Communications in Huntsville, AL USA.
Please report problems with this site to asteriskteam@digium.com.