libnetconf: 0.2.3 to 0.3.0 compatibility report

Test Info

Library Name	libnetconf
Version #1	0.2.3
Version #2	0.3.0
CPU Type	x86_64
GCC Version	4.7
Subject	Binary Compatibility

Test Results

Total Header Files	10
Total Shared Libraries	1
Total Symbols / Types	124 / 86
Verdict	Incompatible (4.4%)

Problem Summary

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

Added Symbols (17)

messages.h, libnetconf.so.0.3.0
nc_rpc_capability_attr ( nc_rpc* rpc, enum NC_CAP_ATTR attr, ... )
nc_rpc_get_testopt ( nc_rpc const* rpc )

messages_xml.h, libnetconf.so.0.3.0
ncxml_filter_new ( NC_FILTER_TYPE type, ... )
ncxml_reply_build ( xmlDocPtr reply_dump )
ncxml_reply_data ( xmlNodePtr const data )
ncxml_reply_dump ( nc_reply const* reply )
ncxml_reply_get_data ( nc_reply const* reply )
ncxml_rpc_build ( xmlDocPtr rpc_dump )
ncxml_rpc_copyconfig ( NC_DATASTORE source, NC_DATASTORE target, ... )
ncxml_rpc_dump ( nc_rpc const* rpc )
ncxml_rpc_editconfig ( NC_DATASTORE target, NC_DATASTORE source, NC_EDIT_DEFOP_TYPE default_operation, enum NC_EDIT_ERROPT_TYPE error_option, enum NC_EDIT_TESTOPT_TYPE test_option, ... )
ncxml_rpc_generic ( xmlNodePtr const data )
ncxml_rpc_get_config ( nc_rpc const* rpc )
ncxml_rpc_get_op_content ( nc_rpc const* rpc )

notifications_xml.h, libnetconf.so.0.3.0
ncxmlntf_event_new ( time_t etime, enum NCNTF_EVENT event, ... )
ncxmlntf_notif_create ( time_t event_time, xmlNodePtr const content )
ncxmlntf_notif_get_content ( nc_ntf* notif )

to the top

Problems with Symbols, High Severity (2)

	Change	Effect
1	3rd middle parameter withdefaults has been removed from the calling stack.	Layout of parameter's stack has been changed and therefore parameters at higher positions in the stack may be incorrectly initialized by applications.

	Change	Effect
1	Parameter source of type NC_DATASTORE has been added to the calling stack at the middle position.	Layout of parameter's stack has been changed and therefore parameters at higher positions in the stack may be incorrectly initialized by applications.

messages.h, libnetconf.so.0.2.3
[+] nc_rpc_copyconfig ( NC_DATASTORE source, NC_DATASTORE target, enum NCWD_MODE withdefaults, char const* data ) (1)
[+] nc_rpc_editconfig ( NC_DATASTORE target, NC_EDIT_DEFOP_TYPE default_operation, enum NC_EEDIT_RROPT_TYPE error_option, char const* data ) (1)

to the top

Problems with Data Types, Medium Severity (3)

	Change	Effect
1	Value of member NC_DATASTORE_CANDIDATE has been changed from 4 to 5.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
2	Value of member NC_DATASTORE_RUNNING has been changed from 2 to 3.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
3	Value of member NC_DATASTORE_STARTUP has been changed from 3 to 4.	Applications may execute a wrong branch of code in the library and therefore change the behavior.

netconf.h
[+] enum NC_DATASTORE_TYPE (3)

to the top

Problems with Symbols, Medium Severity (6)

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

	Change	Effect
1	4th parameter data has been removed from the calling stack.	This parameter will be ignored by the function.

	Change	Effect
1	Parameter test_option of type enum NC_EDIT_TESTOPT_TYPE has been added to the calling stack.	This parameter will not be initialized by old clients.

	Change	Effect
1	2nd parameter withdefaults has been removed from the calling stack.	This parameter will be ignored by the function.

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

	Change	Effect
1	3rd parameter withdefaults has been removed from the calling stack.	This parameter will be ignored by the function.

