Binary compatibility report for the PJSIP library between 1.12 and 1.14 versions on x86

Test Info

Library Name	PJSIP
Version #1	1.12
Version #2	1.14
CPU Type	x86
GCC Version	4.6.1

Test Results

Total Header Files	207
Total Shared Libraries	18
Total Symbols / Types	1713 / 1865
Verdict	Incompatible (3.8%)

Problem Summary

	Severity	Count
Added Symbols	-	7
Removed Symbols	High	0
Problems with Data Types	High	1
	Medium	7
	Low	12
Problems with Symbols	High	0
	Medium	2
	Low	0
Problems with Constants	Low	1
Other Changes in Constants	-	3

Added Symbols (7)

endpoint.h, libpjmedia-i686-pc-linux-gnu.so
pjmedia_endpt_atexit ( pjmedia_endpt* endpt, pjmedia_endpt_exit_callback func )

rtcp.h, libpjmedia-i686-pc-linux-gnu.so
pjmedia_rtcp_build_rtcp_bye ( pjmedia_rtcp_session* session, void* buf, pj_size_t* length, pj_str_t const* reason )
pjmedia_rtcp_build_rtcp_sdes ( pjmedia_rtcp_session* session, void* buf, pj_size_t* length, pjmedia_rtcp_sdes const* sdes )

sip_endpoint.h, libpjsip-i686-pc-linux-gnu.so
pjsip_endpt_atexit ( pjsip_endpoint* endpt, pjsip_endpt_exit_callback func )

sip_regc.h, libpjsip-ua-i686-pc-linux-gnu.so
pjsip_regc_release_transport ( pjsip_regc* regc )

sound_port.h, libpjmedia-i686-pc-linux-gnu.so
pjmedia_snd_port_param_default ( pjmedia_snd_port_param* prm )

ssl_sock.h, libpj-i686-pc-linux-gnu.so
pj_ssl_cipher_is_supported ( pj_ssl_cipher cipher )

to the top

Problems with Data Types, High Severity (1)

	Change	Effect
1	Field server_name has been removed from the middle position of this structural type.	1) Previous accesses of applications to the removed field will be incorrect. 2) Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications.

sip_transport_tls.h
[+] struct pjsip_tls_setting (1)

to the top

Problems with Data Types, Medium Severity (7)

	Change	Effect
1	Size of field tls_setting has been changed from 88 bytes to 80 bytes.	1) Size of the inclusive type has been changed. 2) Previous accesses of applications and library functions to this field and fields at higher positions of the structure definition may be broken.

	Change	Effect
1	Size of field stat has been changed from 256 bytes to 376 bytes.	1) Size of the inclusive type has been changed. 2) Previous accesses of applications and library functions to this field may be broken.

	Change	Effect
1	Size of field endpt has been changed from 8 bytes to 12 bytes.	1) Size of the inclusive type has been changed. 2) Previous accesses of applications and library functions to this field and fields at higher positions of the structure definition may be broken.

	Change	Effect
1	Field auth_retry has been added at the middle position of this structural type.	1) Size of the inclusive type has been changed. 2) Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications.

	Change	Effect
1	Field ciphers_num has been added at the middle position of this structural type.	1) Size of the inclusive type has been changed. 2) Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications.
2	Type of field ciphers has been changed from pj_str_t (8 bytes) to pj_ssl_cipher* (4 bytes).	1) Size of the inclusive type has been changed. 2) Previous accesses of applications and library functions to this field and fields at higher positions of the structure definition may be broken.
3	The pointer level of field ciphers has been increased from 0 to 1.	The library functions may try to access unallocated memory by the dereferencing of old field value and therefore cause a crash of applications.

pjsua.h
[+] struct pjsua_transport_config (1)

rtcp.h
[+] struct pjmedia_rtcp_session (1)

sip_config.h
[+] struct pjsip_cfg_t (1)

sip_transport.h
[+] struct pjsip_tx_data (1)

sip_transport_tls.h
[+] struct pjsip_tls_setting (3)

to the top

Problems with Symbols, Medium Severity (2)

	Change	Effect
1	Size of this global data has been changed from 36 bytes to 40 bytes.	Applications will obtain a different value and execution may change.

	Change	Effect
