libnetconf: 0.9.0 to 0.10.0 compatibility report

Test Info

Library Name	libnetconf
Version #1	0.9.0
Version #2	0.10.0
CPU Type	x86_64
GCC Version	4.8
Subject	Binary Compatibility

Test Results

Total Header Files	21
Total Shared Libraries	3
Total Symbols / Types	190 / 175
Verdict	Incompatible (1.6%)

Problem Summary

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

Added Symbols (5)

callbacks_ssh.h, libnetconf.so.0.10.0
nc_del_keypair_path ( char const* privkey, char const* pubkey )

libnetconf_ssh.h, libnetconf.so.0.10.0
nc_session_accept_libssh_channel ( struct nc_cpblts const* capabilities, char const* username, ssh_channel ssh_chan )

libnetconf_tls.h, libnetconf.so.0.10.0
nc_session_accept_tls ( struct nc_cpblts const* capabilities, char const* username, SSL* tls_sess )

messages_xml.h, libnetconf.so.0.10.0
ncxml_reply_data_ns ( xmlNodePtr const data, char const* ns )

notifications.h, libnetconf.so.0.10.0
ncntf_session_get_active_subscription ( struct nc_session* session )

to the top

Removed Symbols (1)

datastore.h, libnetconf.so.0.9.0
ncds_apply_rpc ( ncds_id id, struct nc_session const* session, nc_rpc const* rpc )

to the top

Problems with Data Types, High Severity (1)

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

transapi.h
[+] struct transapi_rpc_callbacks::anon-struct-transapi.h-175 (1)

to the top

Problems with Data Types, Medium Severity (2)

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

transapi.h
[+] struct transapi (1)
[+] struct transapi_rpc_callbacks::anon-struct-transapi.h-175 (1)

to the top

Problems with Data Types, Low Severity (4)

	Change	Effect
1	Base type of field func has been changed from int()(void,enum XMLDIFF_OP,xmlNodePtr,struct nc_err) to int()(void,enum XMLDIFF_OP,xmlNodePtr,xmlNodePtr,struct nc_err).	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 80 bytes to 88 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 536 bytes to 16 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	Base type of field func has been changed from *nc_reply()(xmlNodePtr) to nc_reply()(xmlNodePtr)**.	Replacement of field base type may indicate a change in the semantic meaning of the field.

transapi.h
[+] struct clbk (1)
[+] struct transapi (1)
[+] struct transapi_rpc_callbacks::anon-struct-transapi.h-175 (2)

to the top

Problems with Symbols, Low Severity (7)

	Change	Effect
1	Base type of 1st parameter func has been changed from int()(char const,LIBSSH2_SESSION) to int()(char const*,ssh_session).	Replacement of parameter base type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of return value has been changed from void to char* (8 bytes).	Replacement of return type may indicate a change in its semantic meaning.
2	Base type of 1st parameter func has been changed from void()(char const,int,char const,int,int,LIBSSH2_USERAUTH_KBDINT_PROMPT const,LIBSSH2_USERAUTH_KBDINT_RESPONSE,void) to void()(char const,char const,char const*,int).	Replacement of parameter base type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of return value has been changed from void to int (4 bytes).	Replacement of return type may indicate a change in its semantic meaning.
2	1st parameter private has been renamed to privkey.	Renaming of a parameter may indicate a change in its semantic meaning.
3	2nd parameter public has been renamed to pubkey.	Renaming of a parameter may indicate a change in its semantic meaning.

	Change	Effect
1	4th parameter namespace has been renamed to ns.	Renaming of a parameter may indicate a change in its semantic meaning.

callbacks_ssh.h, libnetconf.so.0.9.0
[+] nc_callback_ssh_host_authenticity_check ( int(*func)(char const*, LIBSSH2_SESSION*) ) (1)
[+] nc_callback_sshauth_interactive ( void(*func)(char const*, int, char const*, int, int, LIBSSH2_USERAUTH_KBDINT_PROMPT const*, LIBSSH2_USERAUTH_KBDINT_RESPONSE*, void**) ) (2)
[+] nc_set_keypair_path ( char const* private, char const* public ) (3)

