libwiretap: 3.0.15 to 4.0.8 compatibility report

Test Info

Library Name	libwiretap
Version #1	3.0.15
Version #2	4.0.8
CPU Type	x86_64
GCC Version	4.8
Subject	Binary Compatibility

Test Results

Total Header Files	58
Total Shared Libraries	1
Total Symbols / Types	75 / 136
Verdict	Incompatible (43.3%)

Problem Summary

	Severity	Count
Added Symbols	-	35
Removed Symbols	High	14
Problems with Data Types	High	1
	Medium	7
	Low	10
Problems with Symbols	High	4
	Medium	1
	Low	1
Problems with Constants	Low	0

Added Symbols (35)

file_wrappers.h, libwiretap.so.4.0.8
file_iscompressed ( FILE_T stream )
file_peekc ( FILE_T stream )

merge.h, libwiretap.so.4.0.8
merge_append_read_packet ( int in_file_count, merge_in_file_t* in_files, int* err, gchar** err_info )
merge_close_in_files ( int in_file_count, merge_in_file_t* in_files )
merge_max_snapshot_length ( int in_file_count, merge_in_file_t* in_files )
merge_open_in_files ( int in_file_count, char*const* in_file_names, merge_in_file_t** in_files, int* err, gchar** err_info, int* err_fileno )
merge_read_packet ( int in_file_count, merge_in_file_t* in_files, int* err, gchar** err_info )
merge_select_frame_type ( int in_file_count, merge_in_file_t* in_files )

pcapng_module.h, libwiretap.so.4.0.8
register_pcapng_block_type_handler ( guint block_type, block_reader read, block_writer write )

wtap-int.h, libwiretap.so.4.0.8
wtap_dump_file_seek ( wtap_dumper* wdh, gint64 offset, int whence, int* err )
wtap_dump_file_tell ( wtap_dumper* wdh, int* err )
wtap_dump_file_write ( wtap_dumper* wdh, void const* buf, size_t bufsize, int* err )
wtap_read_packet_bytes ( FILE_T fh, Buffer* buf, guint length, int* err, gchar** err_info )

wtap.h, libwiretap.so.4.0.8
init_open_routines ( )
open_info_name_to_type ( char const* name )
open_routines [data]
register_all_wiretap_modules ( )
wtap_deregister_file_type_subtype ( int const file_type_subtype )
wtap_deregister_open_info ( gchar const* name )
wtap_file_type_subtype ( wtap* wth )
wtap_file_type_subtype_short_string ( int file_type_subtype )
wtap_file_type_subtype_string ( int file_type_subtype )
wtap_free_extensions_list ( GSList* extensions )
wtap_get_all_file_extensions_list ( )
wtap_get_file_extension_type_extensions ( guint extension_type )
wtap_get_file_extension_type_name ( int extension_type )
wtap_get_num_file_type_extensions ( )
wtap_get_num_file_types_subtypes ( )
wtap_get_savable_file_types_subtypes ( int file_type, GArray const* file_encaps, guint32 required_comment_types )
wtap_has_open_info ( gchar const* name )
wtap_register_file_type_extension ( struct file_extension_info const* ei )
wtap_register_file_type_subtypes ( struct file_type_subtype_info const* fi, int const subtype )
wtap_register_open_info ( struct open_info* oi, gboolean const first_routine )
wtap_register_plugin_types ( )
wtap_short_string_to_file_type_subtype ( char const* short_name )

to the top

Removed Symbols (14)

buffer.h, libwiretap.so.3.0.15
buffer_append ( Buffer* buffer, guint8* from, gsize bytes )
buffer_assure_space ( Buffer* buffer, gsize space )
buffer_free ( Buffer* buffer )
buffer_init ( Buffer* buffer, gsize space )
buffer_remove_start ( Buffer* buffer, gsize bytes )

