libsodium: 1.0.16 to 1.0.17 compatibility report

Test Info

Library Name	libsodium
Version #1	1.0.16
Version #2	1.0.17
Arch	x86_64
GCC Version	8
Subject	Binary Compatibility

Test Results

Total Header Files	61
Total Libraries	1
Total Symbols / Types	579 / 50
Compatibility	99%

Problem Summary

	Severity	Count
Added Symbols	-	12
Removed Symbols	High	0
Problems with Data Types	High	0
	Medium	7
	Low	1
Problems with Symbols	High	0
	Medium	0
	Low	2
Problems with Constants	Low	0
Other Changes in Constants	-	2

Added Symbols 12

crypto_core_ed25519.h, libsodium.so.23.2.0
crypto_core_ed25519_nonreducedscalarbytes ( )
crypto_core_ed25519_scalar_add ( unsigned char* z, unsigned char const* x, unsigned char const* y )
crypto_core_ed25519_scalar_complement ( unsigned char* comp, unsigned char const* s )
crypto_core_ed25519_scalar_invert ( unsigned char* recip, unsigned char const* s )
crypto_core_ed25519_scalar_negate ( unsigned char* neg, unsigned char const* s )
crypto_core_ed25519_scalar_random ( unsigned char* r )
crypto_core_ed25519_scalar_reduce ( unsigned char* r, unsigned char const* s )
crypto_core_ed25519_scalar_sub ( unsigned char* z, unsigned char const* x, unsigned char const* y )
crypto_core_ed25519_scalarbytes ( )

crypto_scalarmult_ed25519.h, libsodium.so.23.2.0
crypto_scalarmult_ed25519_base_noclamp ( unsigned char* q, unsigned char const* n )
crypto_scalarmult_ed25519_noclamp ( unsigned char* q, unsigned char const* n, unsigned char const* p )

utils.h, libsodium.so.23.2.0
sodium_sub ( unsigned char* a, unsigned char const* b, size_t const len )

to the top

Problems with Data Types, Medium Severity 7

	Change	Effect
1	Base type has been changed from unsigned char[512] to struct crypto_aead_aes256gcm_state_ of different format.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

crypto_aead_aes256gcm.h
[+] typedef crypto_aead_aes256gcm_state 1

crypto_generichash_blake2b.h
[+] struct crypto_generichash_blake2b_state 6

	Change	Effect
1	Field buf has been removed from this type.	Applications will access incorrect memory when attempting to access this field.
2	Field buflen has been removed from this type.	Applications will access incorrect memory when attempting to access this field.
3	Field f has been removed from this type.	Applications will access incorrect memory when attempting to access this field.
4	Field h has been removed from this type.	Applications will access incorrect memory when attempting to access this field.
5	Field last_node has been removed from this type.	Applications will access incorrect memory when attempting to access this field.
6	Field t has been removed from this type.	Applications will access incorrect memory when attempting to access this field.

[+] affected symbols: 7 (1.2%)

to the top

Problems with Data Types, Low Severity 1

	Change	Effect
1	Field opaque has been added to this type.	This field will not be initialized by old clients. NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.

crypto_generichash_blake2b.h
[+] struct crypto_generichash_blake2b_state 1

to the top

Problems with Symbols, Low Severity 2

	Change	Effect
1	Type of 2nd parameter sig has been changed from unsigned char* to unsigned char const*.	Replacement of parameter data type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 2nd parameter sig has been changed from unsigned char* to unsigned char const*.	Replacement of parameter data type may indicate a change in its semantic meaning.

crypto_sign.h, libsodium.so.23.1.0
[+] crypto_sign_final_verify ( crypto_sign_state* state, unsigned char* sig, unsigned char const* pk ) 1

crypto_sign_ed25519.h, libsodium.so.23.1.0
[+] crypto_sign_ed25519ph_final_verify ( crypto_sign_ed25519ph_state* state, unsigned char* sig, unsigned char const* pk ) 1

to the top

Other Changes in Constants 2

	Change	Effect
1	The constant crypto_core_ed25519_NONREDUCEDSCALARBYTES with value 64 has been added.	No effect.

	Change	Effect
1	The constant crypto_core_ed25519_SCALARBYTES with value 32 has been added.	No effect.

crypto_core_ed25519.h
[+] crypto_core_ed25519_NONREDUCEDSCALARBYTES
[+] crypto_core_ed25519_SCALARBYTES

to the top

Header Files 61

