Binary compatibility report for the libusb library between 1.0.16 and 1.0.18 versions on x86

Test Info

Library Name	libusb
Version #1	1.0.16
Version #2	1.0.18
CPU Type	x86
GCC Version	4.6.1

Test Results

Total Header Files	1
Total Shared Libraries	1
Total Symbols / Types	66 / 78
Verdict	Incompatible (5.3%)

Problem Summary

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

Added Symbols (15)

libusb.h, libusb-1.0.so.0.1.0
libusb_free_container_id_descriptor ( struct libusb_container_id_descriptor* container_id )
libusb_free_ss_endpoint_companion_descriptor ( struct libusb_ss_endpoint_companion_descriptor* ep_comp )
libusb_free_ss_usb_device_capability_descriptor ( struct libusb_ss_usb_device_capability_descriptor* ss_usb_device_cap )
libusb_free_usb_2_0_extension_descriptor ( struct libusb_usb_2_0_extension_descriptor* usb_2_0_extension )
libusb_get_bos_descriptor ( libusb_device_handle* handle, struct libusb_bos_descriptor** bos )
libusb_get_container_id_descriptor ( struct libusb_context* ctx, struct libusb_bos_dev_capability_descriptor* dev_cap, struct libusb_container_id_descriptor** container_id )
libusb_get_parent ( libusb_device* dev )
libusb_get_port_number ( libusb_device* dev )
libusb_get_port_numbers ( libusb_device* dev, uint8_t* port_numbers, int port_numbers_len )
libusb_get_port_path ( libusb_context* ctx, libusb_device* dev, uint8_t* path, uint8_t path_length )
libusb_get_ss_endpoint_companion_descriptor ( struct libusb_context* ctx, struct libusb_endpoint_descriptor const* endpoint, struct libusb_ss_endpoint_companion_descriptor** ep_comp )
libusb_get_ss_usb_device_capability_descriptor ( struct libusb_context* ctx, struct libusb_bos_dev_capability_descriptor* dev_cap, struct libusb_ss_usb_device_capability_descriptor** ss_usb_device_cap )
libusb_get_usb_2_0_extension_descriptor ( struct libusb_context* ctx, struct libusb_bos_dev_capability_descriptor* dev_cap, struct libusb_usb_2_0_extension_descriptor** usb_2_0_extension )
libusb_set_auto_detach_kernel_driver ( libusb_device_handle* dev, int enable )
libusb_setlocale ( char const* locale )

to the top

Removed Symbols (3)

libusb.h, libusb-1.0.so.2.0.0
libusb_free_ss_endpoint_comp ( struct libusb_ss_endpoint_companion_descriptor* ep_comp )
libusb_parse_bos_descriptor ( void const* buf, int len, struct libusb_bos_descriptor** bos )
libusb_parse_ss_endpoint_comp ( void const* buf, int len, struct libusb_ss_endpoint_companion_descriptor** ep_comp )

to the top

Problems with Data Types, Medium Severity (1)

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

libusb.h
[+] struct libusb_bos_descriptor (1)

to the top

Problems with Data Types, Low Severity (2)

	Change	Effect
1	Size of this type has been changed from 16 bytes to 8 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	Field usb_2_0_ext_cap has been renamed to dev_capability.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.

libusb.h
[+] struct libusb_bos_descriptor (2)

to the top

Problems with Constants, Low Severity (3)

	Change	Effect
1	The value of constant LIBUSB_DT_BOS_MAX_SIZE has been changed from ((LIBUSB_DT_BOS_SIZE) + (LIBUSB_USB_2_0_EXTENSION_DEVICE_CAPABILITY_SIZE) + (LIBUSB_SS_USB_DEVICE_CAPABILITY_SIZE)) to ((LIBUSB_DT_BOS_SIZE) + (LIBUSB_BT_USB_2_0_EXTENSION_SIZE) + (LIBUSB_BT_SS_USB_DEVICE_CAPABILITY_SIZE) + (LIBUSB_BT_CONTAINER_ID_SIZE)).	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 constant LIBUSB_SS_USB_DEVICE_CAPABILITY_SIZE with value 10 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant LIBUSB_USB_2_0_EXTENSION_DEVICE_CAPABILITY_SIZE with value 7 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

libusb.h
[+] LIBUSB_DT_BOS_MAX_SIZE
[+] LIBUSB_SS_USB_DEVICE_CAPABILITY_SIZE
[+] LIBUSB_USB_2_0_EXTENSION_DEVICE_CAPABILITY_SIZE

to the top

Other Changes in Constants (5)

	Change	Effect
1	The constant LIBUSB_BT_CONTAINER_ID_SIZE with value 20 has been added.	No effect.

	Change	Effect
1	The constant LIBUSB_BT_SS_USB_DEVICE_CAPABILITY_SIZE with value 10 has been added.	No effect.

	Change	Effect
1	The constant LIBUSB_BT_USB_2_0_EXTENSION_SIZE with value 7 has been added.	No effect.

	Change	Effect
1	The constant LIBUSB_DT_DEVICE_CAPABILITY_SIZE with value 3 has been added.	No effect.

	Change	Effect
1	The constant LIBUSB_ERROR_COUNT with value 14 has been added.	No effect.

libusb.h
[+] LIBUSB_BT_CONTAINER_ID_SIZE
[+] LIBUSB_BT_SS_USB_DEVICE_CAPABILITY_SIZE
[+] LIBUSB_BT_USB_2_0_EXTENSION_SIZE
[+] LIBUSB_DT_DEVICE_CAPABILITY_SIZE
[+] LIBUSB_ERROR_COUNT

to the top

Header Files (1)

libusb.h

to the top

Shared Libraries (1)

libusb-1.0.so.2.0.0

to the top