Binary compatibility report for the libwebsockets.so object between 2.1.1 and 2.2.0 versions on x86_64

Test Info

Module Name	libwebsockets
Version #1	2.1.1
Version #2	2.2.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	108 / 48
Compatibility	96.3%

Problem Summary

	Severity	Count
Added Symbols	-	24
Removed Symbols	High	1
Problems with Data Types	High	0
	Medium	11
	Low	24
Problems with Symbols	High	0
	Medium	0
	Low	1
Problems with Constants	Low	0
Other Changes in Data Types	-	11

Added Symbols 24

libwebsockets.h, libwebsockets.so.10
_lws_plat_file_close ( lws_fop_fd_t* fop_fd )
_lws_plat_file_open ( struct lws_plat_file_ops const* fops, char const* filename, char const* vpath, lws_fop_flags_t* flags )
_lws_plat_file_read ( lws_fop_fd_t fop_fd, lws_filepos_t* amount, uint8_t* buf, lws_filepos_t len )
_lws_plat_file_seek_cur ( lws_fop_fd_t fop_fd, lws_fileofs_t offset )
_lws_plat_file_write ( lws_fop_fd_t fop_fd, lws_filepos_t* amount, uint8_t* buf, lws_filepos_t len )
fops_zip [data]
lws_adopt_descriptor_vhost ( struct lws_vhost* vh, enum lws_adoption_type type, union lws_sock_file_fd_type fd, char const* vh_prot_name, struct lws* parent )
lws_adopt_socket_vhost ( struct lws_vhost* vh, lws_sockfd_type accept_fd )
lws_adopt_socket_vhost_readbuf ( struct lws_vhost* vhost, lws_sockfd_type accept_fd, char const* readbuf, size_t len )
lws_context_deprecate ( struct lws_context* context, lws_reload_func cb )
lws_context_destroy2 ( struct lws_context* context )
lws_context_is_deprecated ( struct lws_context* context )
lws_get_ssl ( struct lws* wsi )
lws_http_client_http_response ( struct lws* wsi )
lws_protocol_init ( struct lws_context* context )
lws_set_fops ( struct lws_context* context, struct lws_plat_file_ops const* fops )
lws_set_wsi_user ( struct lws* wsi, void* data )
lws_vfs_file_open ( struct lws_plat_file_ops const* fops, char const* vfs_path, lws_fop_flags_t* flags )
lws_vfs_file_seek_end ( lws_fop_fd_t fop_fd, lws_fileofs_t offset )
lws_vfs_file_seek_set ( lws_fop_fd_t fop_fd, lws_fileofs_t offset )
lws_vfs_get_length ( lws_fop_fd_t fop_fd )
lws_vfs_get_mod_time ( lws_fop_fd_t fop_fd )
lws_vfs_tell ( lws_fop_fd_t fop_fd )
lwsl_visible ( int level )

to the top

Removed Symbols 1

libwebsockets.h, libwebsockets.so.9
lws_plat_service_tsi ( struct lws_context* context, int timeout_ms, int tsi )

to the top

Problems with Data Types, Medium Severity 11

	Change	Effect
1	Value of member WSI_INIT_TOKEN_MUXURL has been changed from 91 to 93.	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 90 to 92.	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 87 to 89.	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 88 to 90.	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 89 to 91.	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 83 to 85.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
7	Value of member _WSI_TOKEN_CLIENT_METHOD has been changed from 85 to 87.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
8	Value of member _WSI_TOKEN_CLIENT_ORIGIN has been changed from 84 to 86.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
9	Value of member _WSI_TOKEN_CLIENT_PEER_ADDRESS has been changed from 81 to 83.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
10	Value of member _WSI_TOKEN_CLIENT_SENT_PROTOCOLS has been changed from 80 to 82.	Applications may execute a wrong branch of code in the library and therefore change the behavior.
11	Value of member _WSI_TOKEN_CLIENT_URI has been changed from 82 to 84.	Applications may execute a wrong branch of code in the library and therefore change the behavior.