datastore.h, libnetconf.so.0.9.0
[+] ncds_model_info ( char const* path, char** name, char** version, char** namespace, char** prefix, char*** rpcs, char*** notifs ) (1)

to the top

Problems with Constants, Low Severity (3)

	Change	Effect
1	The value of constant NC_INIT_ALL has been changed from 0xffffcfff to 0xffff8fff.	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 NC_INIT_KEEPALIVECHECK has been changed from 0x00000088 to 0x00000080.	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 NC_INIT_NACM has been changed from 0x00000104 to 0x00000004.	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.

netconf.h
[+] NC_INIT_ALL
[+] NC_INIT_KEEPALIVECHECK
[+] NC_INIT_NACM

to the top

Other Changes in Constants (2)

	Change	Effect
1	The constant NC_INIT_CLIENT with value 0x00004000 has been added.	No effect.

	Change	Effect
1	The constant NC_INIT_LIBSSH_PTHREAD with value 0x00000200 has been added.	No effect.

netconf.h
[+] NC_INIT_CLIENT
[+] NC_INIT_LIBSSH_PTHREAD

to the top

Header Files (21)

callbacks.h
callbacks_ssh.h
callhome.h
datastore.h
datastore_custom.h
datastore_xml.h
error.h
libnetconf.h
libnetconf_ssh.h
libnetconf_tls.h
libnetconf_xml.h
messages.h
messages_xml.h
netconf.h
notifications.h
notifications_xml.h
session.h
transapi.h
transport.h
url.h
with_defaults.h

to the top

Shared Libraries (3)

libnetconf.so
libnetconf.so.0
libnetconf.so.0.9.0

to the top

Test Info

Library Name	libnetconf
Version #1	0.9.0
Version #2	0.10.0
CPU Type	x86_64
GCC Version	4.8
Subject	Source Compatibility

Test Results

Total Header Files	21
Total Shared Libraries	3
Total Symbols / Types	190 / 175
Verdict	Incompatible (1.6%)

Problem Summary

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

Added Symbols (5)

callbacks_ssh.h
nc_del_keypair_path ( char const* privkey, char const* pubkey )

libnetconf_ssh.h
nc_session_accept_libssh_channel ( struct nc_cpblts const* capabilities, char const* username, ssh_channel ssh_chan )

libnetconf_tls.h
nc_session_accept_tls ( struct nc_cpblts const* capabilities, char const* username, SSL* tls_sess )

messages_xml.h
ncxml_reply_data_ns ( xmlNodePtr const data, char const* ns )

notifications.h
ncntf_session_get_active_subscription ( struct nc_session* session )

to the top

Removed Symbols (1)

datastore.h
ncds_apply_rpc ( ncds_id id, struct nc_session const* session, nc_rpc const* rpc )

to the top

Problems with Data Types, High Severity (2)

	Change	Effect
1	Field arg_count has been removed from this type.	Recompilation of a client program may be broken with the error message: 'transapi_rpc_callbacks::anon-struct-transapi.h-175' has no member named 'arg_count'.
2	Field arg_order has been removed from this type.	Recompilation of a client program may be broken with the error message: 'transapi_rpc_callbacks::anon-struct-transapi.h-175' has no member named 'arg_order'.

transapi.h
[+] struct transapi_rpc_callbacks::anon-struct-transapi.h-175 (2)

to the top

Problems with Data Types, Low Severity (3)

	Change	Effect
1	Base type of field func has been changed from int()(void,enum XMLDIFF_OP,xmlNodePtr,struct nc_err) to int()(void,enum XMLDIFF_OP,xmlNodePtr,xmlNodePtr,struct nc_err).	Recompilation of a client program may be broken.

	Change	Effect
1	Field version has been added to this type.	This field will not be initialized or used by old client applications.

	Change	Effect
1	Base type of field func has been changed from *nc_reply()(xmlNodePtr) to nc_reply()(xmlNodePtr)**.	Recompilation of a client program may be broken.

transapi.h
[+] struct clbk (1)
[+] struct transapi (1)
[+] struct transapi_rpc_callbacks::anon-struct-transapi.h-175 (1)

to the top

Problems with Symbols, Low Severity (2)

	Change	Effect