messages.h, libnetconf.so.0.2.3
[+] nc_reply_get_type ( nc_reply const* reply ) (1)
[+] nc_rpc_copyconfig ( NC_DATASTORE source, NC_DATASTORE target, enum NCWD_MODE withdefaults, char const* data ) (1)
[+] nc_rpc_editconfig ( NC_DATASTORE target, NC_EDIT_DEFOP_TYPE default_operation, enum NC_EEDIT_RROPT_TYPE error_option, char const* data ) (1)
[+] nc_rpc_get ( struct nc_filter const* filter, enum NCWD_MODE withdefaults ) (1)
[+] nc_rpc_get_type ( nc_rpc const* rpc ) (1)
[+] nc_rpc_getconfig ( NC_DATASTORE source, struct nc_filter const* filter, enum NCWD_MODE withdefaults ) (1)

to the top

Problems with Data Types, Low Severity (2)

	Change	Effect
1	Name of member with value 0 has been changed from NCWD_MODE_DISABLED to NCWD_MODE_NOTSET.	Applications may execute a wrong branch of code in the library and therefore change the behavior.

	Change	Effect
1	Base type has been changed from enum NC_EEDIT_RROPT_TYPE to enum NC_EDIT_ERROPT_TYPE.	Possible incorrect initialization of parameters by applications.

netconf.h
[+] enum NCWD_MODE (1)
[+] typedef NC_EDIT_ERROPT_TYPE (1)

to the top

Problems with Symbols, Low Severity (1)

	Change	Effect
1	Type of 2nd parameter filter has been changed from char const* to ... (va_list).	The semantic meaning of the parameter may change.

messages.h, libnetconf.so.0.2.3
[+] nc_filter_new ( NC_FILTER_TYPE type, char const* filter ) (1)

to the top

Other Changes in Data Types (1)

	Change	Effect
1	The member NC_DATASTORE_URL with value 2 has been added.	No effect.

netconf.h
[+] enum NC_DATASTORE_TYPE (1)

to the top

Header Files (10)

callbacks.h
datastore.h
error.h
libnetconf.h
messages.h
netconf.h
notifications.h
session.h
ssh.h
with_defaults.h

to the top

Shared Libraries (1)

libnetconf.so.0.2.3

to the top

Test Info

Library Name	libnetconf
Version #1	0.2.3
Version #2	0.3.0
CPU Type	x86_64
GCC Version	4.7
Subject	Source Compatibility

Test Results

Total Header Files	10
Total Shared Libraries	1
Total Symbols / Types	124 / 86
Verdict	Incompatible (7.3%)

Problem Summary

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

Added Symbols (17)

messages.h
nc_rpc_capability_attr ( nc_rpc* rpc, enum NC_CAP_ATTR attr, ... )
nc_rpc_get_testopt ( nc_rpc const* rpc )

messages_xml.h
ncxml_filter_new ( NC_FILTER_TYPE type, ... )
ncxml_reply_build ( xmlDocPtr reply_dump )
ncxml_reply_data ( xmlNodePtr const data )
ncxml_reply_dump ( nc_reply const* reply )
ncxml_reply_get_data ( nc_reply const* reply )
ncxml_rpc_build ( xmlDocPtr rpc_dump )
ncxml_rpc_copyconfig ( NC_DATASTORE source, NC_DATASTORE target, ... )
ncxml_rpc_dump ( nc_rpc const* rpc )
ncxml_rpc_editconfig ( NC_DATASTORE target, NC_DATASTORE source, NC_EDIT_DEFOP_TYPE default_operation, enum NC_EDIT_ERROPT_TYPE error_option, enum NC_EDIT_TESTOPT_TYPE test_option, ... )
ncxml_rpc_generic ( xmlNodePtr const data )
ncxml_rpc_get_config ( nc_rpc const* rpc )
ncxml_rpc_get_op_content ( nc_rpc const* rpc )

notifications_xml.h
ncxmlntf_event_new ( time_t etime, enum NCNTF_EVENT event, ... )
ncxmlntf_notif_create ( time_t event_time, xmlNodePtr const content )
ncxmlntf_notif_get_content ( nc_ntf* notif )

to the top

Problems with Data Types, High Severity (1)

	Change	Effect
1	Name of member with value 0 has been changed from NCWD_MODE_DISABLED to NCWD_MODE_NOTSET.	Recompilation of a client program may be broken with the error message: 'NCWD_MODE_DISABLED' was not declared in this scope.

netconf.h
[+] enum NCWD_MODE (1)

to the top

