Binary compatibility report for the libwebsockets.so object between 2.3.0 and 2.4.0 versions on x86_64

Test Info

Module Name	libwebsockets
Version #1	2.3.0
Version #2	2.4.0
Arch	x86_64
GCC Version	8.0.1

Test Results

Total Header Files	1
Total Source Files	18
Total Objects	1
Total Symbols / Types	142 / 61
Compatibility	97.9%

Problem Summary

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

Added Symbols 20

libwebsockets.h, libwebsockets.so.12
lws_adjust_protocol_psds ( struct lws* wsi, size_t new_size )
lws_callback_all_protocol_vhost_args ( struct lws_vhost* vh, struct lws_protocols const* protocol, int reason, void* argp, size_t len )
lws_genhash_destroy ( struct lws_genhash_ctx* ctx, void* result )
lws_genhash_init ( struct lws_genhash_ctx* ctx, int type )
lws_genhash_size ( int type )
lws_genhash_update ( struct lws_genhash_ctx* ctx, void const* in, size_t len )
lws_get_network_wsi ( struct lws* wsi )
lws_ring_bump_head ( struct lws_ring* ring, size_t bytes )
lws_ring_consume ( struct lws_ring* ring, uint32_t* tail, void* dest, size_t max_count )
lws_ring_create ( size_t element_len, size_t count, void(*destroy_element)(void*) )
lws_ring_destroy ( struct lws_ring* ring )
lws_ring_get_count_free_elements ( struct lws_ring* ring )
lws_ring_get_count_waiting_elements ( struct lws_ring* ring, uint32_t* tail )
lws_ring_get_element ( struct lws_ring* ring, uint32_t* tail )
lws_ring_get_oldest_tail ( struct lws_ring* ring )
lws_ring_insert ( struct lws_ring* ring, void const* src, size_t max_count )
lws_ring_next_linear_insert_range ( struct lws_ring* ring, void** start, size_t* bytes )
lws_ring_update_oldest_tail ( struct lws_ring* ring, uint32_t tail )
lws_vhost_user ( struct lws_vhost* vhost )
lwsl_hexdump_level ( int hexdump_level, void const* vbuf, size_t len )

to the top

Problems with Data Types, Medium Severity 12

	Change	Effect
1	Value of member WSI_INIT_TOKEN_MUXURL has been changed from 94 to 96.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
2	Value of member WSI_PARSING_COMPLETE has been changed from 93 to 95.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
3	Value of member WSI_TOKEN_NAME_PART has been changed from 90 to 92.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
4	Value of member WSI_TOKEN_SKIPPING has been changed from 91 to 93.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
5	Value of member WSI_TOKEN_SKIPPING_SAW_CR has been changed from 92 to 94.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
6	Value of member _WSI_TOKEN_CLIENT_HOST has been changed from 85 to 87.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
7	Value of member _WSI_TOKEN_CLIENT_IFACE has been changed from 88 to 90.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
8	Value of member _WSI_TOKEN_CLIENT_METHOD has been changed from 87 to 89.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
9	Value of member _WSI_TOKEN_CLIENT_ORIGIN has been changed from 86 to 88.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
10	Value of member _WSI_TOKEN_CLIENT_PEER_ADDRESS has been changed from 83 to 85.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
11	Value of member _WSI_TOKEN_CLIENT_SENT_PROTOCOLS has been changed from 82 to 84.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
12	Value of member _WSI_TOKEN_CLIENT_URI has been changed from 84 to 86.	Applications may execute a wrong branch of code in the library and therefore change the behavior.

libwebsockets.h
[+] enum lws_token_indexes 12

to the top

Problems with Data Types, Low Severity 7

	Change	Effect
1	Value of member WSI_TOKEN_COUNT has been changed from 89 to 91.	Applications may execute a wrong branch of code in the library and therefore change the behavior.

	Change	Effect
1	Field http2_settings 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	Field ip_limit_ah 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.
3	Size of this type has been changed from 416 bytes to 448 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
4	Field ip_limit_wsi 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.

	Change	Effect
1	Size of this type has been changed from 178 bytes to 182 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	Type of field token_limit has been changed from unsigned short[89] to unsigned short[91].	Replacement of the field data type may indicate a change in the semantic meaning of the field.

libwebsockets.h
[+] enum lws_token_indexes 1
[+] struct lws_context_creation_info 4
[+] struct lws_token_limits 2

to the top

Problems with Symbols, Low Severity 3

	Change	Effect
1	2nd parameter enable has been renamed to _enable.	Renaming of a parameter may indicate a change in its semantic meaning.

	Change	Effect
1	Base type of 1st parameter cb has been changed from void()(void, size_t) to void()(void, size_t, char const*).	Replacement of parameter base type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 1st parameter vbuf has been changed from void* to void const*.	Replacement of parameter data type may indicate a change in its semantic meaning.

libwebsockets.h, libwebsockets.so.11
[+] lws_rx_flow_control ( struct lws* wsi, int enable ) 1
[+] lws_set_allocator ( void*(*cb)(void*, size_t) ) 1
[+] lwsl_hexdump ( void* vbuf, size_t len ) 1

to the top

Other Changes in Data Types 6

	Change	Effect
1	The member LWS_CALLBACK_CGI_PROCESS_ATTACH with value 70 has been added.	No effect.

	Change	Effect
1	The member WSI_TOKEN_HEAD_URI with value 82 has been added.	No effect.
2	The member WSI_TOKEN_TE with value 83 has been added.	No effect.

	Change	Effect
1	The member LWS_WRITE_H2_STREAM_END with value 128 has been added.	No effect.
2	The member LWS_WRITE_HTTP_HEADERS_CONTINUATION with value 9 has been added.	No effect.

	Change	Effect
1	The member PENDING_TIMEOUT_USER_REASON_BASE with value 1000 has been added.	No effect.

libwebsockets.h
[+] enum lws_callback_reasons 1
[+] enum lws_token_indexes 2
[+] enum lws_write_protocol 2
[+] enum pending_timeout 1

to the top

Header Files 1

libwebsockets.h

to the top

Source Files 18

alloc.c
base64-decode.c
client-handshake.c
client.c
context.c
extension-permessage-deflate.c
extension.c
handshake.c
header.c
libwebsockets.c
lws-plat-unix.c
output.c
parsers.c
pollfd.c
server.c
service.c
sha-1.c
ssl.c

to the top

Objects 1

libwebsockets.so.11

to the top