Binary compatibility report for the MAD library between 0.11.0b and 0.12.0a versions on x86

Test Info

Library Name	MAD
Version #1	0.11.0b
Version #2	0.12.0a
CPU Architecture	x86
GCC Version	4.5

Test Results

Total Header Files	17
Total Shared Libraries	1
Total Symbols / Types	34 / 45
Verdict	Incompatible (58.82%)

Problem Summary

	Severity	Count
Added Symbols	-	10
Removed Symbols	High	8
Problems with Data Types	High	2
	Medium	11
	Low	21
Problems with Symbols	High	3
	Medium	11
	Low	3
Problems with Constants	Low	1

Added Symbols (10)

mad.h, libmad-0.12.0a.so
mad_build [data]
mad_decoder_message ( mad_decoder* p1, void* p2, unsigned int* p3 )
mad_f_abs ( int p1 )
mad_timer_abs ( mad_timer_t p1 )
mad_timer_compare ( mad_timer_t p1, mad_timer_t p2 )
mad_timer_fraction ( mad_timer_t p1, unsigned long p2 )
mad_timer_negate ( mad_timer_t* p1 )
mad_timer_set ( mad_timer_t* p1, unsigned long p2, unsigned long p3, unsigned long p4 )
mad_timer_string ( mad_timer_t p1, char* p2, char const* p3, mad_units p4, mad_units p5, unsigned long p6 )
mad_timer_zero [data]

to the top

Removed Symbols (8)

libmad.h, libmad.so
mad_bit_write ( mad_bitptr* p1, unsigned int p2, unsigned long p3 )
mad_decoder_command ( mad_decoder* p1, mad_control* p2 )
mad_decoder_error ( mad_decoder* p1, int(*p2)(void*, mad_stream*, mad_frame*), void* p3 )
mad_decoder_filter ( mad_decoder* p1, int(*p2)(void*, mad_frame*), void* p3 )
mad_decoder_input ( mad_decoder* p1, int(*p2)(void*, mad_stream*), void* p3 )
mad_decoder_output ( mad_decoder* p1, int(*p2)(void*, mad_frame const*, mad_synth const*), void* p3 )
mad_timer_init ( mad_timer* p1 )
mad_timer_str ( mad_timer const* p1, char* p2, char const* p3, int p4 )

to the top

Problems with Data Types, High Severity (2)

	Change	Effect
1	Field filter_data 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.
2	Field input_data 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.

libmad.h
[+] struct mad_decoder (2)

to the top

Problems with Symbols, High Severity (3)

	Change	Effect
1	1st parameter p1 has been added to the calling stack at the middle position.	Layout of parameter's stack has been changed and therefore parameters at higher positions in the stack may be incorrectly initialized by applications.
2	Middle parameter p1 of type unsigned char const* has been removed from the calling stack.	Layout of parameter's stack has been changed and therefore parameters at higher positions in the stack may be incorrectly initialized by applications.

	Change	Effect
1	Type of 2nd parameter p2 has been changed from mad_timer const* (4 bytes) to mad_timer_t (8 bytes).	Layout of parameter's stack has been changed and therefore parameters at higher positions in the stack may be incorrectly initialized by applications.

libmad.h, libmad.so
[+] mad_stream_sync ( unsigned char const* p1, unsigned char const* p2 ) (2)
[+] mad_timer_add ( mad_timer* p1, mad_timer const* p2 ) (1)

to the top

Problems with Data Types, Medium Severity (11)

	Change	Effect
1	Size of field frame has been changed from 9260 bytes to 9268 bytes.	1) Size of the inclusive type has changed. 2) Previous accesses of applications and library functions to this field and fields at higher positions of the structure definition may be broken.
2	Size of field synth has been changed from 13316 bytes to 13320 bytes.	1) Size of the inclusive type has changed. 2) Previous accesses of applications and library functions to this field may be broken.

	Change	Effect
1	Field cb_data 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	Field header_func 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.
3	Field error_data has been removed from this type.	1) Applications will access incorrect memory when attempting to access this field. 2) Size of the inclusive type has been changed.

	Change	Effect
1	Field crc_header 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	Field c_private 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.
3	Type of field duration has been changed from mad_timer to mad_timer_t of different format.	This field may be incorrectly initialized or accessed by applications.
4	The relative position of field flags has been changed from 6 to 7.	Applications will access incorrect memory when attempting to access this field.

	Change	Effect
1	Field pcmlen has been removed from this type.	1) Applications will access incorrect memory when attempting to access this field. 2) Size of the inclusive type has been changed.
2	Field pcmout has been removed from this type.	1) Applications will access incorrect memory when attempting to access this field. 2) Size of the inclusive type has been changed.

libmad.h
[+] struct anon-struct-libmad.h-580 (2)
[+] struct mad_decoder (3)
[+] struct mad_frame (4)
[+] struct mad_synth (2)

to the top

Problems with Symbols, Medium Severity (11)

	Change	Effect