wtap.h, libwiretap.so.3.0.15
wtap_file_type ( wtap* wth )
wtap_file_type_short_string ( int filetype )
wtap_file_type_string ( int filetype )
wtap_free_file_extensions_list ( GSList* extensions )
wtap_get_num_file_types ( )
wtap_get_savable_file_types ( int file_type, GArray const* file_encaps, guint32 required_comment_types )
wtap_register_file_type ( struct file_type_info const* fi )
wtap_register_open_routine ( wtap_open_routine_t p1, gboolean has_magic )
wtap_short_string_to_file_type ( char const* short_name )

to the top

Problems with Data Types, High Severity (1)

	Change	Effect
1	Field number_of_interfaces has been removed from the middle position of this structural type.	1) Previous accesses of applications to the removed field will be incorrect. 2) Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications.

wtap.h
[+] struct wtapng_iface_descriptions_s (1)

to the top

Problems with Symbols, High Severity (4)

	Change	Effect
1	Parameter type of type unsigned int has been added to the calling stack at the middle position.	Layout of parameter's stack has been changed and therefore parameters at higher positions in the stack may be incorrectly initialized by applications.

	Change	Effect
1	4th middle parameter pd has been removed from the calling stack.	Layout of parameter's stack has been changed and therefore parameters at higher positions in the stack may be incorrectly initialized by applications.
2	5th middle parameter len has been removed from the calling stack.	Layout of parameter's stack has been changed and therefore parameters at higher positions in the stack may be incorrectly initialized by applications.
3	Parameter buf of type Buffer* has been added to the calling stack at the middle position.	Layout of parameter's stack has been changed and therefore parameters at higher positions in the stack may be incorrectly initialized by applications.

wtap.h, libwiretap.so.3.0.15
[+] wtap_open_offline ( char const* filename, int* err, gchar** err_info, gboolean do_random ) (1)
[+] wtap_seek_read ( wtap* wth, gint64 seek_off, struct wtap_pkthdr* phdr, guint8* pd, int len, int* err, gchar** err_info ) (3)

to the top

Problems with Data Types, Medium Severity (7)

	Change	Effect
1	Field wslua_data 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.

	Change	Effect
1	Field addrinfo_lists has been added at the middle position of this structural type.	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 wslua_data has been added at the middle position of this structural type.	Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications.
3	Field number_of_interfaces has been removed from this type.	Applications will access incorrect memory when attempting to access this field.
4	Field addrinfo_list has been removed from the middle position of this structural type.	1) Applications will access incorrect memory when attempting to access this field. 2) Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications.

	Change	Effect
1	Type of field channel has been changed from guint8 (1 byte) to guint32 (4 bytes).	This field may be incorrectly initialized or accessed by applications.

	Change	Effect
1	Field ns_activity_offset has been added at the middle position of this structural type.	Layout of structure fields has been changed and therefore fields at higher positions of the structure definition may be incorrectly accessed by applications.

wtap-int.h
[+] struct wtap (1)
[+] struct wtap_dumper (4)

wtap.h
[+] struct bthci_phdr (1)
[+] struct nstr_phdr (1)

to the top

Problems with Symbols, Medium Severity (1)

	Change	Effect
1	Base type of parameter addrinfo_list has been changed from struct addrinfo to struct addrinfo_lists of different format.	This parameter may be incorrectly initialized by applications.

wtap.h, libwiretap.so.3.0.15
[+] wtap_dump_set_addrinfo_list ( wtap_dumper* wdh, struct addrinfo* addrinfo_list ) (1)

to the top

Problems with Data Types, Low Severity (10)

	Change	Effect
1	Size of this type has been changed from 368 bytes to 376 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.
2	Field file_type has been renamed to file_type_subtype.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Field file_type has been renamed to file_type_subtype.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Base type has been changed from gboolean()(struct wtap,gint64,struct wtap_pkthdr,guint8,int,int,char) to gboolean()(struct wtap,gint64,struct wtap_pkthdr,Buffer,int,char**).	Possible incorrect initialization of parameters by applications.

	Change	Effect
