RELEASE 4.07 KB
Newer Older
1 2 3
==============================================
Release notes for current version of Sofia-SIP
==============================================
Pekka Pessi's avatar
Pekka Pessi committed
4

5 6
Changes since last release
--------------------------
Pekka Pessi's avatar
Pekka Pessi committed
7

8 9
<changes since last written in freshmeat.net "Changes:" style;
 and in less than 10 lines />
Pekka Pessi's avatar
Pekka Pessi committed
10

11 12
Bugs in blaa and foo have been fixed. The stack now supports
use of foobar...
Pekka Pessi's avatar
Pekka Pessi committed
13

Pekka Pessi's avatar
Pekka Pessi committed
14 15 16
API/ABI changes and versioning
------------------------------

17 18 19 20 21 22 23 24
<see previous release notes at
 http://sofia-sip.sourceforge.net/relnotes/ for examples ;
 - should include all changes to public headers, and 
   other important information to developers; 
 - and should be updated _continuously_! />

**template**: New features in API are marked with Doxytag macro @VERSION_1_XX_X.

25
libsofia-sip-ua:
26
- **template**: Added foobar() function (sofia-sip/foobar.h).
Pekka Pessi's avatar
Pekka Pessi committed
27 28 29 30
- Added sip_is_allowed() function and k_bitmap field to the 
  sip_allow_t structure 
- Added SIP header Refer-Sub and related functions
- Added <sofia-sip/sip_extra.h> include file
Pekka Pessi's avatar
Pekka Pessi committed
31
- Added auc_info() function (sofia-sip/auth_client.h)
32 33 34 35 36
- Added alternative implementations to event reactor object (su_port_t,
  referenced by su_root_t) that can be changed at runtime
  - Internal semantics of su_port_t reference counting have changed:
    now su_port_create() has one reference, and su_root_create_with_port()
    uses it reference
37
- This release is ABI/API compatible with applications linked against 
38 39 40
  any 1.12.x release. However, applications built against this release won't 
  work against an older library. The ABI has been tested with the nua module 
  unit test (test_nua) built against original 1.12.0 release.
41

42
libsofia-sip-ua-glib:
43 44 45 46 47 48
- The 'nua-glib' module has been removed from the library and moved
  to a separate package 'sofia-nua-glib'. The remaining library (su-glib) 
  is now considered stable and will be API/ABI compatible with later 
  releases in the 1.12.x series.
- ABI has been modified and applications built against 1.12.4 and earlier 
  releases need to be rebuilt.
49

Pekka Pessi's avatar
Pekka Pessi committed
50 51 52
Contributors to this release
----------------------------

53 54 55 56 57 58 59 60 61
<list of people who contributed to _this_ release
 - update as people's patches are added, or when you commit stuff
 - current development team members (see AUTHORS) may be omitted
 - name of the contributor should be enough (email addresses in AUTHORS),
   plus a brief description of what was contributed
 - roughly sorted by number of patches accepted
/> 

- **template**: First Surname (patch to nua/soa/msg)
62
- Petteri Puolakka (patch to stun)
63
- Mikhail Zabluev (patch to su-glib mainloop integration)
64
- Roman Filonenko (patch to query DNS-servers with IP-Helper on win32)
Pekka Pessi's avatar
Pekka Pessi committed
65

66
See the AUTHORS file in the distribution package.
67

68 69 70
Notes on new features
---------------------

Pekka Pessi's avatar
Pekka Pessi committed
71 72 73 74 75 76 77 78 79 80
RFC 4488 defines the Refer-Sub header. Its datatypes, related functions and
methods declared in <sofia-sip/sip_extra.h> include file. The Refer-Sub
header structure can be accessed from sip_t structure with sip_refer_sub()
method, e.g.,

  if (sip_refer_sub(sip) && 
      strcasecmp("false", sip_refer_sub(sip)->rs_value) == 0) {
     /* Do not create implicit subscription */ 
  }

81 82 83 84 85
<information about major new features
 - new/changed/removed functionality
 - links to further documentation
 - section may be omitted for minor releases
/> 
86 87 88 89

Bugs fixed in this release
--------------------------

90 91 92 93 94 95 96
< notable bugs fixed in this release
 - check the sf.net bug tracker; see closed bugs,
   sorted by closing date
 - other bugs as fixed in CVS/darcs
/>

- **template**: #9499652 sf.net bug item title
Pekka Pessi's avatar
Pekka Pessi committed
97 98 99

- Fixed crash when nua_bye() was called while a NOTIFY client transaction
  was in progress. Problem reported by Anthony Minnessale.
Pekka Pessi's avatar
Pekka Pessi committed
100 101
- Not using close() with sockets in sres.c. Problem reported by
  Roman Filonenko.
102 103
- Bug in zero-padding STUN messages with a message integrity 
  attribute. Patch by Petteri Puolakka.
104 105 106 107 108
- Fixed a severe problem with timer accuracy, when sofia-sip timers 
  where used under glib's mainloop.
- Improved glib mainloop integration to avoid warnings about already
  active mainloop context, and potentially other issue. Patch by 
  Mikhail Zabaluev. Closes sf.net item #1606786.