Binary compatibility report for the libnfc library between 1.3.9 and 1.4.0 versions on x86

Test Info

Library Name	libnfc
Version #1	1.3.9
Version #2	1.4.0
CPU Type	x86
GCC Version	4.6.1

Test Results

Total Header Files	3
Total Shared Libraries	1
Total Symbols / Types	24 / 62
Verdict	Incompatible (47.92%)

Problem Summary

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

Added Symbols (2)

nfc.h, libnfc.so.0.0.0
iso14443a_crc_append ( byte_t* pbtData, size_t szLen )
iso14443a_locate_historical_bytes ( byte_t* pbtAts, size_t szAts, size_t* pszTk )

to the top

Removed Symbols (1)

nfc.h, libnfc.so.0.0.0
append_iso14443a_crc ( byte_t* pbtData, size_t szLen )

to the top

Problems with Data Types, High Severity (2)

	Change	Effect
1	Field abtAtqb 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.
2	Field btParam1 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_iso14443b_info_t (2)

to the top

Problems with Symbols, High Severity (9)

	Change	Effect
1	Parameter ndm of type nfc_dep_mode_t const 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.
2	Parameter nbr of type nfc_baud_rate_t const 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.
3	Parameter pndiInitiator of type nfc_dep_info_t const* 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.
4	Parameter pnt of type nfc_target_t* 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.
5	2nd middle parameter nmInitModulation 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.
6	3rd middle parameter pbtPidData 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.
7	4th middle parameter szPidDataLen 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.
8	5th middle parameter pbtNFCID3i 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 pnt of type nfc_target_t* 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.

nfc.h, libnfc.so.0.0.0
[+] nfc_initiator_select_dep_target ( nfc_device_t* pnd, nfc_modulation_t const nmInitModulation, byte_t const* pbtPidData, size_t const szPidDataLen, byte_t const* pbtNFCID3i, size_t const szNFCID3iDataLen, byte_t const* pbtGbData, size_t const szGbDataLen, nfc_target_info_t* pti ) (8)
[+] nfc_target_init ( nfc_device_t* pnd, byte_t* pbtRx, size_t* pszRxBits ) (1)

to the top

Problems with Data Types, Medium Severity (15)

	Change	Effect
1	Type of this type has been changed from enum to struct.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field bAutoIso14443_4 has been added at the middle position of this structural type.	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	Type of field abtAts has been changed from byte_t[36] (36 bytes) to byte_t[254] (254 bytes).	1) This field may be incorrectly initialized or accessed by applications. 2) Size of the inclusive type has changed.

	Change	Effect
1	Field abtProtocolInfo 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	Field abtPupi 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.
3	Field abtInf 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.
4	Field btCid 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.
5	Field btParam3 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.
6	Field btParam4 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.
7	Field szInfLen 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.

	Change	Effect
1	Size of field nti has been changed from 89 bytes to 275 bytes.	1) Size of the inclusive type has changed. 2) Previous accesses of applications and library functions to this field may be broken.
2	Field ntt 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.

	Change	Effect
1	Size of field nai has been changed from 57 bytes to 275 bytes.	1) Size of the inclusive type has changed. 2) Previous accesses of applications and library functions to this field and fields at higher positions of the structure definition may be broken.
2	Size of field nbi has been changed from 89 bytes to 12 bytes.	1) Size of the inclusive type has changed. 2) Previous accesses of applications and library functions to this field and fields at higher positions of the structure definition may be broken.
3	Size of field ndi has been changed from 13 bytes to 71 bytes.	1) Size of the inclusive type has changed. 2) Previous accesses of applications and library functions to this field may be broken.

nfc-types.h
[+] enum nfc_modulation_t (1)
[+] struct nfc_device_t (1)
[+] struct nfc_iso14443a_info_t (1)
[+] struct nfc_iso14443b_info_t (7)
[+] struct nfc_target_t (2)
[+] union nfc_target_info_t (3)

to the top

Problems with Symbols, Medium Severity (5)

	Change	Effect
1	6th parameter szNFCID3iDataLen has been removed from the calling stack.	This parameter will be ignored by the function.
2	7th parameter pbtGbData has been removed from the calling stack.	This parameter will be ignored by the function.
3	8th parameter szGbDataLen has been removed from the calling stack.	This parameter will be ignored by the function.
4	9th parameter pti has been removed from the calling stack.	This parameter will be ignored by the function.

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

nfc.h, libnfc.so.0.0.0
[+] nfc_initiator_select_dep_target ( nfc_device_t* pnd, nfc_modulation_t const nmInitModulation, byte_t const* pbtPidData, size_t const szPidDataLen, byte_t const* pbtNFCID3i, size_t const szNFCID3iDataLen, byte_t const* pbtGbData, size_t const szGbDataLen, nfc_target_info_t* pti ) (4)
[+] nfc_target_init ( nfc_device_t* pnd, byte_t* pbtRx, size_t* pszRxBits ) (1)

to the top

Problems with Data Types, Low Severity (18)

	Change	Effect