core.h
crypto_aead_aes256gcm.h
crypto_aead_chacha20poly1305.h
crypto_aead_xchacha20poly1305.h
crypto_auth.h
crypto_auth_hmacsha256.h
crypto_auth_hmacsha512.h
crypto_auth_hmacsha512256.h
crypto_box.h
crypto_box_curve25519xchacha20poly1305.h
crypto_box_curve25519xsalsa20poly1305.h
crypto_core_ed25519.h
crypto_core_hchacha20.h
crypto_core_hsalsa20.h
crypto_core_salsa20.h
crypto_core_salsa2012.h
crypto_core_salsa208.h
crypto_generichash.h
crypto_generichash_blake2b.h
crypto_hash.h
crypto_hash_sha256.h
crypto_hash_sha512.h
crypto_kdf.h
crypto_kdf_blake2b.h
crypto_kx.h
crypto_onetimeauth.h
crypto_onetimeauth_poly1305.h
crypto_pwhash.h
crypto_pwhash_argon2i.h
crypto_pwhash_argon2id.h
crypto_pwhash_scryptsalsa208sha256.h
crypto_scalarmult.h
crypto_scalarmult_curve25519.h
crypto_scalarmult_ed25519.h
crypto_secretbox.h
crypto_secretbox_xchacha20poly1305.h
crypto_secretbox_xsalsa20poly1305.h
crypto_secretstream_xchacha20poly1305.h
crypto_shorthash.h
crypto_shorthash_siphash24.h
crypto_sign.h
crypto_sign_ed25519.h
crypto_sign_edwards25519sha512batch.h
crypto_stream.h
crypto_stream_chacha20.h
crypto_stream_salsa20.h
crypto_stream_salsa2012.h
crypto_stream_salsa208.h
crypto_stream_xchacha20.h
crypto_stream_xsalsa20.h
crypto_verify_16.h
crypto_verify_32.h
crypto_verify_64.h
export.h
randombytes.h
randombytes_salsa20_random.h
randombytes_sysrandom.h
runtime.h
sodium.h
utils.h
version.h

to the top

Libraries 1

libsodium.so.23.1.0

to the top

Test Info

Library Name	libsodium
Version #1	1.0.16
Version #2	1.0.17
Arch	x86_64
Subject	Source Compatibility

Test Results

Total Header Files	61
Total Libraries	1
Total Symbols / Types	828 / 102
Compatibility	99.2%

Problem Summary

	Severity	Count
Added Symbols	-	12
Removed Symbols	High	0
Problems with Data Types	High	6
	Medium	0
	Low	2
Problems with Symbols	High	0
	Medium	0
	Low	0
Problems with Constants	Low	6
Other Changes in Constants	-	2

Added Symbols 12

crypto_core_ed25519.h
crypto_core_ed25519_nonreducedscalarbytes ( )
crypto_core_ed25519_scalar_add ( unsigned char* z, unsigned char const* x, unsigned char const* y )
crypto_core_ed25519_scalar_complement ( unsigned char* comp, unsigned char const* s )
crypto_core_ed25519_scalar_invert ( unsigned char* recip, unsigned char const* s )
crypto_core_ed25519_scalar_negate ( unsigned char* neg, unsigned char const* s )
crypto_core_ed25519_scalar_random ( unsigned char* r )
crypto_core_ed25519_scalar_reduce ( unsigned char* r, unsigned char const* s )
crypto_core_ed25519_scalar_sub ( unsigned char* z, unsigned char const* x, unsigned char const* y )
crypto_core_ed25519_scalarbytes ( )

crypto_scalarmult_ed25519.h
crypto_scalarmult_ed25519_base_noclamp ( unsigned char* q, unsigned char const* n )
crypto_scalarmult_ed25519_noclamp ( unsigned char* q, unsigned char const* n, unsigned char const* p )

utils.h
sodium_sub ( unsigned char* a, unsigned char const* b, size_t const len )

to the top

Problems with Data Types, High Severity 6

	Change	Effect
1	Field buf has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct crypto_generichash_blake2b_state' has no member named 'buf'.
2	Field buflen has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct crypto_generichash_blake2b_state' has no member named 'buflen'.
3	Field f has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct crypto_generichash_blake2b_state' has no member named 'f'.
4	Field h has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct crypto_generichash_blake2b_state' has no member named 'h'.
5	Field last_node has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct crypto_generichash_blake2b_state' has no member named 'last_node'.
6	Field t has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct crypto_generichash_blake2b_state' has no member named 't'.

crypto_generichash_blake2b.h
[+] struct crypto_generichash_blake2b_state 6

to the top

Problems with Data Types, Low Severity 2

	Change	Effect
1	Base type has been changed from unsigned char[512] to struct crypto_aead_aes256gcm_state_ of different format.	Recompilation of a client program may be broken.

	Change	Effect
1	Field opaque has been added to this type.	This field will not be initialized or used by old client applications.