1	Field rec_type 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.
2	Type of field ts has been changed from struct wtap_nstime to nstime_t.	Replacement of the field data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Size of this type has been changed from 16 bytes to 8 bytes.	The fields or parameters of such data type may be incorrectly initialized or accessed by old client applications.

	Change	Effect
1	Field btmon has been added to this type.	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 ftsrec has been added to this type.	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 logcat has been added to this type.	NOTE: this field should be accessed only from the new library functions, otherwise it may result in crash or incorrect behavior of applications.

wtap-int.h
[+] struct wtap (2)
[+] struct wtap_dumper (1)
[+] typedef subtype_seek_read_func (1)

wtap.h
[+] struct wtap_pkthdr (2)
[+] struct wtapng_iface_descriptions_s (1)
[+] union wtap_pseudo_header (3)

to the top

Problems with Symbols, Low Severity (1)

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

wtap.h, libwiretap.so.3.0.15
[+] wtap_dump_set_addrinfo_list ( wtap_dumper* wdh, struct addrinfo* addrinfo_list ) (1)

to the top

Header Files (58)

5views.h
aethra.h
ascend-int.h
ascend.h
ascend_scanner_lex.h
ascendtext.h
atm.h
ber.h
btsnoop.h
buffer.h
camins.h
catapult_dct2000.h
commview.h
cosine.h
csids.h
daintree-sna.h
dbs-etherwatch.h
dct3trace.h
erf.h
eyesdn.h
file_wrappers.h
hcidump.h
i4b_trace.h
i4btrace.h
ipfix.h
iptrace.h
iseries.h
k12.h
k12text_lex.h
lanalyzer.h
libpcap.h
mime_file.h
mp2t.h
mpeg.h
netmon.h
netscaler.h
netscreen.h
nettl.h
network_instruments.h
netxray.h
ngsniffer.h
packetlogger.h
pcap-common.h
pcap-encap.h
pcapng.h
peekclassic.h
peektagged.h
pppdump.h
radcom.h
snoop.h
tnef.h
toshiba.h
visual.h
vms.h
vwr.h
ws_symbol_export.h
wtap-int.h
wtap.h

to the top

Shared Libraries (1)

libwiretap.so.3.0.15

to the top

Test Info

Library Name	libwiretap
Version #1	3.0.15
Version #2	4.0.8
CPU Type	x86_64
GCC Version	4.8
Subject	Source Compatibility

Test Results

Total Header Files	58
Total Shared Libraries	1
Total Symbols / Types	75 / 136
Verdict	Incompatible (61.3%)

Problem Summary

	Severity	Count
Added Symbols	-	35
Removed Symbols	High	14
Problems with Data Types	High	5
	Medium	0
	Low	3
Problems with Symbols	High	4
	Medium	1
	Low	0
Problems with Constants	Low	1
Other Changes in Data Types	-	8
Other Changes in Symbols	-	1

Added Symbols (35)

file_wrappers.h
file_iscompressed ( FILE_T stream )
file_peekc ( FILE_T stream )

merge.h
merge_append_read_packet ( int in_file_count, merge_in_file_t* in_files, int* err, gchar** err_info )
merge_close_in_files ( int in_file_count, merge_in_file_t* in_files )
merge_max_snapshot_length ( int in_file_count, merge_in_file_t* in_files )
merge_open_in_files ( int in_file_count, char*const* in_file_names, merge_in_file_t** in_files, int* err, gchar** err_info, int* err_fileno )
merge_read_packet ( int in_file_count, merge_in_file_t* in_files, int* err, gchar** err_info )
merge_select_frame_type ( int in_file_count, merge_in_file_t* in_files )

pcapng_module.h
register_pcapng_block_type_handler ( guint block_type, block_reader read, block_writer write )