Problems with Symbols, High Severity (2)

	Change	Effect
1	3rd middle parameter withdefaults has been removed from the calling stack.	Recompilation of a client program may be broken.

	Change	Effect
1	Parameter source of type NC_DATASTORE has been added to the calling stack at the middle position.	Recompilation of a client program may be broken.

messages.h
[+] nc_rpc_copyconfig ( NC_DATASTORE source, NC_DATASTORE target, enum NCWD_MODE withdefaults, char const* data ) (1)
[+] nc_rpc_editconfig ( NC_DATASTORE target, NC_EDIT_DEFOP_TYPE default_operation, enum NC_EEDIT_RROPT_TYPE error_option, char const* data ) (1)

to the top

Problems with Symbols, Medium Severity (6)

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

	Change	Effect
1	4th parameter data has been removed from the calling stack.	Recompilation of a client program may be broken.

	Change	Effect
1	Parameter test_option of type enum NC_EDIT_TESTOPT_TYPE has been added to the calling stack.	Recompilation of a client program may be broken.

	Change	Effect
1	2nd parameter withdefaults has been removed from the calling stack.	Recompilation of a client program may be broken.

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

	Change	Effect
1	3rd parameter withdefaults has been removed from the calling stack.	Recompilation of a client program may be broken.

messages.h
[+] nc_reply_get_type ( nc_reply const* reply ) (1)
[+] nc_rpc_copyconfig ( NC_DATASTORE source, NC_DATASTORE target, enum NCWD_MODE withdefaults, char const* data ) (1)
[+] nc_rpc_editconfig ( NC_DATASTORE target, NC_EDIT_DEFOP_TYPE default_operation, enum NC_EEDIT_RROPT_TYPE error_option, char const* data ) (1)
[+] nc_rpc_get ( struct nc_filter const* filter, enum NCWD_MODE withdefaults ) (1)
[+] nc_rpc_get_type ( nc_rpc const* rpc ) (1)
[+] nc_rpc_getconfig ( NC_DATASTORE source, struct nc_filter const* filter, enum NCWD_MODE withdefaults ) (1)

to the top

Problems with Data Types, Low Severity (1)

	Change	Effect
1	Base type has been changed from enum NC_EEDIT_RROPT_TYPE to enum NC_EDIT_ERROPT_TYPE.	Recompilation of a client program may be broken.

netconf.h
[+] typedef NC_EDIT_ERROPT_TYPE (1)

to the top

Other Changes in Data Types (4)

	Change	Effect
1	The member NC_DATASTORE_URL with value 2 has been added.	No effect.
2	Value of member NC_DATASTORE_CANDIDATE has been changed from 4 to 5.	No effect.
3	Value of member NC_DATASTORE_RUNNING has been changed from 2 to 3.	No effect.
4	Value of member NC_DATASTORE_STARTUP has been changed from 3 to 4.	No effect.

netconf.h
[+] enum NC_DATASTORE_TYPE (4)

to the top

Other Changes in Symbols (1)

	Change	Effect
1	Type of 2nd parameter filter has been changed from char const* to ... (va_list).	No effect.

messages.h
[+] nc_filter_new ( NC_FILTER_TYPE type, char const* filter ) (1)

to the top

Header Files (10)

callbacks.h
datastore.h
error.h
libnetconf.h
messages.h
netconf.h
notifications.h
session.h
ssh.h
with_defaults.h

to the top

Shared Libraries (1)

libnetconf.so.0.2.3

to the top

API compatibility report for the libnetconf library between 0.2.3 and 0.3.0 versions on x86_64

Test Info

Test Results

Problem Summary

Added Symbols (17)

Problems with Symbols, High Severity (2)

Problems with Data Types, Medium Severity (3)

Problems with Symbols, Medium Severity (6)

Problems with Data Types, Low Severity (2)

Problems with Symbols, Low Severity (1)

Other Changes in Data Types (1)

Header Files (10)

Shared Libraries (1)

Test Info

Test Results

Problem Summary

Added Symbols (17)

Problems with Data Types, High Severity (1)

Problems with Symbols, High Severity (2)

Problems with Symbols, Medium Severity (6)

Problems with Data Types, Low Severity (1)

Other Changes in Data Types (4)

Other Changes in Symbols (1)

Header Files (10)

Shared Libraries (1)