crypto_aead_aes256gcm.h
[+] typedef crypto_aead_aes256gcm_state 1

crypto_generichash_blake2b.h
[+] struct crypto_generichash_blake2b_state 1

to the top

Problems with Constants, Low Severity 6

	Change	Effect
1	The value of constant crypto_aead_aes256gcm_MESSAGEBYTES_MAX has been changed from SODIUM_MIN(SODIUM_SIZE_MAX - crypto_aead_aes256gcm_ABYTES, (16ULL * ((1ULL << 32) - 2ULL)) - crypto_aead_aes256gcm_ABYTES) to SODIUM_MIN(SODIUM_SIZE_MAX - crypto_aead_aes256gcm_ABYTES, (16ULL * ((1ULL << 32) - 2ULL))).	Recompilation of a client program may be broken.

	Change	Effect
1	The value of constant crypto_aead_chacha20poly1305_ietf_MESSAGEBYTES_MAX has been changed from SODIUM_MIN(SODIUM_SIZE_MAX - crypto_aead_chacha20poly1305_ietf_ABYTES, (64ULL * (1ULL << 32) - 64ULL) - crypto_aead_chacha20poly1305_ietf_ABYTES) to SODIUM_MIN(SODIUM_SIZE_MAX - crypto_aead_chacha20poly1305_ietf_ABYTES, (64ULL * ((1ULL << 32) - 1ULL))).	Recompilation of a client program may be broken.

	Change	Effect
1	The value of constant crypto_aead_chacha20poly1305_IETF_MESSAGEBYTES_MAX has been changed from SODIUM_MIN(SODIUM_SIZE_MAX - crypto_aead_chacha20poly1305_ietf_ABYTES, (64ULL * (1ULL << 32) - 64ULL) - crypto_aead_chacha20poly1305_ietf_ABYTES) to SODIUM_MIN(SODIUM_SIZE_MAX - crypto_aead_chacha20poly1305_ietf_ABYTES, (64ULL * ((1ULL << 32) - 1ULL))).	Recompilation of a client program may be broken.

	Change	Effect
1	The value of constant crypto_secretstream_xchacha20poly1305_MESSAGEBYTES_MAX has been changed from SODIUM_MIN(SODIUM_SIZE_MAX, ((1ULL << 32) - 2ULL) * 64ULL) to SODIUM_MIN(SODIUM_SIZE_MAX - crypto_secretstream_xchacha20poly1305_ABYTES, (64ULL * ((1ULL << 32) - 2ULL))).	Recompilation of a client program may be broken.

	Change	Effect
1	The value of constant SODIUM_LIBRARY_VERSION_MINOR has been changed from 1 to 2.	Recompilation of a client program may be broken.

	Change	Effect
1	The value of constant SODIUM_VERSION_STRING has been changed from "1.0.16" to "1.0.17".	Recompilation of a client program may be broken.

crypto_aead_aes256gcm.h
[+] crypto_aead_aes256gcm_MESSAGEBYTES_MAX

crypto_aead_chacha20poly1305.h
[+] crypto_aead_chacha20poly1305_ietf_MESSAGEBYTES_MAX
[+] crypto_aead_chacha20poly1305_IETF_MESSAGEBYTES_MAX

crypto_secretstream_xchacha20poly1305.h
[+] crypto_secretstream_xchacha20poly1305_MESSAGEBYTES_MAX

version.h
[+] SODIUM_LIBRARY_VERSION_MINOR
[+] SODIUM_VERSION_STRING

to the top

Other Changes in Constants 2

	Change	Effect
1	The constant crypto_core_ed25519_NONREDUCEDSCALARBYTES with value 64 has been added.	No effect.

	Change	Effect
1	The constant crypto_core_ed25519_SCALARBYTES with value 32 has been added.	No effect.

crypto_core_ed25519.h
[+] crypto_core_ed25519_NONREDUCEDSCALARBYTES
[+] crypto_core_ed25519_SCALARBYTES

to the top

Header Files 61

to the top

Libraries 1

libsodium.so.23.1.0

to the top

API compatibility report for the libsodium library between 1.0.16 and 1.0.17 versions on x86_64

Test Info

Test Results

Problem Summary

Added Symbols 12

Problems with Data Types, Medium Severity 7

Problems with Data Types, Low Severity 1

Problems with Symbols, Low Severity 2

Other Changes in Constants 2

Header Files 61

Libraries 1

Test Info

Test Results

Problem Summary

Added Symbols 12

Problems with Data Types, High Severity 6

Problems with Data Types, Low Severity 2

Problems with Constants, Low Severity 6

Other Changes in Constants 2

Header Files 61

Libraries 1