XXX content of this file reflects a future release;
    features described here may or may not be available
    in the CVS tree
    

Release notes for SIP Express Router (ser)
***********************************************

$Id$

***********************************************
* Changes introduced in 0.8.11
***********************************************

+--------------------------------------------------------+
| CAUTION: the 0.8.11 release include changes which      |
| are incompatible with scripts and databases used       |
| in previous versions. Care is advised when upgrading   |
| from previous releases to 0.8.11.                      |
+--------------------------------------------------------+

New features
=============
- presence agent [pa module]
- TCP support [core]
- loose routing support [rr module]
- ENUM support [enum module]
- dynamic domain management -- allows to manipulate 
  hosting of multiple domains in run-time 
  [domain module]
- web accounting -- acc module can report to serweb
  on placed calls [acc module]
- improved exec module (header fields passed now
  as environment variables to scripts) [exec module]
- improved tm/FIFO (external applications, such as
  click-to-dial can now better initiate transactions)
  [tm module]
- nathelper utility for Cisco/ATA NAT traversal
- powerpc fast locking support
- netbsd support
- 64 bits arch. support (e.g. netbsd/sparc64).
- tcp2udp and udp2tcp stateless forwarding (see forward_udp & forward_tcp)
- rich access control lists [module permissions]


Changes to use of ser scripts
=============================


core
----
XXX TCP
- reply_route has been renamed to failure_route -- the old name caused
  too much confusion

acc module:
-----------
- radius and sql support integrated in this module; you need to
  recompile to enable it
- acc_flag is now called log_flag to better reflect it relates
  to the syslog mode (as opposed to sql/radius); for the same
  reasons, the accounting action is now called "acc_log_request"
- log_fmt allows now to specify what will be printed to syslog

auth module:
------------
XXX is_in_group has been obsoleted by ...

domain module:
--------------
XXX

enum module:
------------
XXX

exec module:
------------
- exec_uri and exec_user have been obsoleted by exec_dset; 
  exec_dset is identical to exec_uri in capabilities; it 
  additionaly passes content of request elements (header 
  fields and URI parts) in environment variables; users of 
  exec_user can use exec_dset now and use the "URI_USER"  
  variable to learn user part of URI
- exec_dset and exec_msg return false, if return value of 
  script does not euqal zero
- exec_dset takes an additional parameter, which enables 
  validation of SIP URIs returned by external application
  
pa module:
----------
XXX

rr module:
----------
XXX

tm module:
----------
- t_reply_unsafe, used in former versions within reply_routes,
  is deprecated; now t_reply is used from any places in script
- t_on_negative is renamed to t_on_failure -- the old name just
  caused too much confusion
- FIFO t_uac used by some applications (like serweb) has been
  replaced with t_uac_dlg (which allows easier use by dialog-
  oriented applications, like click-to-dial) 
- if you wish to do forward to another destination from 
  failure_route (reply_route formerly), you need to call t_relay
  or t_relay_to explicitely now

List of new modules:
--------------------
- dbtext -- flat-file database
- domain -- automated domain management
- enum -- ENUM support
- nathelper -- utility for NAT traversal for Cisco ATAs
- pa -- presence agent
- permissions -- ACLs
- vm -- voicemail interface

List of deprecated modules:
---------------------------
- im (t_uac_dlg is used for sending messages)
- radius_acc (radius accounting now part of acc module)