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

Test Info

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

Test Results

Total Header Files	1
Total Shared Libraries	1
Total Symbols / Types	188 / 121
Verdict	Incompatible (60.64%)

Problem Summary

	Severity	Count
Added Symbols	-	1
Removed Symbols	High	5
Problems with Data Types	High	0
	Medium	14
	Low	6
Problems with Symbols	High	6
	Medium	5
	Low	3
Problems with Constants	Low	7

Added Symbols (1)

matrixsslApi.h, libmatrixssl.so
matrixSslSetCipherSuiteEnabledStatus ( ssl_t* ssl, uint16 cipherId, uint32 status )

to the top

Removed Symbols (5)

coreApi.h, libmatrixssl.so
psGetFileBuf ( psPool_t* pool, char const* fileName, unsigned char** buf, int32* bufLen )

cryptoApi.h, libmatrixssl.so
pkcs1DecodePrivFile ( psPool_t* pool, char* fileName, char* password, unsigned char** DERout, uint32* DERlen )
pkcs1ParsePrivFile ( psPool_t* pool, char* fileName, char* password, psPubKey_t** outkey )
psX509ParseCertFile ( psPool_t* pool, char* fileName, psX509Cert_t** outcert, int32 flags )

matrixsslApi.h, libmatrixssl.so
matrixSslLoadRsaKeys ( sslKeys_t* keys, char const* certFile, char const* privFile, char const* privPass, char const* trustedCAFile )

to the top

Problems with Symbols, High Severity (6)

	Change	Effect
1	Type of 2nd parameter b has been changed from int32 (4 bytes) to int16 (2 bytes).	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	Type of 3rd parameter b has been changed from int32 (4 bytes) to int16 (2 bytes).	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	Type of 2nd parameter size has been changed from int32 (4 bytes) to int16 (2 bytes).	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	Type of 4th parameter toSqr has been changed from int32 (4 bytes) to int16 (2 bytes).	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	Type of 2nd parameter b has been changed from int32 (4 bytes) to int16 (2 bytes).	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	Type of 2nd parameter x has been changed from int32 (4 bytes) to int16 (2 bytes).	Layout of parameter's stack has been changed and therefore parameters at higher positions in the stack may be incorrectly initialized by applications.

pstm.h, libmatrixssl.so
[+] pstm_2expt ( pstm_int* a, int32 b ) (1)
[+] pstm_div_2d ( psPool_t* pool, pstm_int* a, int32 b, pstm_int* c, pstm_int* d ) (1)
[+] pstm_grow ( pstm_int* a, int32 size ) (1)
[+] pstm_init_copy ( psPool_t* pool, pstm_int* a, pstm_int* b, int32 toSqr ) (1)
[+] pstm_lshd ( pstm_int* a, int32 b ) (1)
[+] pstm_rshd ( pstm_int* a, int32 x ) (1)

to the top

Problems with Data Types, Medium Severity (14)

	Change	Effect
1	Field disabledCiphers 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	Type of field type has been changed from int32 (4 bytes) to uint16 (2 bytes).	This field may be incorrectly initialized or accessed by applications.

	Change	Effect
1	Type of field alloc has been changed from int32 (4 bytes) to int16 (2 bytes).	This field may be incorrectly initialized or accessed by applications.
2	Type of field sign has been changed from int32 (4 bytes) to int16 (2 bytes).	This field may be incorrectly initialized or accessed by applications.
3	Type of field used has been changed from int32 (4 bytes) to int16 (2 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.

	Change	Effect
1	Size of field N has been changed from 16 bytes to 12 bytes.	Previous accesses of applications and library functions to this field may be broken.
2	Size of field d has been changed from 16 bytes to 12 bytes.	Previous accesses of applications and library functions to this field may be broken.
3	Size of field dP has been changed from 16 bytes to 12 bytes.	Previous accesses of applications and library functions to this field may be broken.
4	Size of field dQ has been changed from 16 bytes to 12 bytes.	Previous accesses of applications and library functions to this field may be broken.
5	Size of field p has been changed from 16 bytes to 12 bytes.	Previous accesses of applications and library functions to this field may be broken.
6	Size of field qP has been changed from 16 bytes to 12 bytes.	Previous accesses of applications and library functions to this field may be broken.
7	Size of field e has been changed from 16 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.
8	Size of field q has been changed from 16 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.

	Change	Effect
1	Size of field rsa has been changed from 136 bytes to 104 bytes.	1) Size of the inclusive type has changed. 2) Previous accesses of applications and library functions to this field may be broken.

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

