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

Test Info

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

Test Results

Total Header Files	1
Total Source Files	17
Total Objects	1
Total Symbols / Types	131 / 59
Compatibility	97.7%

Problem Summary

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

Added Symbols 11

libwebsockets.h, libwebsockets.so.11
lws_alloc_vfs_file ( struct lws_context* context, char const* filename, uint8_t** buf, unsigned long long* amount )
lws_clear_child_pending_on_writable ( struct lws* wsi )
lws_get_child_pending_on_writable ( struct lws const* wsi )
lws_get_close_length ( struct lws* wsi )
lws_get_close_payload ( struct lws* wsi )
lws_get_opaque_parent_data ( struct lws const* wsi )
lws_handle_POLLOUT_event ( struct lws* wsi, struct pollfd* pollfd )
lws_is_first_fragment ( struct lws* wsi )
lws_set_opaque_parent_data ( struct lws* wsi, void* data )
lws_set_parent_carries_io ( struct lws* wsi )
lws_vhost_destroy ( struct lws_vhost* vh )

to the top

Problems with Data Types, Medium Severity 5

	Change	Effect
1	Value of member WSI_INIT_TOKEN_MUXURL has been changed from 93 to 94.	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 92 to 93.	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 89 to 90.	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 90 to 91.	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 91 to 92.	Applications may execute a wrong branch of code in the library and therefore change the behavior.

libwebsockets.h
[+] enum lws_token_indexes 5

to the top

Problems with Data Types, Low Severity 16

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

	Change	Effect
1	Field iface 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 160 bytes to 168 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field simultaneous_ssl_restriction 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 socks_proxy_address 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	Field socks_proxy_port 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.
4	Field ssl_info_event_mask 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.
5	Size of this type has been changed from 384 bytes to 416 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
6	Field bind_iface 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.
7	Field timeout_secs_ah_idle 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	Field tx_packet_size 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 48 bytes to 56 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 176 bytes to 178 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[88] to unsigned short[89].	Replacement of the field data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Base type has been changed from ssize_t to long long.	Replacement of the base data type may indicate a change in its semantic meaning.

	Change	Effect
1	Base type has been changed from size_t to unsigned long long.	Replacement of the base data type may indicate a change in its semantic meaning.

libwebsockets.h
[+] enum lws_token_indexes 1
[+] struct lws_client_connect_info 2
[+] struct lws_context_creation_info 7
[+] struct lws_protocols 2
[+] struct lws_token_limits 2
[+] typedef lws_fileofs_t 1
[+] typedef lws_filepos_t 1

to the top

Problems with Symbols, Low Severity 2

	Change	Effect
1	Type of 2nd parameter content_length has been changed from unsigned long to lws_filepos_t.	Replacement of parameter data type may indicate a change in its semantic meaning.

	Change	Effect
1	Type of 3rd parameter len has been changed from size_t to lws_filepos_t.	Replacement of parameter data type may indicate a change in its semantic meaning.

libwebsockets.h, libwebsockets.so.10
[+] lws_add_http_header_content_length ( struct lws* wsi, unsigned long content_length, unsigned char** p, unsigned char* end ) 1
[+] lws_read ( struct lws* wsi, unsigned char* buf, size_t len ) 1

to the top

Other Changes in Data Types 12

	Change	Effect
1	The member LWS_ADOPT_WS_PARENTIO with value 8 has been added.	No effect.

	Change	Effect
1	The member LWS_CALLBACK_CHILD_CLOSING with value 69 has been added.	No effect.
2	The member LWS_CALLBACK_CHILD_WRITE_VIA_PARENT with value 68 has been added.	No effect.
3	The member LWS_CALLBACK_SSL_INFO with value 67 has been added.	No effect.

	Change	Effect
1	The member _WSI_TOKEN_CLIENT_IFACE with value 88 has been added.	No effect.

	Change	Effect
1	The member PENDING_TIMEOUT_AWAITING_SOCKS_AUTH_REPLY with value 21 has been added.	No effect.
2	The member PENDING_TIMEOUT_AWAITING_SOCKS_CONNECT_REPLY with value 20 has been added.	No effect.
3	The member PENDING_TIMEOUT_AWAITING_SOCKS_GREETING_REPLY with value 19 has been added.	No effect.
4	The member PENDING_TIMEOUT_CLOSE_SEND with value 24 has been added.	No effect.
5	The member PENDING_TIMEOUT_HOLDING_AH with value 25 has been added.	No effect.
6	The member PENDING_TIMEOUT_KILLED_BY_PARENT with value 23 has been added.	No effect.
7	The member PENDING_TIMEOUT_KILLED_BY_SSL_INFO with value 22 has been added.	No effect.

libwebsockets.h
[+] enum lws_adoption_type 1
[+] enum lws_callback_reasons 3
[+] enum lws_token_indexes 1
[+] enum pending_timeout 7

to the top

Header Files 1

libwebsockets.h

to the top

Source Files 17

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

to the top

Objects 1

libwebsockets.so.10

to the top