libwebsockets.h
[+] enum lws_token_indexes 11

to the top

Problems with Data Types, Low Severity 24

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

	Change	Effect
1	Type of field client_exts has been changed from struct lws_extension const* to void const*.	Replacement of the field data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Field client_ssl_ca_filepath 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 client_ssl_cert_filepath 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 client_ssl_cipher_list 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 external_baggage_free_on_destroy 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	Field fops 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.
6	Field reject_service_keywords 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.
7	Field client_ssl_private_key_filepath has been added to this type.	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.
8	Field client_ssl_private_key_password has been added to this type.	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.
9	Size of this type has been changed from 320 bytes to 384 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field basic_auth_login_file 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 _unused has been added to this type.	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 80 bytes to 104 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field fi 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 next 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 40 bytes to 96 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
4	Base type of field close has been changed from int()(struct lws, lws_filefd_type) to *int()(lws_fop_fd_t)*.	Replacement of field base type may indicate a change in the semantic meaning of the field.
5	Base type of field open has been changed from lws_filefd_type()(struct lws, char const, unsigned long, int) to lws_fop_fd_t()(struct lws_plat_file_ops const, char const, char const, lws_fop_flags_t*).	Replacement of field base type may indicate a change in the semantic meaning of the field.
6	Base type of field read has been changed from int()(struct lws, lws_filefd_type, unsigned long, unsigned char, unsigned long) to int()(lws_fop_fd_t, lws_filepos_t, uint8_t*, lws_filepos_t).	Replacement of field base type may indicate a change in the semantic meaning of the field.
7	Base type of field seek_cur has been changed from unsigned long()(struct lws, lws_filefd_type, long) to lws_fileofs_t(*)(lws_fop_fd_t, lws_fileofs_t).	Replacement of field base type may indicate a change in the semantic meaning of the field.
8	Base type of field write has been changed from int()(struct lws, lws_filefd_type, unsigned long, unsigned char, unsigned long) to int()(lws_fop_fd_t, lws_filepos_t, uint8_t*, lws_filepos_t).	Replacement of field base type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Size of this type has been changed from 172 bytes to 176 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[86] to unsigned short[88].	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_client_connect_info 1
[+] struct lws_context_creation_info 9
[+] struct lws_http_mount 3
[+] struct lws_plat_file_ops 8
[+] struct lws_token_limits 2

to the top

Problems with Symbols, Low Severity 1

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

libwebsockets.h, libwebsockets.so.9
[+] lws_add_http_header_status ( struct lws* wsi, unsigned int code, unsigned char** p, unsigned char* end ) 1

to the top

Other Changes in Data Types 11

	Change	Effect
1	The member LWS_CALLBACK_OPENSSL_PERFORM_SERVER_CERT_VERIFICATION with value 58 has been added.	No effect.
2	The member LWS_CALLBACK_RAW_ADOPT with value 62 has been added.	No effect.
3	The member LWS_CALLBACK_RAW_ADOPT_FILE with value 63 has been added.	No effect.
4	The member LWS_CALLBACK_RAW_CLOSE with value 60 has been added.	No effect.
5	The member LWS_CALLBACK_RAW_CLOSE_FILE with value 66 has been added.	No effect.
6	The member LWS_CALLBACK_RAW_RX with value 59 has been added.	No effect.
7	The member LWS_CALLBACK_RAW_RX_FILE with value 64 has been added.	No effect.
8	The member LWS_CALLBACK_RAW_WRITEABLE with value 61 has been added.	No effect.
9	The member LWS_CALLBACK_RAW_WRITEABLE_FILE with value 65 has been added.	No effect.

	Change	Effect
1	The member WSI_TOKEN_CONNECT with value 81 has been added.	No effect.
2	The member WSI_TOKEN_X_FORWARDED_FOR with value 80 has been added.	No effect.

libwebsockets.h
[+] enum lws_callback_reasons 9
[+] enum lws_token_indexes 2

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.9

to the top