Binary compatibility report for the libmemcached library between 0.38 and 0.39 versions on x86

Test Info

Library Name	libmemcached
Version #1	0.38
Version #2	0.39
CPU Type	x86
GCC Version	4.6.1

Test Results

Total Header Files	43
Total Shared Libraries	4
Total Symbols / Types	131 / 163
Verdict	Incompatible (33.2%)

Problem Summary

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

Added Symbols (16)

hash.h, libmemcached.so.4.0.0
memcached_autoeject ( memcached_st* ptr )
memcached_set_hashkit ( memcached_st* ptr, hashkit_st* hashk )

memcached.h, libmemcached.so.4.0.0
memcached_push ( memcached_st* destination, memcached_st const* source )
memcached_server_count ( memcached_st const* p1 )
memcached_server_instance_by_position ( memcached_st const* ptr, uint32_t server_key )

result.h, libmemcached.so.4.0.0
memcached_result_cas ( memcached_result_st const* self )
memcached_result_flags ( memcached_result_st const* self )
memcached_result_key_length ( memcached_result_st const* self )
memcached_result_key_value ( memcached_result_st const* self )
memcached_result_length ( memcached_result_st const* self )
memcached_result_set_expiration ( memcached_result_st* self, time_t expiration )
memcached_result_set_flags ( memcached_result_st* self, uint32_t flags )
memcached_result_value ( memcached_result_st const* self )

server.h, libmemcached.so.4.0.0
memcached_server_name ( memcached_server_instance_st self )
memcached_server_port ( memcached_server_instance_st self )
memcached_server_response_count ( memcached_server_instance_st self )

to the top

Removed Symbols (1)

server.h, libmemcached.so.4.0.0
memcached_server_remove ( memcached_server_st* st_ptr )

to the top

Problems with Data Types, Medium Severity (3)

	Change	Effect
1	Field sasl 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 tcp_keepidle 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	Size of field is_corked has been changed from 1 byte to 1 bit.	Previous accesses of applications and library functions to this field may be broken.

memcached.h
[+] struct memcached_st (2)

server.h
[+] struct memcached_server_st::anon-struct-server.h-31 (1)

to the top

Problems with Symbols, Medium Severity (3)

	Change	Effect
1	Type of return value became const (has been changed from hashkit_st* to hashkit_st const*).	The return value will be treated as non-const by old client applications. This may result in crash or incorrect behavior of applications.

	Change	Effect
1	Type of return value became const (has been changed from memcached_server_st* to memcached_server_instance_st).	The return value will be treated as non-const by old client applications. This may result in crash or incorrect behavior of applications.

	Change	Effect
1	Type of return value became const (has been changed from memcached_server_st* to memcached_server_instance_st).	The return value will be treated as non-const by old client applications. This may result in crash or incorrect behavior of applications.

hash.h, libmemcached.so.4.0.0
[+] memcached_get_hashkit ( memcached_st* ptr ) (1)

server.h, libmemcached.so.4.0.0
[+] memcached_server_by_key ( memcached_st* ptr, char const* key, size_t key_length, enum memcached_return_t* error ) (1)
[+] memcached_server_get_last_disconnect ( memcached_st* ptr ) (1)

to the top

Problems with Data Types, Low Severity (9)

	Change	Effect
1	Value of member MEMCACHED_BEHAVIOR_MAX has been changed from 32 to 34.	Applications may execute a wrong branch of code in the library and therefore change the behavior.

	Change	Effect
1	Value of member MEMCACHED_MAXIMUM_RETURN has been changed from 40 to 43.	Applications may execute a wrong branch of code in the library and therefore change the behavior.

	Change	Effect
1	Size of this type has been changed from 604 bytes to 612 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	Size of field flags has been changed from 2 bytes to 3 bytes.	Previous accesses of applications and library functions to this field may be broken.

	Change	Effect
1	Field is_time_for_rebuild has been added to this type.	This field will not be initialized by old clients. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.

	Change	Effect
1	Field tcp_keepalive 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 2 bytes to 3 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field is_dead has been added to this type.	This field will not be initialized by old clients. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.

	Change	Effect
1	Base type has been changed from enum memcached_return_t()(memcached_st const,memcached_server_st,void) to enum memcached_return_t()(memcached_st const,memcached_server_instance_st,void*).	Replacement of the base data type may indicate a change in its semantic meaning.

constants.h
[+] enum memcached_behavior_t (1)
[+] enum memcached_return_t (1)

memcached.h
[+] struct memcached_st (2)
[+] struct memcached_st::anon-struct-memcached.h-60 (1)
[+] struct memcached_st::anon-struct-memcached.h-64 (2)

server.h
[+] struct memcached_server_st::anon-struct-server.h-31 (1)

types.h
[+] typedef memcached_server_fn (1)

to the top

Problems with Symbols, Low Severity (22)

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

	Change	Effect
1	Type of 1st parameter ptr has been changed from memcached_st* to memcached_st const*.	Replacement of parameter data type may indicate a change in its semantic meaning.
2	Type of return value has been changed from hashkit_st* to hashkit_st const*.	Replacement of return type may indicate a change in its semantic meaning.

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

	Change	Effect
1	Type of 1st parameter ptr has been changed from memcached_st* to memcached_st const*.	Replacement of parameter data type may indicate a change in its semantic meaning.
2	Type of return value has been changed from memcached_server_st* to memcached_server_instance_st.	Replacement of return type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 1st parameter ptr has been changed from memcached_st* to memcached_st const*.	Replacement of parameter data type may indicate a change in its semantic meaning.
2	Base type of 2nd parameter callback has been changed from enum memcached_return_t()(memcached_st const,memcached_server_st,void) to enum memcached_return_t()(memcached_st const,memcached_server_instance_st,void*).	Replacement of parameter base type may indicate a change in its semantic meaning.

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

	Change	Effect
