Binary compatibility report for the FFTW library between 1.2 and 2.1.4 versions on x86

Test Info

Library Name	FFTW
Version #1	1.2
Version #2	2.1.4
CPU Architecture	x86
GCC Version	4.6.1

Test Results

Total Header Files	2
Total Shared Libraries	1
Total Symbols / Types	31 / 58
Verdict	Incompatible (30.65%)

Problem Summary

	Severity	Count
Added Symbols	-	32
Removed Symbols	High	7
Problems with Data Types	High	1
	Medium	15
	Low	16
Problems with Symbols	High	0
	Medium	0
	Low	8
Problems with Constants	Low	1
Other Changes	-	5

Added Symbols (32)

fftw.h, libfftw.so.2.0.6
fftw2d_create_plan_specific ( int nx, int ny, fftw_direction dir, int flags, fftw_complex* in, int istride, fftw_complex* out, int ostride )
fftw3d_create_plan_specific ( int nx, int ny, int nz, fftw_direction dir, int flags, fftw_complex* in, int istride, fftw_complex* out, int ostride )
fftw_create_plan_specific ( int n, fftw_direction dir, int flags, fftw_complex* in, int istride, fftw_complex* out, int ostride )
fftw_die_hook [data]
fftw_one ( fftw_plan plan, fftw_complex* in, fftw_complex* out )
fftw_print_max_memory_usage ( )
fftw_sizeof_fftw_real ( )
fftwnd_create_plan_specific ( int rank, int const* n, fftw_direction dir, int flags, fftw_complex* in, int istride, fftw_complex* out, int ostride )
fftwnd_fprint_plan ( FILE* f, fftwnd_data* p )
fftwnd_one ( fftwnd_data* p, fftw_complex* in, fftw_complex* out )
fftwnd_print_plan ( fftwnd_data* p )

rfftw.h, librfftw.so.2.0.6
rfftw ( rfftw_plan plan, int howmany, fftw_real* in, int istride, int idist, fftw_real* out, int ostride, int odist )
rfftw2d_create_plan ( int nx, int ny, fftw_direction dir, int flags )
rfftw2d_create_plan_specific ( int nx, int ny, fftw_direction dir, int flags, fftw_real* in, int istride, fftw_real* out, int ostride )
rfftw3d_create_plan ( int nx, int ny, int nz, fftw_direction dir, int flags )
rfftw3d_create_plan_specific ( int nx, int ny, int nz, fftw_direction dir, int flags, fftw_real* in, int istride, fftw_real* out, int ostride )
rfftw_create_plan ( int n, fftw_direction dir, int flags )
rfftw_create_plan_specific ( int n, fftw_direction dir, int flags, fftw_real* in, int istride, fftw_real* out, int ostride )
rfftw_destroy_plan ( rfftw_plan plan )
rfftw_executor_simple ( int n, fftw_real* in, fftw_real* out, fftw_plan_node* p, int istride, int ostride, fftw_recurse_kind recurse_kind )
rfftw_fprint_plan ( FILE* f, rfftw_plan p )
rfftw_one ( rfftw_plan plan, fftw_real* in, fftw_real* out )
rfftw_print_plan ( rfftw_plan p )
rfftwnd_complex_to_real ( rfftwnd_plan p, int howmany, fftw_complex* in, int istride, int idist, fftw_real* out, int ostride, int odist )
rfftwnd_create_plan ( int rank, int const* n, fftw_direction dir, int flags )
rfftwnd_create_plan_specific ( int rank, int const* n, fftw_direction dir, int flags, fftw_real* in, int istride, fftw_real* out, int ostride )
rfftwnd_destroy_plan ( rfftwnd_plan plan )
rfftwnd_fprint_plan ( FILE* f, rfftwnd_plan plan )
rfftwnd_one_complex_to_real ( rfftwnd_plan p, fftw_complex* in, fftw_real* out )
rfftwnd_one_real_to_complex ( rfftwnd_plan p, fftw_real* in, fftw_complex* out )
rfftwnd_print_plan ( rfftwnd_plan plan )
rfftwnd_real_to_complex ( rfftwnd_plan p, int howmany, fftw_real* in, int istride, int idist, fftw_complex* out, int ostride, int odist )

to the top

Removed Symbols (7)

fftw.h, libfftw.so
fftw_config_notw [data]
fftw_config_twiddle [data]
fftw_measure_runtime ( fftw_plan plan )
fftw_naive ( int n, FFTW_COMPLEX* in, FFTW_COMPLEX* out )
fftwi_config_notw [data]
fftwi_config_twiddle [data]
fftwi_naive ( int n, FFTW_COMPLEX* in, FFTW_COMPLEX* out )

to the top

Problems with Data Types, High Severity (1)

	Change	Effect
1	Field m 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.

fftw.h
[+] struct fftw_twiddle_struct (1)

to the top

Problems with Data Types, Medium Severity (15)

	Change	Effect
1	Size of field nodeu has been changed from 16 bytes to 24 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.

	Change	Effect