1	Base type of 1st parameter func has been changed from int()(char const,LIBSSH2_SESSION) to int()(char const*,ssh_session).	Recompilation of a client program may be broken.

	Change	Effect
1	Base type of 1st parameter func has been changed from void()(char const,int,char const,int,int,LIBSSH2_USERAUTH_KBDINT_PROMPT const,LIBSSH2_USERAUTH_KBDINT_RESPONSE,void) to void()(char const,char const,char const*,int).	Recompilation of a client program may be broken.

callbacks_ssh.h
[+] nc_callback_ssh_host_authenticity_check ( int(*func)(char const*, LIBSSH2_SESSION*) ) (1)
[+] nc_callback_sshauth_interactive ( void(*func)(char const*, int, char const*, int, int, LIBSSH2_USERAUTH_KBDINT_PROMPT const*, LIBSSH2_USERAUTH_KBDINT_RESPONSE*, void**) ) (1)

to the top

Problems with Constants, Low Severity (4)

	Change	Effect
1	The value of constant NC_INIT_ALL has been changed from 0xffffcfff to 0xffff8fff.	Recompilation of a client program may be broken.

	Change	Effect
1	The value of constant NC_INIT_KEEPALIVECHECK has been changed from 0x00000088 to 0x00000080.	Recompilation of a client program may be broken.

	Change	Effect
1	The value of constant NC_INIT_NACM has been changed from 0x00000104 to 0x00000004.	Recompilation of a client program may be broken.

	Change	Effect
1	The value of constant TRANSAPI_VERSION has been changed from 5 to 6.	Recompilation of a client program may be broken.

netconf.h
[+] NC_INIT_ALL
[+] NC_INIT_KEEPALIVECHECK
[+] NC_INIT_NACM

transapi.h
[+] TRANSAPI_VERSION

to the top

Other Changes in Symbols (5)

	Change	Effect
1	Type of return value has been changed from void to char*.	No effect.

	Change	Effect
1	1st parameter private has been renamed to privkey.	No effect.
2	2nd parameter public has been renamed to pubkey.	No effect.
3	Type of return value has been changed from void to int.	No effect.

	Change	Effect
1	4th parameter namespace has been renamed to ns.	No effect.

callbacks_ssh.h
[+] nc_callback_sshauth_interactive ( void(*func)(char const*, int, char const*, int, int, LIBSSH2_USERAUTH_KBDINT_PROMPT const*, LIBSSH2_USERAUTH_KBDINT_RESPONSE*, void**) ) (1)
[+] nc_set_keypair_path ( char const* private, char const* public ) (3)

datastore.h
[+] ncds_model_info ( char const* path, char** name, char** version, char** namespace, char** prefix, char*** rpcs, char*** notifs ) (1)

to the top

Other Changes in Constants (2)

	Change	Effect
1	The constant NC_INIT_CLIENT with value 0x00004000 has been added.	No effect.

	Change	Effect
1	The constant NC_INIT_LIBSSH_PTHREAD with value 0x00000200 has been added.	No effect.

netconf.h
[+] NC_INIT_CLIENT
[+] NC_INIT_LIBSSH_PTHREAD

to the top

Header Files (21)

to the top

Shared Libraries (3)

libnetconf.so
libnetconf.so.0
libnetconf.so.0.9.0

to the top

API compatibility report for the libnetconf library between 0.9.0 and 0.10.0 versions on x86_64

Test Info

Test Results

Problem Summary

Added Symbols (5)

Removed Symbols (1)

Problems with Data Types, High Severity (1)

Problems with Data Types, Medium Severity (2)

Problems with Data Types, Low Severity (4)

Problems with Symbols, Low Severity (7)

Problems with Constants, Low Severity (3)

Other Changes in Constants (2)

Header Files (21)

Shared Libraries (3)

Test Info

Test Results

Problem Summary

Added Symbols (5)

Removed Symbols (1)

Problems with Data Types, High Severity (2)

Problems with Data Types, Low Severity (3)

Problems with Symbols, Low Severity (2)

Problems with Constants, Low Severity (4)

Other Changes in Symbols (5)

Other Changes in Constants (2)

Header Files (21)

Shared Libraries (3)