Binary compatibility report for the opus library between 0.9.6 and 0.9.7 versions on x86

Test Info

Library Name	opus
Version #1	0.9.6
Version #2	0.9.7
CPU Type	x86
GCC Version	4.6.1

Test Results

Total Header Files	1
Total Shared Libraries	1
Total Symbols / Types	28 / 28
Verdict	Incompatible (16.1%)

Problem Summary

	Severity	Count
Added Symbols	-	18
Removed Symbols	High	2
Problems with Data Types	High	0
	Medium	0
	Low	0
Problems with Symbols	High	0
	Medium	6
	Low	11
Problems with Constants	Low	34
Other Changes in Constants	-	21

Added Symbols (18)

opus.h, libopus.so.0.0.0
opus_decode_float ( OpusDecoder* st, unsigned char const* data, int len, float* pcm, int frame_size, int decode_fec )
opus_decoder_get_size ( int channels )
opus_encode_float ( OpusEncoder* st, float const* pcm, int frame_size, unsigned char* data, int max_data_bytes )
opus_encoder_get_size ( int channels )

opus_multistream.h, libopus.so.0.0.0
opus_multistream_decode ( OpusMSDecoder* st, unsigned char const* data, int len, opus_int16* pcm, int frame_size, int decode_fec )
opus_multistream_decode_float ( OpusMSDecoder* st, unsigned char const* data, int len, float* pcm, int frame_size, int decode_fec )
opus_multistream_decoder_create ( opus_int32 Fs, int channels, int streams, int coupled_streams, unsigned char* mapping, int* error )
opus_multistream_decoder_ctl ( OpusMSDecoder* st, int request, ... )
opus_multistream_decoder_destroy ( OpusMSDecoder* st )
opus_multistream_decoder_get_size ( int streams, int coupled_streams )
opus_multistream_decoder_init ( OpusMSDecoder* st, opus_int32 Fs, int channels, int streams, int coupled_streams, unsigned char* mapping )
opus_multistream_encode ( OpusMSEncoder* st, opus_int16 const* pcm, int frame_size, unsigned char* data, int max_data_bytes )
opus_multistream_encode_float ( OpusMSEncoder* st, float const* pcm, int frame_size, unsigned char* data, int max_data_bytes )
opus_multistream_encoder_create ( opus_int32 Fs, int channels, int streams, int coupled_streams, unsigned char* mapping, int application, int* error )
opus_multistream_encoder_ctl ( OpusMSEncoder* st, int request, ... )
opus_multistream_encoder_destroy ( OpusMSEncoder* st )
opus_multistream_encoder_get_size ( int streams, int coupled_streams )
opus_multistream_encoder_init ( OpusMSEncoder* st, opus_int32 Fs, int channels, int streams, int coupled_streams, unsigned char* mapping, int application )

to the top

Removed Symbols (2)

opus.h, libopus.so.0.0.0
opus_decoder_get_final_range ( OpusDecoder* st )
opus_encoder_get_final_range ( OpusEncoder* st )

to the top

Problems with Symbols, Medium Severity (6)

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

	Change	Effect
1	The pointer level of return value has been decreased from 1 to 0.	Applications may try to access unallocated memory by the dereferencing of new return value and therefore cause a crash.

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

	Change	Effect
1	The pointer level of return value has been decreased from 1 to 0.	Applications may try to access unallocated memory by the dereferencing of new return value and therefore cause a crash.

	Change	Effect
1	The pointer level of 6th parameter payload has been decreased from 2 to 1.	The library function will treat the parameter as the lower-dimension array and will not read all elements. This may change the behavior of applications. NOTE: if this is out-parameter then this change may cause a crash of applications.
2	Type of 6th parameter payload has been changed from unsigned char const** to int* (became non-const).	This function may change parameter payload, but it will be treated as const by old client applications. This may result in crash or incorrect behavior of applications.

opus.h, libopus.so.0.0.0
[+] opus_decoder_create ( int Fs, int channels ) (1)
[+] opus_decoder_init ( OpusDecoder* st, int Fs, int channels ) (1)
[+] opus_encoder_create ( int Fs, int channels, int application ) (1)
[+] opus_encoder_init ( OpusEncoder* st, int Fs, int channels, int application ) (1)
[+] opus_packet_parse ( unsigned char const* data, int len, unsigned char* out_toc, unsigned char const** frames, short* size, unsigned char const** payload ) (2)

to the top

Problems with Symbols, Low Severity (11)

	Change	Effect