1	2nd parameter p2 has been added to the calling stack.	This parameter will not be initialized by old clients.
2	3rd parameter p3 has been added to the calling stack.	This parameter will not be initialized by old clients.
3	4th parameter p4 has been added to the calling stack.	This parameter will not be initialized by old clients.
4	5th parameter p5 has been added to the calling stack.	This parameter will not be initialized by old clients.
5	6th parameter p6 has been added to the calling stack.	This parameter will not be initialized by old clients.
6	7th parameter p7 has been added to the calling stack.	This parameter will not be initialized by old clients.
7	8th parameter p8 has been added to the calling stack.	This parameter will not be initialized by old clients.

	Change	Effect
1	Parameter p3 of type unsigned short* has been removed from the calling stack.	This parameter will be ignored by the function.

	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.
2	Parameter p2 of type unsigned char const* has been removed from the calling stack.	This parameter will be ignored by the function.

	Change	Effect
1	The pointer level of 2nd parameter p2 has been decreased from 1 to 0.	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. ATTENTION: if this is out-parameter then this change may cause a crash of applications.

libmad.h, libmad.so
[+] mad_decoder_init ( mad_decoder* p1 ) (7)
[+] mad_frame_header ( mad_frame* p1, mad_stream* p2, unsigned short* p3 ) (1)
[+] mad_stream_sync ( unsigned char const* p1, unsigned char const* p2 ) (2)
[+] mad_timer_add ( mad_timer* p1, mad_timer const* p2 ) (1)

to the top

Problems with Data Types, Low Severity (21)

	Change	Effect
1	Type of field pid has been changed from int to long.	Replacement of the field data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Size of this type has been changed from 22636 bytes to 22648 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 52 bytes to 48 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	Base type of field error_func has been changed from *int()(void,mad_stream,mad_frame)* to *mad_flow()(void,mad_stream,mad_frame)*.	Replacement of field base type may indicate a change in the semantic meaning of the field.
3	Base type of field filter_func has been changed from *int()(void,mad_frame) to mad_flow()(void,mad_frame)*.	Replacement of field base type may indicate a change in the semantic meaning of the field.
4	Base type of field input_func has been changed from *int()(void,mad_stream) to mad_flow()(void,mad_stream)*.	Replacement of field base type may indicate a change in the semantic meaning of the field.
5	Base type of field output_func has been changed from int()(void,mad_frame const,mad_synth const) to mad_flow()(void,mad_frame const,mad_pcm).	Replacement of field base type may indicate a change in the semantic meaning of the field.
6	Type of field mode has been changed from int to mad_decoder_mode.	Replacement of the field data type may indicate a change in the semantic meaning of the field.
7	Field output_data has been renamed to message_func.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Size of this type has been changed from 9260 bytes to 9268 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	Base type of field overlap has been changed from long to int.	Replacement of field base type may indicate a change in the semantic meaning of the field.
3	Type of field emphasis has been changed from int to mad_emphasis.	Replacement of the field data type may indicate a change in the semantic meaning of the field.
4	Type of field layer has been changed from int to mad_layer.	Replacement of the field data type may indicate a change in the semantic meaning of the field.
5	Type of field mode has been changed from int to mad_mode.	Replacement of the field data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Type of field error has been changed from int to mad_error.	Replacement of the field data type may indicate a change in the semantic meaning of the field.
2	Type of field freerate has been changed from unsigned int to unsigned long.	Replacement of the field data type may indicate a change in the semantic meaning of the field.
3	Type of field main_data has been changed from unsigned char[1935] * to unsigned char[2563] *.	Replacement of the field data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Field pcm has been added to this type.	Size of the inclusive type has been changed. ATTENTION: 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 13316 bytes to 13320 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
3	Field filterout has been renamed to polyfilter.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Base type has been changed from long to int.	Possible incorrect initialization of parameters by applications.

libmad.h
[+] struct anon-struct-libmad.h-574 (1)
[+] struct anon-struct-libmad.h-580 (1)
[+] struct mad_decoder (7)
[+] struct mad_frame (5)
[+] struct mad_stream (3)
[+] struct mad_synth (3)
[+] typedef mad_fixed_t (1)

to the top

Problems with Symbols, Low Severity (3)

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

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

	Change	Effect
1	Base type of parameter p1 has been changed from mad_timer to mad_timer_t of different format.	This parameter may be incorrectly initialized by applications.

libmad.h, libmad.so
[+] mad_decoder_run ( mad_decoder* p1, int p2 ) (1)
[+] mad_stream_sync ( unsigned char const* p1, unsigned char const* p2 ) (1)
[+] mad_timer_add ( mad_timer* p1, mad_timer const* p2 ) (1)

to the top

Problems with Constants (1)

	Change	Effect
1	The value of constant MAD_F_MIN has been changed from 0x80000000L to (-0x80000000L).	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.

libmad.h
[+] MAD_F_MIN

to the top

Header Files (17)

acconfig.h
audio.h
bit.h
config.h
decoder.h
fixed.h
frame.h
huffman.h
id3.h
id3v2.h
layer12.h
layer3.h
libmad.h
stream.h
synth.h
timer.h
version.h

to the top

Shared Libraries (1)

libmad.so

to the top