Binary compatibility report for the libmemcached library between 0.16 and 0.17 versions on x86

Test Info

Library Name	libmemcached
Version #1	0.16
Version #2	0.17
CPU Type	x86
GCC Version	4.6.1

Test Results

Total Header Files	2
Total Shared Libraries	1
Total Symbols / Types	52 / 64
Verdict	Incompatible (42.3%)

Problem Summary

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

Added Symbols (1)

memcached.h, libmemcached.so.2.0.0
memcached_server_cursor ( memcached_st* ptr, memcached_server_function* callback, void* context, unsigned int number_of_callbacks )

to the top

Problems with Symbols, High Severity (1)

	Change	Effect
1	Type of 3rd parameter data has been changed from void* (4 bytes) to uint64_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.

memcached.h, libmemcached.so.2.0.0
[+] memcached_behavior_set ( memcached_st* ptr, enum memcached_behavior flag, void* data ) (1)

to the top

Problems with Data Types, Medium Severity (3)

	Change	Effect
1	Value of member MEMCACHED_BEHAVIOR_SORT_HOSTS has been changed from 12 to 11.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
2	Value of member MEMCACHED_BEHAVIOR_VERIFY_KEY has been changed from 13 to 12.	Applications may execute a wrong branch of code in the library and therefore change the behavior.

memcached.h
[+] enum memcached_behavior (2)
[+] struct memcached_st (1)

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

[+] affected symbols (43)

memcached_add ( memcached_st* ptr, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_add_by_key ( memcached_st* ptr, char* master_key, size_t master_key_length, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_append ( memcached_st* ptr, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_append_by_key ( memcached_st* ptr, char* master_key, size_t master_key_length, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_behavior_get ( memcached_st* ptr, enum memcached_behavior flag )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_behavior_set ( memcached_st* ptr, enum memcached_behavior flag, void* data )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_callback_get ( memcached_st* ptr, enum memcached_callback flag, enum memcached_return* error )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_callback_set ( memcached_st* ptr, enum memcached_callback flag, void* data )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_cas ( memcached_st* ptr, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags, uint64_t cas )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_cas_by_key ( memcached_st* ptr, char* master_key, size_t master_key_length, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags, uint64_t cas )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_clone ( memcached_st* clone, memcached_st* ptr )

1st parameter 'clone' (pointer) has base type 'struct memcached_st'.

memcached_create ( memcached_st* ptr )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_decrement ( memcached_st* ptr, char* key, size_t key_length, uint32_t offset, uint64_t* value )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_delete ( memcached_st* ptr, char* key, size_t key_length, time_t expiration )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_delete_by_key ( memcached_st* ptr, char* master_key, size_t master_key_length, char* key, size_t key_length, time_t expiration )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_fetch ( memcached_st* ptr, char* key, size_t* key_length, size_t* value_length, uint32_t* flags, enum memcached_return* error )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_fetch_execute ( memcached_st* ptr, unsigned int(**callback)(memcached_st*, memcached_result_st*, void*), void* context, unsigned int number_of_callbacks )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_fetch_result ( memcached_st* ptr, memcached_result_st* result, enum memcached_return* error )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_flush ( memcached_st* ptr, time_t expiration )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_free ( memcached_st* ptr )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_get ( memcached_st* ptr, char* key, size_t key_length, size_t* value_length, uint32_t* flags, enum memcached_return* error )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_get_by_key ( memcached_st* ptr, char* master_key, size_t master_key_length, char* key, size_t key_length, size_t* value_length, uint32_t* flags, enum memcached_return* error )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_increment ( memcached_st* ptr, char* key, size_t key_length, uint32_t offset, uint64_t* value )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_mget ( memcached_st* ptr, char** keys, size_t* key_length, unsigned int number_of_keys )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_mget_by_key ( memcached_st* ptr, char* master_key, size_t master_key_length, char** keys, size_t* key_length, unsigned int number_of_keys )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_prepend ( memcached_st* ptr, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_prepend_by_key ( memcached_st* ptr, char* master_key, size_t master_key_length, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_quit ( memcached_st* ptr )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_replace ( memcached_st* ptr, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_replace_by_key ( memcached_st* ptr, char* master_key, size_t master_key_length, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_result_create ( memcached_st* ptr, memcached_result_st* result )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_server_add ( memcached_st* ptr, char* hostname, unsigned int port )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_server_add_udp ( memcached_st* ptr, char* hostname, unsigned int port )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_server_add_unix_socket ( memcached_st* ptr, char* filename )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_server_push ( memcached_st* ptr, memcached_server_st* list )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_set ( memcached_st* ptr, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_set_by_key ( memcached_st* ptr, char* master_key, size_t master_key_length, char* key, size_t key_length, char* value, size_t value_length, time_t expiration, uint32_t flags )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_stat ( memcached_st* ptr, char* args, enum memcached_return* error )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_stat_free ( memcached_st* p1, memcached_stat_st* p2 )

1st parameter 'p1' (pointer) has base type 'struct memcached_st'.

memcached_stat_get_keys ( memcached_st* ptr, memcached_stat_st* stat, enum memcached_return* error )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_stat_get_value ( memcached_st* ptr, memcached_stat_st* stat, char* key, enum memcached_return* error )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_strerror ( memcached_st* ptr, enum memcached_return rc )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

memcached_verbosity ( memcached_st* ptr, unsigned int verbosity )

1st parameter 'ptr' (pointer) has base type 'struct memcached_st'.

to the top

Problems with Symbols, Medium Severity (1)

	Change	Effect
1	The pointer level of 3rd parameter data 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. NOTE: if this is out-parameter then this change may cause a crash of applications.

memcached.h, libmemcached.so.2.0.0
[+] memcached_behavior_set ( memcached_st* ptr, enum memcached_behavior flag, void* data ) (1)

to the top

Problems with Data Types, Low Severity (2)

	Change	Effect
1	The member MEMCACHED_BEHAVIOR_USER_DATA has been removed.	This may result in crash or incorrect behavior of applications because the library may not handle removed member anymore.

memcached.h
[+] enum memcached_behavior (1)
[+] struct memcached_st (1)

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