1	Type of 1st parameter ptr has been changed from memcached_st* to memcached_st const*.	Replacement of parameter data type may indicate a change in its semantic meaning.
2	Type of return value has been changed from memcached_server_st* to memcached_server_instance_st.	Replacement of return type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 1st parameter ptr has been changed from memcached_server_st* to memcached_server_list_st.	Replacement of parameter data type may indicate a change in its semantic meaning.
2	Type of return value has been changed from memcached_server_st* to memcached_server_list_st.	Replacement of return type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 1st parameter ptr has been changed from memcached_server_st* to memcached_server_list_st.	Replacement of parameter data type may indicate a change in its semantic meaning.
2	Type of return value has been changed from memcached_server_st* to memcached_server_list_st.	Replacement of return type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 1st parameter ptr has been changed from memcached_server_st* to memcached_server_list_st const.	Replacement of parameter data type may indicate a change in its semantic meaning.
2	Type of return value has been changed from unsigned int to uint32_t.	Replacement of return type may indicate a change in its semantic meaning.

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

	Change	Effect
1	Type of 2nd parameter list has been changed from memcached_server_st* to memcached_server_list_st const.	Replacement of parameter data type may indicate a change in its semantic meaning.

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

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

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

hash.h, libmemcached.so.4.0.0
[+] memcached_generate_hash ( memcached_st* ptr, char const* key, size_t key_length ) (1)
[+] memcached_get_hashkit ( memcached_st* ptr ) (2)

parse.h, libmemcached.so.4.0.0
[+] memcached_servers_parse ( char const* server_strings ) (1)

server.h, libmemcached.so.4.0.0
[+] memcached_server_by_key ( memcached_st* ptr, char const* key, size_t key_length, enum memcached_return_t* error ) (2)
[+] memcached_server_cursor ( memcached_st* ptr, enum memcached_return_t(*callback)(memcached_st const*, memcached_server_st*, void*)*, void* context, uint32_t number_of_callbacks ) (2)
[+] memcached_server_error ( memcached_server_st* ptr ) (1)
[+] memcached_server_get_last_disconnect ( memcached_st* ptr ) (2)
[+] memcached_server_list_append ( memcached_server_st* ptr, char const* hostname, in_port_t port, enum memcached_return_t* error ) (2)
[+] memcached_server_list_append_with_weight ( memcached_server_st* ptr, char const* hostname, in_port_t port, uint32_t weight, enum memcached_return_t* error ) (2)
[+] memcached_server_list_count ( memcached_server_st* ptr ) (2)
[+] memcached_server_list_free ( memcached_server_st* ptr ) (1)
[+] memcached_server_push ( memcached_st* ptr, memcached_server_st* list ) (1)

stats.h, libmemcached.so.4.0.0
[+] memcached_stat_free ( memcached_st* p1, memcached_stat_st* p2 ) (1)
[+] memcached_stat_get_keys ( memcached_st* ptr, memcached_stat_st* memc_stat, enum memcached_return_t* error ) (1)
[+] memcached_stat_get_value ( memcached_st* ptr, memcached_stat_st* memc_stat, char const* key, enum memcached_return_t* error ) (1)

to the top

Problems with Constants, Low Severity (2)

	Change	Effect
1	The constant HASHKIT_BITFIELD 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 MEMCACHED_BITFIELD with value :1 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

configure.h
[+] HASHKIT_BITFIELD
[+] MEMCACHED_BITFIELD

to the top

Other Changes in Data Types (5)

	Change	Effect
1	The member MEMCACHED_BEHAVIOR_TCP_KEEPALIVE with value 32 has been added.	No effect.
2	The member MEMCACHED_BEHAVIOR_TCP_KEEPIDLE with value 33 has been added.	No effect.

	Change	Effect
1	The member MEMCACHED_AUTH_CONTINUE with value 42 has been added.	No effect.
2	The member MEMCACHED_AUTH_FAILURE with value 41 has been added.	No effect.
3	The member MEMCACHED_AUTH_PROBLEM with value 40 has been added.	No effect.

constants.h
[+] enum memcached_behavior_t (2)
[+] enum memcached_return_t (3)

to the top

Header Files (43)

algorithm.h
allocators.h
analyze.h
auto.h
cache.h
callback.h
constants.h
delete.h
digest.h
dump.h
fetch.h
flush.h
flush_buffers.h
function.h
get.h
hash.h
hashkit.h
behavior.h (libhashkit/behavior.h)
configure.h (libhashkit/configure.h)
strerror.h (libhashkit/strerror.h)
types.h (libhashkit/types.h)
visibility.h (libhashkit/visibility.h)
behavior.h (libmemcached/behavior.h)
configure.h (libmemcached/configure.h)
strerror.h (libmemcached/strerror.h)
types.h (libmemcached/types.h)
visibility.h (libmemcached/visibility.h)
memcached.h
memcached_util.h
parse.h
pool.h
callback.h (protocol/callback.h)
protocol_binary.h
protocol_handler.h
quit.h
result.h
server.h
stats.h
storage.h
string.h
verbosity.h
version.h
watchpoint.h

to the top

Shared Libraries (4)

libhashkit.so.0.0.0
libmemcached.so.4.0.0
libmemcachedprotocol.so.0.0.0
libmemcachedutil.so.0.0.0

to the top