wtap-int.h
wtap_dump_file_seek ( wtap_dumper* wdh, gint64 offset, int whence, int* err )
wtap_dump_file_tell ( wtap_dumper* wdh, int* err )
wtap_dump_file_write ( wtap_dumper* wdh, void const* buf, size_t bufsize, int* err )
wtap_read_packet_bytes ( FILE_T fh, Buffer* buf, guint length, int* err, gchar** err_info )

wtap.h
init_open_routines ( )
open_info_name_to_type ( char const* name )
open_routines [data]
register_all_wiretap_modules ( )
wtap_deregister_file_type_subtype ( int const file_type_subtype )
wtap_deregister_open_info ( gchar const* name )
wtap_file_type_subtype ( wtap* wth )
wtap_file_type_subtype_short_string ( int file_type_subtype )
wtap_file_type_subtype_string ( int file_type_subtype )
wtap_free_extensions_list ( GSList* extensions )
wtap_get_all_file_extensions_list ( )
wtap_get_file_extension_type_extensions ( guint extension_type )
wtap_get_file_extension_type_name ( int extension_type )
wtap_get_num_file_type_extensions ( )
wtap_get_num_file_types_subtypes ( )
wtap_get_savable_file_types_subtypes ( int file_type, GArray const* file_encaps, guint32 required_comment_types )
wtap_has_open_info ( gchar const* name )
wtap_register_file_type_extension ( struct file_extension_info const* ei )
wtap_register_file_type_subtypes ( struct file_type_subtype_info const* fi, int const subtype )
wtap_register_open_info ( struct open_info* oi, gboolean const first_routine )
wtap_register_plugin_types ( )
wtap_short_string_to_file_type_subtype ( char const* short_name )

to the top

Removed Symbols (14)

buffer.h
buffer_append ( Buffer* buffer, guint8* from, gsize bytes )
buffer_assure_space ( Buffer* buffer, gsize space )
buffer_free ( Buffer* buffer )
buffer_init ( Buffer* buffer, gsize space )
buffer_remove_start ( Buffer* buffer, gsize bytes )

wtap.h
wtap_file_type ( wtap* wth )
wtap_file_type_short_string ( int filetype )
wtap_file_type_string ( int filetype )
wtap_free_file_extensions_list ( GSList* extensions )
wtap_get_num_file_types ( )
wtap_get_savable_file_types ( int file_type, GArray const* file_encaps, guint32 required_comment_types )
wtap_register_file_type ( struct file_type_info const* fi )
wtap_register_open_routine ( wtap_open_routine_t p1, gboolean has_magic )
wtap_short_string_to_file_type ( char const* short_name )

to the top

Problems with Data Types, High Severity (5)

	Change	Effect
1	Field file_type has been renamed to file_type_subtype.	Recompilation of a client program may be broken with the error message: struct wtap has no member named file_type.

	Change	Effect
1	Field addrinfo_list has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct wtap_dumper' has no member named 'addrinfo_list'.
2	Field number_of_interfaces has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct wtap_dumper' has no member named 'number_of_interfaces'.
3	Field file_type has been renamed to file_type_subtype.	Recompilation of a client program may be broken with the error message: struct wtap_dumper has no member named file_type.

	Change	Effect
1	Field number_of_interfaces has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct wtapng_iface_descriptions_s' has no member named 'number_of_interfaces'.

wtap-int.h
[+] struct wtap (1)
[+] struct wtap_dumper (3)

wtap.h
[+] struct wtapng_iface_descriptions_s (1)

to the top

Problems with Symbols, High Severity (4)

	Change	Effect
1	Parameter type of type unsigned int has been added to the calling stack at the middle position.	Recompilation of a client program may be broken.

	Change	Effect
1	Parameter buf of type Buffer* has been added to the calling stack at the middle position.	Recompilation of a client program may be broken.
2	4th middle parameter pd has been removed from the calling stack.	Recompilation of a client program may be broken.
3	5th middle parameter len has been removed from the calling stack.	Recompilation of a client program may be broken.