pstm.h
[+] struct pstm_int (3)

pubkey.h
[+] struct psRsaKey_t (8)
[+] union pubKeyUnion_t (1)

to the top

Problems with Symbols, Medium Severity (5)

	Change	Effect
1	Type of return value has been changed from int32 (4 bytes) to void.	Applications will not obtain a return value and execution may change.

	Change	Effect
1	Type of return value has been changed from int32 (4 bytes) to void.	Applications will not obtain a return value and execution may change.

	Change	Effect
1	Type of return value has been changed from int32 (4 bytes) to void.	Applications will not obtain a return value and execution may change.

	Change	Effect
1	Type of return value has been changed from int32 (4 bytes) to void.	Applications will not obtain a return value and execution may change.

	Change	Effect
1	Type of return value has been changed from int32 (4 bytes) to int16 (2 bytes).	Applications will obtain a different return value and execution may change.

coreApi.h, libmatrixssl.so
[+] psCoreClose ( ) (1)

osdep.h, libmatrixssl.so
[+] osdepEntropyClose ( ) (1)
[+] osdepTimeClose ( ) (1)
[+] osdepTraceClose ( ) (1)

pstm.h, libmatrixssl.so
[+] pstm_count_bits ( pstm_int* a ) (1)

to the top

Problems with Data Types, Low Severity (6)

	Change	Effect
1	Size of this type has been changed from 2460 bytes to 2476 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field flags 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.
2	Type of field ident has been changed from unsigned short to uint16.	Replacement of the field data type may indicate a change in the semantic meaning of the field.

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

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

pstm.h
[+] struct pstm_int (1)

pubkey.h
[+] struct psRsaKey_t (1)
[+] union pubKeyUnion_t (1)

to the top

Problems with Symbols, Low Severity (3)

	Change	Effect
1	Type of return value has been changed from int32 to int.	Replacement of return type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of return value has been changed from int32 to int.	Replacement of return type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of return value has been changed from int32 to int.	Replacement of return type may indicate a change in its semantic meaning.

osdep.h, libmatrixssl.so
[+] osdepEntropyOpen ( ) (1)
[+] osdepTimeOpen ( ) (1)
[+] osdepTraceOpen ( ) (1)

to the top

Problems with Constants (7)

	Change	Effect
1	The value of constant SSL_FLAGS_ANON_CIPHER has been changed from 0x2000 to 0x200.	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 value of constant SSL_FLAGS_CLIENT_AUTH has been changed from 0x200 to 0x100.	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 value of constant SSL_FLAGS_CLOSED has been changed from 0x20 to 0x10.	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 value of constant SSL_FLAGS_ERROR has been changed from 0x80 to 0x40.	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 value of constant SSL_FLAGS_NEED_ENCODE has been changed from 0x40 to 0x20.	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 value of constant SSL_FLAGS_RESUMED has been changed from 0x10 to 0x8.	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 value of constant SSL_FLAGS_TLS has been changed from 0x100 to 0x80.	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.

matrixssllib.h
[+] SSL_FLAGS_ANON_CIPHER
[+] SSL_FLAGS_CLIENT_AUTH
[+] SSL_FLAGS_CLOSED
[+] SSL_FLAGS_ERROR
[+] SSL_FLAGS_NEED_ENCODE
[+] SSL_FLAGS_RESUMED
[+] SSL_FLAGS_TLS

to the top

Header Files (1)

matrixsslApi.h

to the top

Shared Libraries (1)

libmatrixssl.so

to the top