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

Test Info

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

Test Results

Total Header Files	1
Total Shared Libraries	1
Total Symbols / Types	184 / 124
Verdict	Incompatible (29.35%)

Problem Summary

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

Added Symbols (3)

cryptoApi.h, libmatrixssl.so
pkcs8ParsePrivBin ( psPool_t* pool, unsigned char* p, int32 size, char* pass, psPubKey_t** key )

matrixsslApi.h, libmatrixssl.so
matrixSslEncodeToOutdata ( ssl_t* ssl, unsigned char* buf, uint32 len )

osdep.h, libmatrixssl.so
psTraceBytes ( char* tag, unsigned char* p, int l )

to the top

Removed Symbols (1)

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

to the top

Problems with Data Types, Medium Severity (3)

matrixssllib.h
[+] struct ssl (1)

	Change	Effect
1	Size of field sec has been changed from 2228 bytes to 2232 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.

[+] affected symbols (46)

matrixClearSession ( ssl_t* ssl, int32 remove )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixRegisterSession ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixResumeSession ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslDecode ( ssl_t* ssl, unsigned char** buf, uint32* len, uint32 size, uint32* remaining, uint32* requiredLen, int32* error, unsigned char* alertLevel, unsigned char* alertDescription )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslDeleteSession ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslEncode ( ssl_t* ssl, unsigned char* buf, uint32 size, unsigned char* ptBuf, uint32* len )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslEncodeClientHello ( ssl_t* ssl, sslBuf_t* out, uint32 cipherSpec, uint32* requiredLen, tlsExtension_t* userExt )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslEncodeClosureAlert ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslEncodeHelloRequest ( ssl_t* ssl, sslBuf_t* out, uint32* reqLen )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslEncodeRehandshake ( ssl_t* ssl, sslKeys_t* keys, int32(*certCb)(ssl_t*, psX509Cert_t*, int32), uint32 sessionOption, uint32 cipherSpec )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslEncodeWritebuf ( ssl_t* ssl, uint32 len )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslGetAnonStatus ( ssl_t* ssl, int32* anonArg )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslGetEncodedSize ( ssl_t* ssl, uint32 len )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslGetOutdata ( ssl_t* ssl, unsigned char** buf )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslGetReadbuf ( ssl_t* ssl, unsigned char** buf )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslGetSessionId ( ssl_t* ssl, sslSessionId_t* sessionId )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslGetWritebuf ( ssl_t* ssl, unsigned char** buf, uint32 reqLen )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslHandshakeIsComplete ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslNewClientSession ( ssl_t** ssl, sslKeys_t* keys, sslSessionId_t* sid, uint32 cipherSpec, int32(*certCb)(ssl_t*, psX509Cert_t*, int32), tlsExtension_t* extensions, int32(*extCb)(ssl_t*, unsigned short, unsigned short, void*) )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslNewServerSession ( ssl_t** ssl, sslKeys_t* keys, int32(*certCb)(ssl_t*, psX509Cert_t*, int32) )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslNewSession ( ssl_t** ssl, sslKeys_t* keys, sslSessionId_t* session, int32 flags )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslProcessedData ( ssl_t* ssl, unsigned char** ptbuf, uint32* ptlen )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslReceivedData ( ssl_t* ssl, uint32 bytes, unsigned char** ptbuf, uint32* ptlen )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslSentData ( ssl_t* ssl, uint32 bytes )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslSetCertValidator ( ssl_t* ssl, int32(*certValidator)(void*, psX509Cert_t*, int32) )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslSetCipherSuiteEnabledStatus ( ssl_t* ssl, uint16 cipherId, uint32 status )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixSslSetSessionOption ( ssl_t* ssl, int32 option, void* arg )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixUpdateSession ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

matrixUserCertValidator ( ssl_t* ssl, int32 alert, psX509Cert_t* subjectCert, sslCertCb_t certCb )

1st parameter 'ssl' (pointer) has base type 'ssl'.

psWriteHandshakeHeader ( ssl_t* ssl, unsigned char type, int32 len, int32 seq, int32 fragOffset, int32 fragLen, unsigned char* c )

1st parameter 'ssl' (pointer) has base type 'ssl'.

psWriteRecordInfo ( ssl_t* ssl, unsigned char type, int32 len, unsigned char* c )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslActivateReadCipher ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslActivateWriteCipher ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslCreateKeys ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslDeriveKeys ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslEncodeClosureAlert ( ssl_t* ssl, sslBuf_t* out, uint32* reqLen )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslEncodeResponse ( ssl_t* ssl, psBuf_t* out, uint32* requiredLen )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslGetCipherSpec ( ssl_t* ssl, uint32 cid )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslGetCipherSpecList ( ssl_t* ssl, unsigned char* c, int32 len, int32 addScsv )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslGetCipherSpecListLen ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslInitHSHash ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslResetContext ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslSnapshotHSHash ( ssl_t* ssl, unsigned char* out, int32 senderFlag )

1st parameter 'ssl' (pointer) has base type 'ssl'.

sslUpdateHSHash ( ssl_t* ssl, unsigned char* in, uint32 len )

1st parameter 'ssl' (pointer) has base type 'ssl'.

tlsDeriveKeys ( ssl_t* ssl )

1st parameter 'ssl' (pointer) has base type 'ssl'.

tlsHMACSha1 ( ssl_t* ssl, int32 mode, unsigned char type, unsigned char* data, uint32 len, unsigned char* mac )

1st parameter 'ssl' (pointer) has base type 'ssl'.

[+] struct sslSec_t (1)

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

[+] affected symbols (46)

matrixClearSession ( ssl_t* ssl, int32 remove )

Field 'ssl−>sec' in 1st parameter 'ssl' (pointer) has type 'sslSec_t'.