libnetconf: 0.7.1 to 0.8.0 compatibility report

Test Info

Library Name	libnetconf
Version #1	0.7.1
Version #2	0.8.0
CPU Type	x86_64
GCC Version	4.7
Subject	Binary Compatibility

Test Results

Total Header Files	19
Total Shared Libraries	1
Total Symbols / Types	169 / 168
Verdict	Incompatible (0.6%)

Problem Summary

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

Added Symbols (17)

callhome.h, libnetconf.so.0.8.0
nc_callhome_accept ( char const* username, struct nc_cpblts const* cpblts, int* timeout )
nc_callhome_connect ( struct nc_mngmt_server* host_list, uint8_t reconnect_secs, uint8_t reconnect_count, char const* server_path, char*const* argv, int* com_socket )
nc_callhome_listen ( unsigned int port )
nc_callhome_listen_stop ( )
nc_callhome_mngmt_server_add ( struct nc_mngmt_server* list, char const* host, char const* port )
nc_callhome_mngmt_server_free ( struct nc_mngmt_server* list )
nc_callhome_mngmt_server_getactive ( struct nc_mngmt_server* list )
nc_callhome_mngmt_server_rm ( struct nc_mngmt_server* list, struct nc_mngmt_server* remove )

datastore.h, libnetconf.so.0.8.0
ncds_add_augment_transapi ( char const* model_path, char const* callbacks_path )

datastore_xml.h, libnetconf.so.0.8.0
ncds_add_augment_transapi_static ( char const* model_path, struct transapi const* transapi )

libnetconf_tls.h, libnetconf.so.0.8.0
nc_tls_destroy ( )
nc_tls_init ( char const* peer_cert, char const* peer_key, char const* CAfile, char const* CApath )

messages.h, libnetconf.so.0.8.0
nc_reply_data_ns ( char const* data, char const* ns )
nc_reply_get_data_ns ( nc_reply const* reply )

session.h, libnetconf.so.0.8.0
nc_session_get_transport ( struct nc_session const* session )

transport.h, libnetconf.so.0.8.0
nc_session_accept_username ( struct nc_cpblts const* capabilities, char const* username )
nc_session_transport ( NC_TRANSPORT proto )

to the top

Problems with Data Types, Medium Severity (7)

	Change	Effect
1	Field clbks_order 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	The relative position of field config_modified has been changed from 5 to 6.	Applications will access incorrect memory when attempting to access this field.
3	The relative position of field data_clbks has been changed from 2 to 3.	Applications will access incorrect memory when attempting to access this field.
4	The relative position of field erropt has been changed from 6 to 7.	Applications will access incorrect memory when attempting to access this field.
5	The relative position of field get_state has been changed from 7 to 2.	Applications will access incorrect memory when attempting to access this field.
6	The relative position of field ns_mapping has been changed from 4 to 5.	Applications will access incorrect memory when attempting to access this field.
7	The relative position of field rpc_clbks has been changed from 3 to 4.	Applications will access incorrect memory when attempting to access this field.

transapi.h
[+] struct transapi (7)

to the top

Problems with Symbols, Medium Severity (1)

	Change	Effect
1	Type of 1st parameter session has been changed from struct nc_session const* to struct nc_session* (became non-const).	This function may change parameter session, but it will be treated as const by old client applications. This may result in crash or incorrect behavior of applications.

session.h, libnetconf.so.0.7.1
[+] nc_session_notif_allowed ( struct nc_session const* session ) (1)

to the top

Problems with Data Types, Low Severity (3)

	Change	Effect
1	Size of this type has been changed from 64 bytes to 72 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	The pointer level of field ns_mapping has been decreased from 2 to 1.	The library functions will treat the value of this field as the lower-dimension array and will not read all elements. This may change the behavior of applications.
3	Type of field ns_mapping has been changed from char const** to struct ns_pair*.	Replacement of the field data type may indicate a change in the semantic meaning of the field.

transapi.h
[+] struct transapi (3)

to the top

Other Changes in Data Types (2)

	Change	Effect
1	The member NCDS_TYPE_ERROR with value -1 has been added.	No effect.

	Change	Effect
1	Field ns_mapping became non-const.	No effect.

datastore.h
[+] enum NCDS_TYPE (1)

transapi.h
[+] struct transapi (1)

to the top

Header Files (19)

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

to the top

Shared Libraries (1)

libnetconf.so.0.7.1

to the top

Test Info