1	The relative position of field cost has been changed from 3 to 8.	1) Applications will access incorrect memory when attempting to access this field. 2) Size of the inclusive type has been changed.
2	The relative position of field flags has been changed from 4 to 3.	1) Applications will access incorrect memory when attempting to access this field. 2) Size of the inclusive type has been changed.
3	The relative position of field dir has been changed from 1 to 2.	Applications will access incorrect memory when attempting to access this field.
4	The relative position of field next has been changed from 7 to 6.	Applications will access incorrect memory when attempting to access this field.
5	The relative position of field refcnt has been changed from 8 to 1.	Applications will access incorrect memory when attempting to access this field.
6	The relative position of field root has been changed from 2 to 7.	Applications will access incorrect memory when attempting to access this field.
7	The relative position of field wisdom_signature has been changed from 6 to 4.	Applications will access incorrect memory when attempting to access this field.

	Change	Effect
1	Field hc2hc has been added to this type.	Size of the union 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 hc2real has been added to this type.	Size of the union 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	Field rader has been added to this type.	Size of the union 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.
4	Field real2hc has been added to this type.	Size of the union 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.
5	Field rgeneric has been added to this type.	Size of the union 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.
6	Size of field notw has been changed from 8 bytes to 12 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.
7	Size of field twiddle has been changed from 16 bytes to 20 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.

fftw.h
[+] struct fftw_plan_node_struct (1)
[+] struct fftw_plan_struct (7)
[+] union anon-union-fftw.h-161 (7)

to the top

Problems with Data Types, Low Severity (16)

	Change	Effect
1	Field codelet_desc has been added to this type.	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.
3	Base type of field codelet has been changed from void()(FFTW_COMPLEX const,FFTW_COMPLEX,int,int) to void()(fftw_complex const,fftw_complex,int,int).	Replacement of field base type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Field codelet_desc has been added to this type.	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 16 bytes to 20 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
3	Base type of field codelet has been changed from void()(FFTW_COMPLEX,FFTW_COMPLEX const,int,int,int) to void()(fftw_complex,fftw_complex const,int,int,int).	Replacement of field base type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Base type of field codelet has been changed from void()(FFTW_COMPLEX,FFTW_COMPLEX const,int,int,int,int) to void()(fftw_complex,fftw_complex const,int,int,int,int).	Replacement of field base type may indicate a change in the semantic meaning of the field.

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

	Change	Effect
1	Field recurse_kind has been added to this type.	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 vector_size has been added to this type.	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 40 bytes to 48 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 24 bytes to 20 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	Base type of field twarray has been changed from FFTW_COMPLEX to fftw_complex of different format.	This field may be incorrectly initialized or accessed by applications.
3	Field r has been renamed to cdesc.	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 fftwnd_aux_data* to fftwnd_data*.	Possible incorrect initialization of parameters by applications.

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

fftw.h
[+] struct anon-struct-fftw.h-163 (3)
[+] struct anon-struct-fftw.h-169 (3)
[+] struct anon-struct-fftw.h-177 (1)
[+] struct fftw_plan_node_struct (1)
[+] struct fftw_plan_struct (3)
[+] struct fftw_twiddle_struct (3)
[+] typedef fftwnd_plan (1)
[+] union anon-union-fftw.h-161 (1)

to the top

Problems with Symbols, Low Severity (8)

	Change	Effect
1	Base type of parameter in has been changed from FFTW_COMPLEX to fftw_complex of different format.	This parameter may be incorrectly initialized by applications.
2	Base type of parameter out has been changed from FFTW_COMPLEX to fftw_complex of different format.	This parameter may be incorrectly initialized by applications.

	Change	Effect
1	Type of 1st parameter s has been changed from char* to char const*.	Replacement of parameter data type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of this global data has been changed from *void()(void)* to fftw_free_type_function.	Replacement of data type may indicate a change in semantic meaning.

	Change	Effect
1	Type of this global data has been changed from *void()(size_t)* to fftw_malloc_type_function.	Replacement of data type may indicate a change in semantic meaning.

	Change	Effect
1	Type of this global data has been changed from char* to char const*.	Replacement of data type may indicate a change in semantic meaning.

	Change	Effect
1	Base type of parameter in has been changed from FFTW_COMPLEX to fftw_complex of different format.	This parameter may be incorrectly initialized by applications.
2	Base type of parameter out has been changed from FFTW_COMPLEX to fftw_complex of different format.	This parameter may be incorrectly initialized by applications.

fftw.h, libfftw.so
[+] fftw ( fftw_plan plan, int howmany, FFTW_COMPLEX* in, int istride, int idist, FFTW_COMPLEX* out, int ostride, int odist ) (2)
[+] fftw_die ( char* s ) (1)
[+] fftw_free_hook [data] (1)
[+] fftw_malloc_hook [data] (1)
[+] fftw_version [data] (1)
[+] fftwnd ( fftwnd_aux_data* plan, int howmany, FFTW_COMPLEX* in, int istride, int idist, FFTW_COMPLEX* out, int ostride, int odist ) (2)

to the top

Problems with Constants (1)

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

fftw.h
[+] FFTW_1_0_COMPATIBILITY

to the top

Other Changes in Data Types (5)

	Change	Effect
1	The member FFTW_HC2HC with value 6 has been added.	No effect.
2	The member FFTW_HC2REAL with value 5 has been added.	No effect.
3	The member FFTW_RADER with value 3 has been added.	No effect.
4	The member FFTW_REAL2HC with value 4 has been added.	No effect.
5	The member FFTW_RGENERIC with value 7 has been added.	No effect.

fftw.h
[+] enum fftw_node_type (5)

to the top

Header Files (2)

fftw.h
konst.h

to the top

Shared Libraries (1)

libfftw.so

to the top