1	Type of 1st parameter Fs has been changed from int to opus_int32.	Replacement of parameter data type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 2nd parameter Fs has been changed from int to opus_int32.	Replacement of parameter data type may indicate a change in its semantic meaning.
2	Type of return value has been changed from OpusDecoder* to int.	Replacement of return type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 1st parameter Fs has been changed from int to opus_int32.	Replacement of parameter data type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 2nd parameter Fs has been changed from int to opus_int32.	Replacement of parameter data type may indicate a change in its semantic meaning.
2	Type of return value has been changed from OpusEncoder* to int.	Replacement of return type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 2nd parameter Fs has been changed from int to opus_int32.	Replacement of parameter data type may indicate a change in its semantic meaning.

	Change	Effect
1	6th parameter payload has been renamed to payload_offset.	Renaming of a parameter may indicate a change in its semantic meaning.
2	Type of 6th parameter payload has been changed from unsigned char const** to int*.	Replacement of parameter data type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of return value has been changed from int to opus_int32.	Replacement of return type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of return value has been changed from int to opus_int32.	Replacement of return type may indicate a change in its semantic meaning.

opus.h, libopus.so.0.0.0
[+] opus_decoder_create ( int Fs, int channels ) (1)
[+] opus_decoder_init ( OpusDecoder* st, int Fs, int channels ) (2)
[+] opus_encoder_create ( int Fs, int channels, int application ) (1)
[+] opus_encoder_init ( OpusEncoder* st, int Fs, int channels, int application ) (2)
[+] opus_packet_get_samples_per_frame ( unsigned char const* data, int Fs ) (1)
[+] opus_packet_parse ( unsigned char const* data, int len, unsigned char* out_toc, unsigned char const** frames, short* size, unsigned char const** payload ) (2)
[+] opus_repacketizer_out ( OpusRepacketizer* rp, unsigned char* data, int maxlen ) (1)
[+] opus_repacketizer_out_range ( OpusRepacketizer* rp, int begin, int end, unsigned char* data, int maxlen ) (1)

to the top

Problems with Constants, Low Severity (34)

	Change	Effect
1	The constant MODE_CELT_ONLY with value 1002 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant MODE_HYBRID with value 1001 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant MODE_SILK_ONLY with value 1000 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The value of constant OPUS_APPLICATION_AUDIO has been changed from 2001 to 2049.	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.

	Change	Effect
1	The value of constant OPUS_APPLICATION_VOIP has been changed from 2000 to 2048.	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.

	Change	Effect
1	The constant OPUS_BANDWIDTH_AUTO with value 1100 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant OPUS_BITRATE_AUTO with value -1 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant OPUS_CORRUPTED_DATA with value -4 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The value of constant OPUS_GET_BANDWIDTH_REQUEST has been changed from 9 to 4009.	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.

	Change	Effect
1	The value of constant OPUS_GET_BITRATE_REQUEST has been changed from 3 to 4003.	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.

	Change	Effect
1	The value of constant OPUS_GET_COMPLEXITY_REQUEST has been changed from 11 to 4011.	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.

	Change	Effect
1	The constant OPUS_GET_DTX_FLAG_REQUEST with value 17 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant OPUS_GET_FORCE_MONO_REQUEST with value 23 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant OPUS_GET_INBAND_FEC_FLAG_REQUEST with value 13 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The value of constant OPUS_GET_LOOKAHEAD_REQUEST has been changed from 27 to 4027.	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.

	Change	Effect
1	The constant OPUS_GET_MODE_REQUEST with value 1 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The value of constant OPUS_GET_PACKET_LOSS_PERC_REQUEST has been changed from 15 to 4015.	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.

	Change	Effect
1	The value of constant OPUS_GET_SIGNAL_REQUEST has been changed from 25 to 4025.	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.

	Change	Effect
1	The value of constant OPUS_GET_VBR_CONSTRAINT_REQUEST has been changed from 21 to 4021.	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.

	Change	Effect
1	The constant OPUS_GET_VBR_FLAG_REQUEST with value 7 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant OPUS_GET_VOICE_RATIO_REQUEST with value 19 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The value of constant OPUS_SET_BANDWIDTH_REQUEST has been changed from 8 to 4008.	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.

	Change	Effect
1	The value of constant OPUS_SET_BITRATE_REQUEST has been changed from 2 to 4002.	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.

	Change	Effect
1	The value of constant OPUS_SET_COMPLEXITY_REQUEST has been changed from 10 to 4010.	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.

	Change	Effect
