Binary compatibility report for the libwebsockets.so object between 3.0.0 and current versions on x86_64

Test Info

Module Name	libwebsockets
Version #1	3.0.0 (gcc 8.0.1)
Version #2	current (gcc 8.1.1)
Arch	x86_64

Test Results

Total Header Files	1
Total Source Files	19
Total Objects	1
Total Symbols / Types	186 / 64
Compatibility	97.6%

Problem Summary

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

Added Symbols 19

lws-context-vhost.h, libwebsockets.so.13
lwsws_get_config_globals ( struct lws_context_creation_info* info, char const* d, char** cs, int* len )
lwsws_get_config_vhosts ( struct lws_context* context, struct lws_context_creation_info* info, char const* d, char** cs, int* len )

lws-http.h, libwebsockets.so.13
lws_http_compression_apply ( struct lws* wsi, char const* name, unsigned char** p, unsigned char* end, char decomp )

lws-lejp.h, libwebsockets.so.13
lejp_change_callback ( struct lejp_ctx* ctx, signed char(*callback)(struct lejp_ctx*, char) )
lejp_construct ( struct lejp_ctx* ctx, signed char(*callback)(struct lejp_ctx*, char), void* user, char const*const* paths, unsigned char count_paths )
lejp_destruct ( struct lejp_ctx* ctx )
lejp_get_wildcard ( struct lejp_ctx* ctx, int wildcard, char* dest, int len )
lejp_parse ( struct lejp_ctx* ctx, unsigned char const* json, int len )

lws-misc.h, libwebsockets.so.13
lws_get_effective_uid_gid ( struct lws_context* context, int* uid, int* gid )
lws_open ( char const* __file, int __oflag, ... )

lws-protocols-plugins.h, libwebsockets.so.13
lws_pvo_get_str ( void* in, char const* name, char const** result )

lws-threadpool.h, libwebsockets.so.13
lws_threadpool_create ( struct lws_context* context, struct lws_threadpool_create_args const* args, char const* format, ... )
lws_threadpool_dequeue ( struct lws* wsi )
lws_threadpool_destroy ( struct lws_threadpool* tp )
lws_threadpool_dump ( struct lws_threadpool* tp )
lws_threadpool_enqueue ( struct lws_threadpool* tp, struct lws_threadpool_task_args const* args, char const* format, ... )
lws_threadpool_finish ( struct lws_threadpool* tp )
lws_threadpool_task_status_wsi ( struct lws* wsi, struct lws_threadpool_task** task, void** user )
lws_threadpool_task_sync ( struct lws_threadpool_task* task, int stop )

to the top

Removed Symbols 3

libwebsockets.h, libwebsockets.so.13
lws_client_connect ( struct lws_context* context, char const* address, int port, int ssl_connection, char const* path, char const* host, char const* origin, char const* protocol, int ietf_version_or_minus_one )
lws_client_connect_extended ( struct lws_context* context, char const* address, int port, int ssl_connection, char const* path, char const* host, char const* origin, char const* protocol, int ietf_version_or_minus_one, void* userdata )
lws_set_parent_carries_io ( struct lws* wsi )

to the top

Problems with Data Types, Medium Severity 2

	Change	Effect
1	Field client_ssl_ca_mem 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.
2	Field client_ssl_ca_mem_len 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.

libwebsockets.h
[+] struct lws_context_creation_info 2

to the top

Problems with Data Types, Low Severity 7

	Change	Effect
1	The member LWS_CALLBACK_CHILD_WRITE_VIA_PARENT has been removed.	This may result in crash or incorrect behavior of applications because the library may not handle removed member anymore.

libwebsockets.h
[+] enum lws_callback_reasons 1
[+] struct lws_context_creation_info 6

	Change	Effect
1	Field finalize 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 finalize_arg 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 max_http_header_pool2 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	Size of this type has been changed from 456 bytes to 496 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
5	Type of field max_http_header_data has been changed from short to unsigned short.	Replacement of the field data type may indicate a change in the semantic meaning of the field.
6	Type of field max_http_header_pool has been changed from short to unsigned short.	Replacement of the field data type may indicate a change in the semantic meaning of the field.

[+] affected symbols: 3 (1.6%)

to the top

Problems with Symbols, Low Severity 2

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

	Change	Effect
1	1st parameter wsi has been renamed to _wsi.	Renaming of a parameter may indicate a change in its semantic meaning.

libwebsockets.h, libwebsockets.so.13
[+] lws_client_connect_via_info ( struct lws_client_connect_info* i ) 1
[+] lws_http_client_http_response ( struct lws* wsi ) 1

to the top

Other Changes in Data Types 12

	Change	Effect
1	The member LWS_CALLBACK_CLIENT_HTTP_BIND_PROTOCOL with value 75 has been added.	No effect.
2	The member LWS_CALLBACK_CLIENT_HTTP_DROP_PROTOCOL with value 76 has been added.	No effect.
3	The member LWS_CALLBACK_RAW_FILE_BIND_PROTOCOL with value 83 has been added.	No effect.
4	The member LWS_CALLBACK_RAW_FILE_DROP_PROTOCOL with value 84 has been added.	No effect.
5	The member LWS_CALLBACK_RAW_SKT_BIND_PROTOCOL with value 81 has been added.	No effect.
6	The member LWS_CALLBACK_RAW_SKT_DROP_PROTOCOL with value 82 has been added.	No effect.
7	The member LWS_CALLBACK_WS_CLIENT_BIND_PROTOCOL with value 79 has been added.	No effect.
8	The member LWS_CALLBACK_WS_CLIENT_DROP_PROTOCOL with value 80 has been added.	No effect.
9	The member LWS_CALLBACK_WS_SERVER_BIND_PROTOCOL with value 77 has been added.	No effect.
10	The member LWS_CALLBACK_WS_SERVER_DROP_PROTOCOL with value 78 has been added.	No effect.

	Change	Effect
1	The member PENDING_TIMEOUT_THREADPOOL with value 29 has been added.	No effect.
2	The member PENDING_TIMEOUT_THREADPOOL_TASK with value 30 has been added.	No effect.

libwebsockets.h
[+] enum lws_callback_reasons 10
[+] enum pending_timeout 2

to the top

Header Files 1

libwebsockets.h

to the top

Source Files 19

alloc.c
base64-decode.c
client-handshake.c
client.c
context.c
header.c
libwebsockets.c
lws-plat-unix.c
lws-ring.c
lws-spa.c
ops-ws.c
output.c
parsers.c
pollfd.c
server.c
service.c
sha-1.c
ssl.c
tls.c

to the top

Objects 1

libwebsockets.so.13

to the top