wtap.h
[+] wtap_open_offline ( char const* filename, int* err, gchar** err_info, gboolean do_random ) (1)
[+] wtap_seek_read ( wtap* wth, gint64 seek_off, struct wtap_pkthdr* phdr, guint8* pd, int len, int* err, gchar** err_info ) (3)

to the top

Problems with Symbols, Medium Severity (1)

	Change	Effect
1	Base type of parameter addrinfo_list has been changed from struct addrinfo to struct addrinfo_lists of different format.	Recompilation of a client program may be broken.

wtap.h
[+] wtap_dump_set_addrinfo_list ( wtap_dumper* wdh, struct addrinfo* addrinfo_list ) (1)

to the top

Problems with Data Types, Low Severity (3)

	Change	Effect
1	Base type has been changed from gboolean()(struct wtap,gint64,struct wtap_pkthdr,guint8,int,int,char) to gboolean()(struct wtap,gint64,struct wtap_pkthdr,Buffer,int,char**).	Recompilation of a client program may be broken.

	Change	Effect
1	Type of field channel has been changed from guint8 to guint32.	Recompilation of a client program may be broken.

	Change	Effect
1	Type of field ts has been changed from struct wtap_nstime to nstime_t.	Recompilation of a client program may be broken.

wtap-int.h
[+] typedef subtype_seek_read_func (1)

wtap.h
[+] struct bthci_phdr (1)
[+] struct wtap_pkthdr (1)

to the top

Problems with Constants (1)

	Change	Effect
1	The value of constant WS_DLL_PUBLIC has been changed from WS_DLL_PUBLIC_NOEXTERN extern to WS_DLL_PUBLIC_DEF extern.	Recompilation of a client program may be broken.

ws_symbol_export.h
[+] WS_DLL_PUBLIC

to the top

Other Changes in Data Types (8)

	Change	Effect
1	Field wslua_data has been added to this type.	No effect.

	Change	Effect
1	Field addrinfo_lists has been added to this type.	No effect.
2	Field wslua_data has been added to this type.	No effect.

	Change	Effect
1	Field ns_activity_offset has been added to this type.	No effect.

	Change	Effect
1	Field rec_type has been added to this type.	No effect.

	Change	Effect
1	Field btmon has been added to this type.	No effect.
2	Field ftsrec has been added to this type.	No effect.
3	Field logcat has been added to this type.	No effect.

wtap-int.h
[+] struct wtap (1)
[+] struct wtap_dumper (2)

wtap.h
[+] struct nstr_phdr (1)
[+] struct wtap_pkthdr (1)
[+] union wtap_pseudo_header (3)

to the top

Other Changes in Symbols (1)

	Change	Effect
1	2nd parameter addrinfo_list has been renamed to addrinfo_lists.	No effect.

wtap.h
[+] wtap_dump_set_addrinfo_list ( wtap_dumper* wdh, struct addrinfo* addrinfo_list ) (1)

to the top

Header Files (58)

to the top

Shared Libraries (1)

libwiretap.so.3.0.15

to the top

API compatibility report for the libwiretap library between 3.0.15 and 4.0.8 versions on x86_64

Test Info

Test Results

Problem Summary

Added Symbols (35)

Removed Symbols (14)

Problems with Data Types, High Severity (1)

Problems with Symbols, High Severity (4)

Problems with Data Types, Medium Severity (7)

Problems with Symbols, Medium Severity (1)

Problems with Data Types, Low Severity (10)

Problems with Symbols, Low Severity (1)

Header Files (58)

Shared Libraries (1)

Test Info

Test Results

Problem Summary

Added Symbols (35)

Removed Symbols (14)

Problems with Data Types, High Severity (5)

Problems with Symbols, High Severity (4)

Problems with Symbols, Medium Severity (1)

Problems with Data Types, Low Severity (3)

Problems with Constants (1)

Other Changes in Data Types (8)

Other Changes in Symbols (1)

Header Files (58)

Shared Libraries (1)