1	The constant OPUS_SET_DTX_FLAG_REQUEST with value 16 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant OPUS_SET_FORCE_MONO_REQUEST with value 22 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant OPUS_SET_INBAND_FEC_FLAG_REQUEST with value 12 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant OPUS_SET_MODE_REQUEST with value 0 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The value of constant OPUS_SET_PACKET_LOSS_PERC_REQUEST has been changed from 14 to 4014.	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.

	Change	Effect
1	The value of constant OPUS_SET_SIGNAL_REQUEST has been changed from 24 to 4024.	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.

	Change	Effect
1	The value of constant OPUS_SET_VBR_CONSTRAINT_REQUEST has been changed from 20 to 4020.	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.

	Change	Effect
1	The constant OPUS_SET_VBR_FLAG_REQUEST with value 6 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant OPUS_SET_VOICE_RATIO_REQUEST with value 18 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant OPUS_SIGNAL_AUTO with value 3000 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

opus.h
[+] MODE_CELT_ONLY
[+] MODE_HYBRID
[+] MODE_SILK_ONLY
[+] OPUS_APPLICATION_AUDIO
[+] OPUS_APPLICATION_VOIP
[+] OPUS_BANDWIDTH_AUTO
[+] OPUS_BITRATE_AUTO
[+] OPUS_CORRUPTED_DATA
[+] OPUS_GET_BANDWIDTH_REQUEST
[+] OPUS_GET_BITRATE_REQUEST
[+] OPUS_GET_COMPLEXITY_REQUEST
[+] OPUS_GET_DTX_FLAG_REQUEST
[+] OPUS_GET_FORCE_MONO_REQUEST
[+] OPUS_GET_INBAND_FEC_FLAG_REQUEST
[+] OPUS_GET_LOOKAHEAD_REQUEST
[+] OPUS_GET_MODE_REQUEST
[+] OPUS_GET_PACKET_LOSS_PERC_REQUEST
[+] OPUS_GET_SIGNAL_REQUEST
[+] OPUS_GET_VBR_CONSTRAINT_REQUEST
[+] OPUS_GET_VBR_FLAG_REQUEST
[+] OPUS_GET_VOICE_RATIO_REQUEST
[+] OPUS_SET_BANDWIDTH_REQUEST
[+] OPUS_SET_BITRATE_REQUEST
[+] OPUS_SET_COMPLEXITY_REQUEST
[+] OPUS_SET_DTX_FLAG_REQUEST
[+] OPUS_SET_FORCE_MONO_REQUEST
[+] OPUS_SET_INBAND_FEC_FLAG_REQUEST
[+] OPUS_SET_MODE_REQUEST
[+] OPUS_SET_PACKET_LOSS_PERC_REQUEST
[+] OPUS_SET_SIGNAL_REQUEST
[+] OPUS_SET_VBR_CONSTRAINT_REQUEST
[+] OPUS_SET_VBR_FLAG_REQUEST
[+] OPUS_SET_VOICE_RATIO_REQUEST
[+] OPUS_SIGNAL_AUTO

to the top

Other Changes in Constants (21)

opus_defines.h
[+] OPUS_APPLICATION_RESTRICTED_LOWDELAY
[+] OPUS_AUTO
[+] OPUS_BITRATE_MAX
[+] OPUS_GET_APPLICATION_REQUEST
[+] OPUS_GET_DTX_REQUEST
[+] OPUS_GET_FINAL_RANGE_REQUEST
[+] OPUS_GET_FORCE_CHANNELS_REQUEST
[+] OPUS_GET_INBAND_FEC_REQUEST
[+] OPUS_GET_MAX_BANDWIDTH_REQUEST
[+] OPUS_GET_PITCH_REQUEST
[+] OPUS_GET_VBR_REQUEST
[+] OPUS_INVALID_PACKET
[+] OPUS_RESET_STATE
[+] OPUS_SET_APPLICATION_REQUEST
[+] OPUS_SET_DTX_REQUEST
[+] OPUS_SET_FORCE_CHANNELS_REQUEST
[+] OPUS_SET_INBAND_FEC_REQUEST
[+] OPUS_SET_MAX_BANDWIDTH_REQUEST
[+] OPUS_SET_VBR_REQUEST

opus_multistream.h
[+] OPUS_MULTISTREAM_GET_DECODER_STATE_REQUEST
[+] OPUS_MULTISTREAM_GET_ENCODER_STATE_REQUEST

to the top

Header Files (1)

opus.h

to the top

Shared Libraries (1)

libopus.so.0.0.0

to the top