1	Parameter endpt of type pjmedia_endpt* has been added to the calling stack.	This parameter will not be initialized by old clients.

sip_config.h, libpjsip-i686-pc-linux-gnu.so
[+] pjsip_sip_cfg_var [data] (1)

transport_srtp.h, libpjmedia-i686-pc-linux-gnu.so
[+] pjmedia_srtp_init_lib ( ) (1)

to the top

Problems with Data Types, Low Severity (12)

	Change	Effect
1	Size of this type has been changed from 120 bytes to 112 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Size of this type has been changed from 440 bytes to 560 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field peer_sdes has been added to this type.	1) This field will not be initialized by old clients. 2) Size of the inclusive type has been changed. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
2	Field peer_sdes_buf_ has been added to this type.	1) This field will not be initialized by old clients. 2) Size of the inclusive type has been changed. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
3	Size of this type has been changed from 256 bytes to 376 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Size of this type has been changed from 36 bytes to 40 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field disable_tcp_switch has been added to this type.	1) This field will not be initialized by old clients. 2) Size of the inclusive type has been changed. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
2	Size of this type has been changed from 8 bytes to 12 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Size of this type has been changed from 840 bytes to 844 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Size of this type has been changed from 88 bytes to 80 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field ec_options has been added to this type.	1) This field will not be initialized by old clients. 2) Size of the inclusive type has been changed. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
2	Size of this type has been changed from 88 bytes to 92 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

pjsua.h
[+] struct pjsua_transport_config (1)

rtcp.h
[+] struct pjmedia_rtcp_session (1)
[+] struct pjmedia_rtcp_stat (3)

sip_config.h
[+] struct pjsip_cfg_t (1)
[+] struct pjsip_cfg_t::anon-struct-sip_config.h-72 (2)

sip_transport.h
[+] struct pjsip_tx_data (1)

sip_transport_tls.h
[+] struct pjsip_tls_setting (1)

sound_port.h
[+] struct pjmedia_snd_port_param (2)

to the top

Problems with Constants, Low Severity (1)

	Change	Effect
1	The value of constant PJSIP_TRANSPORT_IDLE_TIME has been changed from 600 to 33.	Applications will pass an old value of this constant as the parameter to the new-version library functions, that expect a new one. This may result in crash of incorrect behavior of applications.

sip_config.h
[+] PJSIP_TRANSPORT_IDLE_TIME

to the top

Other Changes in Constants (3)

	Change	Effect
1	The constant PJMEDIA_RTCP_NORMALIZE_FACTOR with value 3 has been added.	No effect.

	Change	Effect
1	The constant PJMEDIA_RTCP_RX_SDES_BUF_LEN with value 64 has been added.	No effect.

	Change	Effect
1	The constant PJSIP_TRANSPORT_SERVER_IDLE_TIME with value 600 has been added.	No effect.

config.h
[+] PJMEDIA_RTCP_NORMALIZE_FACTOR
[+] PJMEDIA_RTCP_RX_SDES_BUF_LEN

sip_config.h
[+] PJSIP_TRANSPORT_SERVER_IDLE_TIME

to the top

Header Files (207)