Library Name	libnetconf
Version #1	0.7.1
Version #2	0.8.0
CPU Type	x86_64
GCC Version	4.7
Subject	Source Compatibility

Test Results

Total Header Files	19
Total Shared Libraries	1
Total Symbols / Types	169 / 168
Verdict	Incompatible (0.6%)

Problem Summary

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

Added Symbols (19)

callhome.h
nc_callhome_accept ( char const* username, struct nc_cpblts const* cpblts, int* timeout )
nc_callhome_connect ( struct nc_mngmt_server* host_list, uint8_t reconnect_secs, uint8_t reconnect_count, char const* server_path, char*const* argv, int* com_socket )
nc_callhome_listen ( unsigned int port )
nc_callhome_listen_stop ( )
nc_callhome_mngmt_server_add ( struct nc_mngmt_server* list, char const* host, char const* port )
nc_callhome_mngmt_server_free ( struct nc_mngmt_server* list )
nc_callhome_mngmt_server_getactive ( struct nc_mngmt_server* list )
nc_callhome_mngmt_server_rm ( struct nc_mngmt_server* list, struct nc_mngmt_server* remove )

datastore.h
ncds_add_augment_transapi ( char const* model_path, char const* callbacks_path )

datastore_xml.h
ncds_add_augment_transapi_static ( char const* model_path, struct transapi const* transapi )

libnetconf_tls.h
nc_tls_destroy ( )
nc_tls_init ( char const* peer_cert, char const* peer_key, char const* CAfile, char const* CApath )

messages.h
nc_reply_data_ns ( char const* data, char const* ns )
nc_reply_get_data_ns ( nc_reply const* reply )

netconf.h
nc_datetime2time ( char const* datetime )
nc_time2datetime ( time_t time, char const* tz )

session.h
nc_session_get_transport ( struct nc_session const* session )

transport.h
nc_session_accept_username ( struct nc_cpblts const* capabilities, char const* username )
nc_session_transport ( NC_TRANSPORT proto )

to the top

Problems with Data Types, Medium Severity (1)

	Change	Effect
1	The pointer level of field ns_mapping has been increased from 2 to 1.	Recompilation of a client program may be broken.

transapi.h
[+] struct transapi (1)

to the top

Problems with Symbols, Medium Severity (1)

	Change	Effect
1	Type of 1st parameter session has been changed from struct nc_session const* to struct nc_session* (became non-const).	Recompilation of a client program may be broken.

session.h
[+] nc_session_notif_allowed ( struct nc_session const* session ) (1)

to the top

Problems with Data Types, Low Severity (1)

	Change	Effect
1	Type of field ns_mapping has been changed from char const** to struct ns_pair*.	Recompilation of a client program may be broken.

transapi.h
[+] struct transapi (1)

to the top

Problems with Constants (1)

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

transapi.h
[+] TRANSAPI_VERSION

to the top

Other Changes in Data Types (9)

	Change	Effect
1	The member NCDS_TYPE_ERROR with value -1 has been added.	No effect.

	Change	Effect
1	Field clbks_order has been added to this type.	No effect.
2	Field ns_mapping became non-const.	No effect.
3	The relative position of field config_modified has been changed from 5 to 6.	No effect.
4	The relative position of field data_clbks has been changed from 2 to 3.	No effect.
5	The relative position of field erropt has been changed from 6 to 7.	No effect.
6	The relative position of field get_state has been changed from 7 to 2.	No effect.
7	The relative position of field ns_mapping has been changed from 4 to 5.	No effect.
8	The relative position of field rpc_clbks has been changed from 3 to 4.	No effect.

datastore.h
[+] enum NCDS_TYPE (1)

transapi.h
[+] struct transapi (8)

to the top

Header Files (19)

to the top

Shared Libraries (1)

libnetconf.so.0.7.1

to the top

API compatibility report for the libnetconf library between 0.7.1 and 0.8.0 versions on x86_64

Test Info

Test Results

Problem Summary

Added Symbols (17)

Problems with Data Types, Medium Severity (7)

Problems with Symbols, Medium Severity (1)

Problems with Data Types, Low Severity (3)

Other Changes in Data Types (2)

Header Files (19)

Shared Libraries (1)

Test Info

Test Results

Problem Summary

Added Symbols (19)

Problems with Data Types, Medium Severity (1)

Problems with Symbols, Medium Severity (1)

Problems with Data Types, Low Severity (1)

Problems with Constants (1)

Other Changes in Data Types (9)

Header Files (19)

Shared Libraries (1)