Binary compatibility report for the libnfc library between 1.5.0 and 1.5.1 versions on x86

Test Info

Library Name	libnfc
Version #1	1.5.0
Version #2	1.5.1
CPU Type	x86
GCC Version	4.6.1

Test Results

Total Header Files	3
Total Shared Libraries	1
Total Symbols / Types	29 / 64
Verdict	Incompatible (48.28%)

Problem Summary

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

Added Symbols (2)

nfc.h, libnfc.so.2.0.0
nfc_idle ( nfc_device_t* pnd )
nfc_initiator_poll_target ( nfc_device_t* pnd, nfc_modulation_t const* pnmTargetTypes, size_t const szTargetTypes, uint8_t const uiPollNr, uint8_t const uiPeriod, nfc_target_t* pnt )

to the top

Removed Symbols (1)

nfc.h, libnfc.so.2.0.0
nfc_initiator_poll_targets ( nfc_device_t* pnd, nfc_modulation_t const* pnmTargetTypes, size_t const szTargetTypes, byte_t const btPollNr, byte_t const btPeriod, nfc_target_t* pntTargets, size_t* pszTargetFound )

to the top

Problems with Data Types, High Severity (1)

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

nfc-types.h
[+] struct nfc_device_desc_t (1)

to the top

Problems with Data Types, Medium Severity (6)

	Change	Effect
1	Value of member NMT_DEP has been changed from 4 to 7.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
2	Value of member NMT_FELICA has been changed from 2 to 6.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
3	Value of member NMT_ISO14443B has been changed from 1 to 2.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
4	Value of member NMT_JEWEL has been changed from 3 to 1.	Applications may execute a wrong branch of code in the library and therefore change the behavior.

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

nfc-types.h
[+] enum nfc_modulation_type_t (4)
[+] struct nfc_device_desc_t (1)
[+] struct nfc_device_t (1)

to the top

Problems with Symbols, Medium Severity (3)

	Change	Effect
1	Parameter timeout of type timeval* has been added to the calling stack.	This parameter will not be initialized by old clients.

	Change	Effect
1	Parameter timout of type timeval* has been added to the calling stack.	This parameter will not be initialized by old clients.

	Change	Effect
1	Parameter timout of type timeval* has been added to the calling stack.	This parameter will not be initialized by old clients.

nfc.h, libnfc.so.2.0.0
[+] nfc_initiator_transceive_bytes ( nfc_device_t* pnd, byte_t const* pbtTx, size_t const szTx, byte_t* pbtRx, size_t* pszRx ) (1)
[+] nfc_target_receive_bytes ( nfc_device_t* pnd, byte_t* pbtRx, size_t* pszRx ) (1)
[+] nfc_target_send_bytes ( nfc_device_t* pnd, byte_t const* pbtTx, size_t const szTx ) (1)

to the top

Problems with Data Types, Low Severity (5)

	Change	Effect
1	Size of this type has been changed from 272 bytes to 332 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 288 bytes to 280 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field nci has been added to this type.	NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
2	Field nii has been added to this type.	NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
3	Field nsi has been added to this type.	NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.

nfc-types.h
[+] struct nfc_device_desc_t (1)
[+] struct nfc_device_t (1)
[+] union nfc_target_info_t (3)

to the top

Problems with Symbols, Low Severity (2)

	Change	Effect
1	Base type of 8th parameter cycles has been changed from unsigned short (2 bytes) to unsigned int (4 bytes).	Memory stored by pointer may be incorrectly initialized by applications.

	Change	Effect
1	Base type of 6th parameter cycles has been changed from unsigned short (2 bytes) to unsigned int (4 bytes).	Memory stored by pointer may be incorrectly initialized by applications.

nfc.h, libnfc.so.2.0.0
[+] nfc_initiator_transceive_bits_timed ( nfc_device_t* pnd, byte_t const* pbtTx, size_t const szTxBits, byte_t const* pbtTxPar, byte_t* pbtRx, size_t* pszRxBits, byte_t* pbtRxPar, uint16_t* cycles ) (1)
[+] nfc_initiator_transceive_bytes_timed ( nfc_device_t* pnd, byte_t const* pbtTx, size_t const szTx, byte_t* pbtRx, size_t* pszRx, uint16_t* cycles ) (1)

to the top

Problems with Constants (1)

	Change	Effect
1	The value of constant ETGUIDNOTSUP has been changed from 0x0100 to 0xFF00.	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.

nfc.h
[+] ETGUIDNOTSUP

to the top

Other Changes in Data Types (5)

	Change	Effect
1	The member NDO_FORCE_ISO14443_B with value 67 has been added.	No effect.
2	The member NDO_FORCE_SPEED_106 with value 80 has been added.	No effect.

	Change	Effect
1	The member NMT_ISO14443B2CT with value 5 has been added.	No effect.
2	The member NMT_ISO14443B2SR with value 4 has been added.	No effect.
3	The member NMT_ISO14443BI with value 3 has been added.	No effect.

nfc-types.h
[+] enum nfc_device_option_t (2)
[+] enum nfc_modulation_type_t (3)

to the top

Header Files (3)

nfc-emulation.h
nfc-types.h
nfc.h

to the top

Shared Libraries (1)

libnfc.so.2.0.0

to the top