activesock.h
addr_resolv.h
alaw_ulaw.h
amr_helper.h
array.h
assert.h
audiodev.h
audiodev_imp.h
audiotest.h
base64.h
bidirectional.h
circbuf.h
clock.h
codec.h
conference.h
config_site.h
config_site_sample.h
crc32.h
ctype.h
delaybuf.h
dns.h
dns_server.h
echo.h
echo_port.h
endpoint.h
evsub.h
evsub_msg.h
except.h
fifobuf.h
file.hpp
file_access.h
file_io.h
g711.h
g722.h
g7221.h
getopt.h
gsm.h
guid.h
hash.h
hash.hpp
hmac_md5.h
hmac_sha1.h
http_client.h
ice_session.h
ice_strans.h
ilbc.h
ioqueue.h
ip_helper.h
ipp_codecs.h
iscomposing.h
jbuf.h
l16.h
list.h
list.hpp
list_i.h
lock.h
lock.hpp
log.h
master_port.h
math.h
md5.h
mem_port.h
mwi.h
nat_detect.h
null_port.h
opencore_amrnb.h
os.h
os.hpp
passthrough.h
pcap.h
pidf.h
config.h (pj/config.h)
doxygen.h (pj/doxygen.h)
errno.h (pj/errno.h)
string.h (pj/string.h)
types.h (pj/types.h)
pjlib++.hpp
pjlib-util.h
config.h (pjlib-util/config.h)
errno.h (pjlib-util/errno.h)
string.h (pjlib-util/string.h)
types.h (pjlib-util/types.h)
pjlib.h
config.h (pjmedia-audiodev/config.h)
errno.h (pjmedia-audiodev/errno.h)
pjmedia-codec.h
config.h (pjmedia-codec/config.h)
config_auto.h (pjmedia-codec/config_auto.h)
types.h (pjmedia-codec/types.h)
pjmedia.h
config.h (pjmedia/config.h)
config_auto.h (pjmedia/config_auto.h)
doxygen.h (pjmedia/doxygen.h)
errno.h (pjmedia/errno.h)
types.h (pjmedia/types.h)
pjmedia_audiodev.h
pjnath.h
config.h (pjnath/config.h)
errno.h (pjnath/errno.h)
types.h (pjnath/types.h)
errno.h (pjsip-simple/errno.h)
types.h (pjsip-simple/types.h)
pjsip.h
pjsip_simple.h
pjsip_ua.h
pjsua.h (pjsua-lib/pjsua.h)
pjsua.h
pjsua_internal.h
plc.h
pool.h
pool.hpp
port.h
presence.h
print_util.h
proactor.hpp
publish.h
rand.h
rbtree.h
resample.h
resolver.h
rpid.h
rtcp.h
rtcp_xr.h
rtp.h
scanner.h
scanner.hpp
scanner_cis_bitwise.h
scanner_cis_uint.h
sdp.h
sdp_neg.h
session.h
sha1.h
silencedet.h
sip_100rel.h
sip_auth.h
sip_auth_aka.h
sip_auth_msg.h
sip_auth_parser.h
sip_autoconf.h
sip_config.h
sip_dialog.h
sip_endpoint.h
sip_errno.h
sip_event.h
sip_inv.h
sip_module.h
sip_msg.h
sip_multipart.h
sip_parser.h
sip_private.h
sip_regc.h
sip_replaces.h
sip_resolve.h
sip_tel_uri.h
sip_timer.h
sip_transaction.h
sip_transport.h
sip_transport_loop.h
sip_transport_tcp.h
sip_transport_tls.h
sip_transport_udp.h
sip_types.h
sip_ua_layer.h
sip_uri.h
sip_util.h
sip_xfer.h
sock.h
sock.hpp
sock_qos.h
sock_select.h
sound.h
sound_port.h
speex.h
splitcomb.h
srv_resolver.h
ssl_sock.h
stereo.h
stream.h
string.hpp
string_i.h
stun_auth.h
stun_config.h
stun_msg.h
stun_session.h
stun_simple.h
stun_sock.h
stun_transaction.h
timer.h
timer.hpp
tonegen.h
transport.h
transport_adapter_sample.h
transport_ice.h
transport_loop.h
transport_srtp.h
transport_udp.h
tree.hpp
turn_session.h
turn_sock.h
types.hpp
unicode.h
wav_playlist.h
wav_port.h
wave.h
wsola.h
xml.h
xpidf.h

to the top

Shared Libraries (18)

libg7221codec-i686-pc-linux-gnu.so
libgsmcodec-i686-pc-linux-gnu.so
libilbccodec-i686-pc-linux-gnu.so
libmilenage-i686-pc-linux-gnu.so
libpj-i686-pc-linux-gnu.so
libpjlib-util-i686-pc-linux-gnu.so
libpjmedia-audiodev-i686-pc-linux-gnu.so
libpjmedia-codec-i686-pc-linux-gnu.so
libpjmedia-i686-pc-linux-gnu.so
libpjnath-i686-pc-linux-gnu.so
libpjsip-i686-pc-linux-gnu.so
libpjsip-simple-i686-pc-linux-gnu.so
libpjsip-ua-i686-pc-linux-gnu.so
libpjsua-i686-pc-linux-gnu.so
libportaudio-i686-pc-linux-gnu.so
libresample-i686-pc-linux-gnu.so
libspeex-i686-pc-linux-gnu.so
libsrtp-i686-pc-linux-gnu.so

to the top