Binary compatibility report for the libdkim library between 1.0.19 and 1.0.21 versions on x86

Test Info

Library Name	libdkim
Version #1	1.0.19
Version #2	1.0.21
CPU Type	x86
GCC Version	4.6.1

Test Results

Total Header Files	7
Total Shared Libraries	1
Total Symbols / Types	75 / 145
Verdict	Incompatible (16.7%)

Problem Summary

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

Added Symbols (1)

dkimverify.h, libdkim.so
CDKIMVerify::GetADSP ( std::string const& sDomain, int& iADSP )

[symbol: _ZN11CDKIMVerify7GetADSPERKSsRi]

to the top

Removed Symbols (1)

dkimverify.h, libdkim.so
CDKIMVerify::GetSSP ( std::string const& sDomain, int& iSSP, bool& bTesting )

[symbol: _ZN11CDKIMVerify6GetSSPERKSsRiRb]

to the top

Problems with Data Types, High Severity (1)

dkimverify.h
[+] class CDKIMVerify (1)

	Change	Effect
1	Size of this class has been increased from 92 bytes to 96 bytes.	1) An object of this class can be allocated by the applications and old size will be hardcoded at the compile time. Call of any exported constructor will break the memory of neighbouring objects on the stack or heap. 2) The memory layout and size of subclasses will be changed.

[+] affected symbols (9)

CDKIMVerify::CDKIMVerify [in-charge] ( )

This constructor is from 'CDKIMVerify' class.

CDKIMVerify::GetDetails ( int* nSigCount, DKIMVerifyDetails** pDetails )

This method is from 'CDKIMVerify' class.

CDKIMVerify::GetResults ( )

This method is from 'CDKIMVerify' class.

CDKIMVerify::GetSelector ( std::string const& sSelector, std::string const& sDomain )

This method is from 'CDKIMVerify' class.

CDKIMVerify::Init ( DKIMVerifyOptions* pOptions )

This method is from 'CDKIMVerify' class.

CDKIMVerify::ParseDKIMSignature ( std::string const& sHeader, SignatureInfo& sig )

This method is from 'CDKIMVerify' class.

CDKIMVerify::ProcessBody ( char* szBuffer, int nBufLength, bool bEOF )

This method is from 'CDKIMVerify' class.

CDKIMVerify::ProcessHeaders ( )

This method is from 'CDKIMVerify' class.

CDKIMVerify::~CDKIMVerify [in-charge] ( )

This method is from 'CDKIMVerify' class.

to the top

Problems with Data Types, Medium Severity (2)

dkim.h
[+] struct DKIMVerifyDetails_t (1)

	Change	Effect
1	Field szIdentityDomain 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 (2)

CDKIMVerify::GetDetails ( int* nSigCount, DKIMVerifyDetails** pDetails )

2nd parameter 'pDetails' (pointer) has base type 'struct DKIMVerifyDetails_t'.

DKIMVerifyGetDetails ( DKIMContext* pVerifyContext, int* nSigCount, DKIMVerifyDetails** pDetails, char* szPractices )

3rd parameter 'pDetails' (pointer) has base type 'struct DKIMVerifyDetails_t'.

dkimverify.h
[+] class CDKIMVerify (1)

	Change	Effect
1	Field m_AllowUnsignedFromHeaders 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 (9)

CDKIMVerify::CDKIMVerify [in-charge] ( )

This constructor is from 'CDKIMVerify' class.

CDKIMVerify::GetDetails ( int* nSigCount, DKIMVerifyDetails** pDetails )

This method is from 'CDKIMVerify' class.

CDKIMVerify::GetResults ( )

This method is from 'CDKIMVerify' class.

CDKIMVerify::GetSelector ( std::string const& sSelector, std::string const& sDomain )

This method is from 'CDKIMVerify' class.

CDKIMVerify::Init ( DKIMVerifyOptions* pOptions )

This method is from 'CDKIMVerify' class.

CDKIMVerify::ParseDKIMSignature ( std::string const& sHeader, SignatureInfo& sig )

This method is from 'CDKIMVerify' class.

CDKIMVerify::ProcessBody ( char* szBuffer, int nBufLength, bool bEOF )

This method is from 'CDKIMVerify' class.

CDKIMVerify::ProcessHeaders ( )

This method is from 'CDKIMVerify' class.

CDKIMVerify::~CDKIMVerify [in-charge] ( )

This method is from 'CDKIMVerify' class.

to the top

Problems with Data Types, Low Severity (4)

dkim.h
[+] struct DKIMVerifyDetails_t (2)

	Change	Effect
1	Size of this type has been changed from 16 bytes to 20 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	Field DNS has been renamed to szSignatureDomain.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.

[+] affected symbols (2)

CDKIMVerify::GetDetails ( int* nSigCount, DKIMVerifyDetails** pDetails )

2nd parameter 'pDetails' (pointer) has base type 'struct DKIMVerifyDetails_t'.

DKIMVerifyGetDetails ( DKIMContext* pVerifyContext, int* nSigCount, DKIMVerifyDetails** pDetails, char* szPractices )

3rd parameter 'pDetails' (pointer) has base type 'struct DKIMVerifyDetails_t'.

[+] struct DKIMVerifyOptions_t (2)

	Change	Effect
1	Field nAllowUnsignedFromHeaders has been added to this type.	1) This field will not be initialized by old clients. 2) 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 24 bytes to 28 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

[+] affected symbols (2)

CDKIMVerify::Init ( DKIMVerifyOptions* pOptions )

1st parameter 'pOptions' (pointer) has base type 'struct DKIMVerifyOptions_t'.

DKIMVerifyInit ( DKIMContext* pVerifyContext, DKIMVerifyOptions* pOptions )

2nd parameter 'pOptions' (pointer) has base type 'struct DKIMVerifyOptions_t'.

to the top

Problems with Constants (6)

dkim.h
[+] DKIM_BAD_PRIVATE_KEY

	Change	Effect
1	The value of constant DKIM_BAD_PRIVATE_KEY has been changed from 4 to -23.	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.

[+] DKIM_BUFFER_TOO_SMALL

	Change	Effect
1	The value of constant DKIM_BUFFER_TOO_SMALL has been changed from 5 to -24.	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.

[+] DKIM_INVALID_CONTEXT

	Change	Effect
1	The value of constant DKIM_INVALID_CONTEXT has been changed from 2 to -21.	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.

[+] DKIM_MAX_ERROR

	Change	Effect
1	The value of constant DKIM_MAX_ERROR has been changed from -18 to -25.	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.

[+] DKIM_NO_SENDER

	Change	Effect
1	The value of constant DKIM_NO_SENDER has been changed from 3 to -22.	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.

[+] DKIM_OUT_OF_MEMORY

	Change	Effect
1	The value of constant DKIM_OUT_OF_MEMORY has been changed from 1 to -20.	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.

to the top

Header Files (7)

dkim.h
dkimbase.h
dkimsign.h
dkimverify.h
dns.h
dnsresolv.h
resource.h

to the top

Shared Libraries (1)

libdkim.so

to the top