Binary compatibility report for the MatrixSSL library between 3.1.2 and 3.1.3 versions on x86

Test Info

Library Name	MatrixSSL
Version #1	3.1.2
Version #2	3.1.3
CPU Architecture	x86
GCC Version	4.5

Test Results

Total Header Files	1
Total Shared Libraries	1
Total Symbols / Types	176 / 117
Verdict	Incompatible (32.39%)

Problem Summary

	Severity	Count
Added Symbols	-	14
Removed Symbols	High	2
Problems with Data Types	High	4
	Medium	7
	Low	16
Problems with Symbols	High	1
	Medium	1
	Low	0
Problems with Constants	Low	0

Added Symbols (14)

cryptoApi.h, libmatrixssl.so
psGetPrng ( psRandom_t* ctx, unsigned char* bytes, uint32 size )
psInitPrng ( psRandom_t* ctx )
psYarrowAddEntropy ( unsigned char* in, uint32 inlen, psYarrow_t* prng )
psYarrowDone ( psYarrow_t* ctx )
psYarrowExport ( unsigned char* out, uint32* outlen, psYarrow_t* ctx )
psYarrowImport ( unsigned char* in, uint32 inlen, psYarrow_t* ctx )
psYarrowRead ( unsigned char* out, uint32 outlen, psYarrow_t* cx )
psYarrowReseed ( psYarrow_t* ctx )
psYarrowStart ( psYarrow_t* ctx )

matrixssllib.h, libmatrixssl.so
csRsaDecryptPriv ( psPool_t* pool, psPubKey_t* key, unsigned char* in, uint32 inlen, unsigned char* out, uint32 outlen )
csRsaDecryptPub ( psPool_t* pool, psPubKey_t* key, unsigned char* in, uint32 inlen, unsigned char* out, uint32 outlen )
csRsaEncryptPriv ( psPool_t* pool, psPubKey_t* key, unsigned char* in, uint32 inlen, unsigned char* out, uint32 outlen )
csRsaEncryptPub ( psPool_t* pool, psPubKey_t* key, unsigned char* in, uint32 inlen, unsigned char* out, uint32 outlen )
matrixSslGetPrngData ( unsigned char* bytes, uint32 size )

to the top

Removed Symbols (2)

cryptoApi.h, libmatrixssl.so
pkcs5pbkdf1 ( unsigned char* pass, uint32 passlen, unsigned char* salt, int32 iter, unsigned char* key )

matrixssllib.h, libmatrixssl.so
sslActivatePublicCipher ( ssl_t* ssl )

to the top

Problems with Data Types, High Severity (4)

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

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

matrixssllib.h
[+] struct ssl (2)
[+] struct sslCipherSpec_t (2)

to the top

Problems with Symbols, High Severity (1)

	Change	Effect
1	Parameter ssl of type ssl_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.

matrixssllib.h, libmatrixssl.so
[+] sslGetCipherSpecList ( unsigned char* c, int32 len, int32 addScsv ) (1)

to the top

Problems with Data Types, Medium Severity (7)

	Change	Effect
1	Field decryptPriv has been removed from the middle position of this structural type.	1) Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications. 2) Size of the inclusive type has been changed.
2	Field encryptPriv has been removed from the middle position of this structural type.	1) Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications. 2) Size of the inclusive type has been changed.

	Change	Effect
1	Field decryptPriv has been removed from the middle position of this structural type.	1) Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications. 2) Size of the inclusive type has been changed.
2	Field encryptPriv has been removed from the middle position of this structural type.	1) Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications. 2) Size of the inclusive type has been changed.

	Change	Effect
1	Size of field issuer has been changed from 52 bytes to 76 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 subject has been changed from 52 bytes to 76 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	Type of field sigHash has been changed from unsigned char[20] (20 bytes) to unsigned char[32] (32 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.

matrixssllib.h
[+] struct ssl (2)
[+] struct sslCipherSpec_t (2)

x509.h
[+] struct psCert (3)

to the top

Problems with Symbols, Medium Severity (1)

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

matrixssllib.h, libmatrixssl.so
[+] sslGetCipherSpecListLen ( ) (1)

to the top

Problems with Data Types, Low Severity (16)

	Change	Effect
1	Size of this type has been changed from 2476 bytes to 2460 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 48 bytes to 32 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 224 bytes to 284 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field commonNameType has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
2	Field countryLen has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
3	Field countryType has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
4	Field localityLen has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
5	Field localityType has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
6	Field orgUnitLen has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
7	Field orgUnitType has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
8	Field organizationLen has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
9	Field organizationType has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
10	Field stateLen has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
11	Field stateType has been added to this type.	Size of the inclusive type has been changed. ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.
12	Size of this type has been changed from 52 bytes to 76 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
13	Field commonNameLen has been added to this type.	ATTENTION: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.

matrixssllib.h
[+] struct ssl (1)
[+] struct sslCipherSpec_t (1)

x509.h
[+] struct psCert (1)
[+] struct x509DNattributes_t (13)

to the top

Header Files (1)

matrixsslApi.h

to the top

Shared Libraries (1)

libmatrixssl.so

to the top