1	Field abtGB has been added to this type.	Size of the inclusive type has been changed. 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 btPP has been added to this type.	Size of the inclusive type has been changed. 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 btTO has been added to this type.	Size of the inclusive type has been changed. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
4	Field ndm has been added to this type.	Size of the inclusive type has been changed. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
5	Field szGB has been added to this type.	Size of the inclusive type has been changed. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
6	Size of this type has been changed from 13 bytes to 71 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
7	Field NFCID3i has been renamed to abtNFCID3.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
8	Field btBRt has been renamed to btBR.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
9	Field btBSt has been renamed to btBS.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.

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

	Change	Effect
1	Size of this type has been changed from 57 bytes to 275 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 89 bytes to 12 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	Field abtId has been renamed to abtApplicationData.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
3	Field btParam2 has been renamed to ui8CardIdentifier.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Field nm has been added to this type.	Size of the inclusive type has been changed. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
2	Size of this type has been changed from 93 bytes to 283 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 89 bytes to 275 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

nfc-types.h
[+] struct nfc_dep_info_t (9)
[+] struct nfc_device_t (2)
[+] struct nfc_iso14443a_info_t (1)
[+] struct nfc_iso14443b_info_t (3)
[+] struct nfc_target_t (2)
[+] union nfc_target_info_t (1)

to the top

Problems with Symbols, Low Severity (13)

	Change	Effect
1	2nd parameter nmInitModulation has been renamed to nm.	Renaming of a parameter may indicate a change in its semantic meaning.
2	3rd parameter anti has been renamed to ant.	Renaming of a parameter may indicate a change in its semantic meaning.
3	Base type of 3rd parameter anti has been changed from nfc_target_info_t (89 bytes) to nfc_target_t (283 bytes).	Memory stored by pointer may be incorrectly initialized by applications.

	Change	Effect
1	2nd parameter pnttTargetTypes has been renamed to pnmTargetTypes.	Renaming of a parameter may indicate a change in its semantic meaning.
2	Base type of 2nd parameter pnttTargetTypes has been changed from nfc_target_type_t (4 bytes) to nfc_modulation_t (8 bytes).	Memory stored by pointer may be incorrectly initialized by applications.

	Change	Effect
1	2nd parameter nmInitModulation has been renamed to nm.	Renaming of a parameter may indicate a change in its semantic meaning.
2	4th parameter szInitDataLen has been renamed to szInitData.	Renaming of a parameter may indicate a change in its semantic meaning.
3	5th parameter pti has been renamed to pnt.	Renaming of a parameter may indicate a change in its semantic meaning.
4	Base type of 5th parameter pti has been changed from nfc_target_info_t (89 bytes) to nfc_target_t (283 bytes).	Memory stored by pointer may be incorrectly initialized by applications.

	Change	Effect
1	3rd parameter szTxLen has been renamed to szTx.	Renaming of a parameter may indicate a change in its semantic meaning.
2	5th parameter pszRxLen has been renamed to pszRx.	Renaming of a parameter may indicate a change in its semantic meaning.

	Change	Effect
1	3rd parameter pszRxLen has been renamed to pszRx.	Renaming of a parameter may indicate a change in its semantic meaning.

	Change	Effect
1	3rd parameter szTxLen has been renamed to szTx.	Renaming of a parameter may indicate a change in its semantic meaning.

nfc.h, libnfc.so.0.0.0
[+] nfc_initiator_list_passive_targets ( nfc_device_t* pnd, nfc_modulation_t const nmInitModulation, nfc_target_info_t* anti, size_t const szTargets, size_t* pszTargetFound ) (3)
[+] nfc_initiator_poll_targets ( nfc_device_t* pnd, nfc_target_type_t const* pnttTargetTypes, size_t const szTargetTypes, byte_t const btPollNr, byte_t const btPeriod, nfc_target_t* pntTargets, size_t* pszTargetFound ) (2)
[+] nfc_initiator_select_passive_target ( nfc_device_t* pnd, nfc_modulation_t const nmInitModulation, byte_t const* pbtInitData, size_t const szInitDataLen, nfc_target_info_t* pti ) (4)
[+] nfc_initiator_transceive_bytes ( nfc_device_t* pnd, byte_t const* pbtTx, size_t const szTxLen, byte_t* pbtRx, size_t* pszRxLen ) (2)
[+] nfc_target_receive_bytes ( nfc_device_t* pnd, byte_t* pbtRx, size_t* pszRxLen ) (1)
[+] nfc_target_send_bytes ( nfc_device_t* pnd, byte_t const* pbtTx, size_t const szTxLen ) (1)

to the top

Other Changes in Data Types (1)

	Change	Effect
1	The member NDO_FORCE_ISO14443_A with value 66 has been added.	No effect.

nfc-types.h
[+] enum nfc_device_option_t (1)

to the top

Header Files (3)

nfc-messages.h
nfc-types.h
nfc.h

to the top

Shared Libraries (1)

libnfc.so.0.0.0

to the top