libip2location: 8.0.9 to 8.1.0 compatibility report

Test Info

Library Name	libip2location
Version #1	8.0.9
Version #2	8.1.0
Arch	x86_64
GCC Version	9
Subject	Binary Compatibility

Test Results

Total Header Files	1
Total Libraries	1
Total Symbols / Types	44 / 21
Compatibility	53.4%

Problem Summary

	Severity	Count
Added Symbols	-	10
Removed Symbols	High	10
Problems with Data Types	High	0
	Medium	13
	Low	20
Problems with Symbols	High	0
	Medium	0
	Low	22
Problems with Constants	Low	3
Other Changes in Constants	-	4

Added Symbols 10

IP2Location.h, libIP2Location.so.1.0.0
IP2Location_api_version_number ( )
IP2Location_clear_memory ( )
IP2Location_close_memory ( FILE* file )
IP2Location_delete_shared_memory ( )
IP2Location_read_float ( FILE* handle, uint32_t position )
IP2Location_read_ipv6_address ( FILE* handle, uint32_t position )
IP2Location_read_string ( FILE* handle, uint32_t position )
IP2Location_set_lookup_mode ( struct IP2Location* handler, enum IP2Location_lookup_mode p2 )
IP2Location_set_memory_cache ( FILE* file )
IP2Location_set_shared_memory ( FILE* file )

to the top

Removed Symbols 10

IP2Loc_DBInterface.h, libIP2Location.so.1.0.0
IP2Location_DB_close ( FILE* filehandle )
IP2Location_DB_del_shm ( )
IP2Location_DB_set_memory_cache ( FILE* filehandle )
IP2Location_DB_set_shared_memory ( FILE* filehandle )
IP2Location_readFloat ( FILE* handle, uint32_t position )
IP2Location_readIPv6Address ( FILE* handle, uint32_t position )
IP2Location_readStr ( FILE* handle, uint32_t position )

IP2Location.h, libIP2Location.so.1.0.0
IP2Location_api_version_num ( )
IP2Location_delete_shm ( )
IP2Location_open_mem ( struct IP2Location* loc, enum IP2Location_mem_type p2 )

to the top

Problems with Data Types, Medium Severity 13

	Change	Effect
1	Field mobile_brand 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 time_zone 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 usage_type 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.
4	Field zip_code 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.
5	The relative position of field domain has been changed from 7 to 5.	Applications will access incorrect memory when attempting to access this field.
6	The relative position of field latitude has been changed from 5 to 13.	Applications will access incorrect memory when attempting to access this field.
7	The relative position of field longitude has been changed from 6 to 14.	Applications will access incorrect memory when attempting to access this field.
8	The relative position of field mcc has been changed from 13 to 11.	Applications will access incorrect memory when attempting to access this field.
9	The relative position of field mnc has been changed from 14 to 12.	Applications will access incorrect memory when attempting to access this field.
10	Field usagetype has been removed from this type.	Applications will access incorrect memory when attempting to access this field.
11	Field mobilebrand 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.
12	Field weatherstationcode 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.
13	Field weatherstationname 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.

IP2Location.h
[+] struct IP2LocationRecord 13

to the top

Problems with Data Types, Low Severity 20

	Change	Effect
1	Field databaseaddr has been renamed to database_address.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
2	Field databasecolumn has been renamed to database_column.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
3	Field databasecount has been renamed to database_count.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
4	Field databaseday has been renamed to database_day.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
5	Field databasemonth has been renamed to database_month.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
6	Field databasetype has been renamed to database_type.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
7	Field databaseyear has been renamed to database_year.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
8	Field filehandle has been renamed to file.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
9	Field ipv4databaseaddr has been renamed to ipv4_database_address.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
10	Field ipv4databasecount has been renamed to ipv4_database_count.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
11	Field ipv4indexbaseaddr has been renamed to ipv4_index_base_address.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
12	Field ipv6databaseaddr has been renamed to ipv6_database_address.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
13	Field ipv6databasecount has been renamed to ipv6_database_count.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
14	Field ipv6indexbaseaddr has been renamed to ipv6_index_base_address.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
15	Field ipversion has been renamed to ip_version.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.

	Change	Effect
1	Field areacode has been renamed to weather_station_name.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
2	Field iddcode has been renamed to weather_station_code.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
3	Field netspeed has been renamed to area_code.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
4	Field timezone has been renamed to idd_code.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.
5	Field zipcode has been renamed to net_speed.	Renaming of a field in data type may indicate a change in the semantic meaning of the field.

IP2Location.h
[+] struct IP2Location 15
[+] struct IP2LocationRecord 5

to the top

Problems with Symbols, Low Severity 22

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

IP2Location.h, libIP2Location.so.1.0.0
[+] IP2Location_close ( struct IP2Location* loc ) 1
[+] IP2Location_get_all ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_areacode ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_city ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_country_long ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_country_short ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_domain ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_elevation ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_iddcode ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_isp ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_latitude ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_longitude ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_mcc ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_mnc ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_mobilebrand ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_region ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_timezone ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_usagetype ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_weatherstationcode ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_weatherstationname ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_zipcode ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_open ( char* db ) 1

to the top

Problems with Constants, Low Severity 3

	Change	Effect
1	The constant DOMAIN_ with value 0x00080 has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant INVALID_IPV4_ADDRESS with value "INVALID IPV4 ADDRESS" has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

	Change	Effect
1	The constant INVALID_IPV6_ADDRESS with value "INVALID IPV6 ADDRESS" has been removed.	The value of this constant may no longer be properly handled by new-version library functions.

IP2Location.h
[+] DOMAIN_
[+] INVALID_IPV4_ADDRESS
[+] INVALID_IPV6_ADDRESS

to the top

Other Changes in Constants 4

	Change	Effect
1	The constant DOMAINNAME with value 0x00080 has been added.	No effect.

	Change	Effect
1	The constant INVALID_IP_ADDRESS with value "INVALID IP ADDRESS" has been added.	No effect.

	Change	Effect
1	The constant IPV6_ADDRESS_MISSING_IN_IPV4_BIN with value "IPV6 ADDRESS MISSING IN IPV4 BIN" has been added.	No effect.

	Change	Effect
1	The constant MAP_ADDR with value 4194500608 has been added.	No effect.

IP2Location.h
[+] DOMAINNAME
[+] INVALID_IP_ADDRESS
[+] IPV6_ADDRESS_MISSING_IN_IPV4_BIN
[+] MAP_ADDR

to the top

Header Files 1

IP2Location.h

to the top

Libraries 1

libIP2Location.so.1.0.0

to the top

Test Info

Library Name	libip2location
Version #1	8.0.9
Version #2	8.1.0
Arch	x86_64
Subject	Source Compatibility

Test Results

Total Header Files	1
Total Libraries	1
Total Symbols / Types	287 / 76
Compatibility	87.8%

Problem Summary

	Severity	Count
Added Symbols	-	11
Removed Symbols	High	12
Problems with Data Types	High	24
	Medium	0
	Low	4
Problems with Symbols	High	0
	Medium	0
	Low	0
Problems with Constants	Low	6
Other Changes in Data Types	-	5
Other Changes in Symbols	-	22
Other Changes in Constants	-	5

Added Symbols 11

IP2Location.h
IP2Location_api_version_number ( )
IP2Location_clear_memory ( )
IP2Location_close_memory ( FILE* file )
IP2Location_delete_shared_memory ( )
IP2Location_get_net_speed ( struct IP2Location* handler, char* ip )
IP2Location_read_float ( FILE* handle, uint32_t position )
IP2Location_read_ipv6_address ( FILE* handle, uint32_t position )
IP2Location_read_string ( FILE* handle, uint32_t position )
IP2Location_set_lookup_mode ( struct IP2Location* handler, enum IP2Location_lookup_mode p2 )
IP2Location_set_memory_cache ( FILE* file )
IP2Location_set_shared_memory ( FILE* file )

to the top

Removed Symbols 12

IP2Loc_DBInterface.h
IP2Location_DB_close ( FILE* filehandle )
IP2Location_DB_del_shm ( )
IP2Location_DB_set_file_io ( )
IP2Location_DB_set_memory_cache ( FILE* filehandle )
IP2Location_DB_set_shared_memory ( FILE* filehandle )
IP2Location_readFloat ( FILE* handle, uint32_t position )
IP2Location_readIPv6Address ( FILE* handle, uint32_t position )
IP2Location_readStr ( FILE* handle, uint32_t position )

IP2Location.h
IP2Location_api_version_num ( )
IP2Location_delete_shm ( )
IP2Location_get_netspeed ( struct IP2Location* loc, char* ip )
IP2Location_open_mem ( struct IP2Location* loc, enum IP2Location_mem_type p2 )

to the top

Problems with Data Types, High Severity 24

	Change	Effect
1	Field databaseaddr has been renamed to database_address.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named databaseaddr.
2	Field databasecolumn has been renamed to database_column.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named databasecolumn.
3	Field databasecount has been renamed to database_count.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named databasecount.
4	Field databaseday has been renamed to database_day.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named databaseday.
5	Field databasemonth has been renamed to database_month.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named databasemonth.
6	Field databasetype has been renamed to database_type.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named databasetype.
7	Field databaseyear has been renamed to database_year.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named databaseyear.
8	Field filehandle has been renamed to file.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named filehandle.
9	Field ipv4databaseaddr has been renamed to ipv4_database_address.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named ipv4databaseaddr.
10	Field ipv4databasecount has been renamed to ipv4_database_count.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named ipv4databasecount.
11	Field ipv4indexbaseaddr has been renamed to ipv4_index_base_address.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named ipv4indexbaseaddr.
12	Field ipv6databaseaddr has been renamed to ipv6_database_address.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named ipv6databaseaddr.
13	Field ipv6databasecount has been renamed to ipv6_database_count.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named ipv6databasecount.
14	Field ipv6indexbaseaddr has been renamed to ipv6_index_base_address.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named ipv6indexbaseaddr.
15	Field ipversion has been renamed to ip_version.	Recompilation of a client program may be broken with the error message: struct IP2Location has no member named ipversion.

	Change	Effect
1	Field mobilebrand has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct IP2LocationRecord' has no member named 'mobilebrand'.
2	Field usagetype has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct IP2LocationRecord' has no member named 'usagetype'.
3	Field weatherstationcode has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct IP2LocationRecord' has no member named 'weatherstationcode'.
4	Field weatherstationname has been removed from this type.	Recompilation of a client program may be broken with the error message: 'struct IP2LocationRecord' has no member named 'weatherstationname'.
5	Field areacode has been renamed to weather_station_name.	Recompilation of a client program may be broken with the error message: struct IP2LocationRecord has no member named areacode.
6	Field iddcode has been renamed to weather_station_code.	Recompilation of a client program may be broken with the error message: struct IP2LocationRecord has no member named iddcode.
7	Field netspeed has been renamed to area_code.	Recompilation of a client program may be broken with the error message: struct IP2LocationRecord has no member named netspeed.
8	Field timezone has been renamed to idd_code.	Recompilation of a client program may be broken with the error message: struct IP2LocationRecord has no member named timezone.
9	Field zipcode has been renamed to net_speed.	Recompilation of a client program may be broken with the error message: struct IP2LocationRecord has no member named zipcode.

IP2Location.h
[+] struct IP2Location 15
[+] struct IP2LocationRecord 9

to the top

Problems with Data Types, Low Severity 4

	Change	Effect
1	Field mobile_brand has been added to this type.	This field will not be initialized or used by old client applications.
2	Field time_zone has been added to this type.	This field will not be initialized or used by old client applications.
3	Field usage_type has been added to this type.	This field will not be initialized or used by old client applications.
4	Field zip_code has been added to this type.	This field will not be initialized or used by old client applications.

IP2Location.h
[+] struct IP2LocationRecord 4

to the top

Problems with Constants, Low Severity 6

	Change	Effect
1	The value of constant API_VERSION has been changed from 8.0.9 to 8.1.0.	Recompilation of a client program may be broken.

	Change	Effect
1	The value of constant API_VERSION_MINOR has been changed from 0 to 1.	Recompilation of a client program may be broken.

	Change	Effect
1	The value of constant API_VERSION_RELEASE has been changed from 9 to 0.	Recompilation of a client program may be broken.

	Change	Effect
1	The constant DOMAIN_ with value 0x00080 has been removed.	Recompilation of a client program may be broken.

	Change	Effect
1	The constant INVALID_IPV4_ADDRESS with value "INVALID IPV4 ADDRESS" has been removed.	Recompilation of a client program may be broken.

	Change	Effect
1	The constant INVALID_IPV6_ADDRESS with value "INVALID IPV6 ADDRESS" has been removed.	Recompilation of a client program may be broken.

IP2Location.h
[+] API_VERSION
[+] API_VERSION_MINOR
[+] API_VERSION_RELEASE
[+] DOMAIN_
[+] INVALID_IPV4_ADDRESS
[+] INVALID_IPV6_ADDRESS

to the top

Other Changes in Data Types 5

	Change	Effect
1	The relative position of field domain has been changed from 7 to 5.	No effect.
2	The relative position of field latitude has been changed from 5 to 13.	No effect.
3	The relative position of field longitude has been changed from 6 to 14.	No effect.
4	The relative position of field mcc has been changed from 13 to 11.	No effect.
5	The relative position of field mnc has been changed from 14 to 12.	No effect.

IP2Location.h
[+] struct IP2LocationRecord 5

to the top

Other Changes in Symbols 22

	Change	Effect
1	1st parameter loc has been renamed to handler.	No effect.

	Change	Effect
1	1st parameter loc has been renamed to handler.	No effect.

IP2Location.h
[+] IP2Location_close ( struct IP2Location* loc ) 1
[+] IP2Location_get_all ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_areacode ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_city ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_country_long ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_country_short ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_domain ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_elevation ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_iddcode ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_isp ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_latitude ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_longitude ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_mcc ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_mnc ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_mobilebrand ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_region ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_timezone ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_usagetype ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_weatherstationcode ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_weatherstationname ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_get_zipcode ( struct IP2Location* loc, char* ip ) 1
[+] IP2Location_open ( char* db ) 1

to the top

Other Changes in Constants 5

IP2Location.h
[+] DOMAINNAME
[+] INVALID_IP_ADDRESS
[+] IP2LOCATION_SHM
[+] IPV6_ADDRESS_MISSING_IN_IPV4_BIN
[+] MAP_ADDR

to the top

Header Files 1

IP2Location.h

to the top

Libraries 1

libIP2Location.so.1.0.0

to the top

API compatibility report for the libip2location library between 8.0.9 and 8.1.0 versions on x86_64

Test Info

Test Results

Problem Summary

Added Symbols 10

Removed Symbols 10

Problems with Data Types, Medium Severity 13

Problems with Data Types, Low Severity 20

Problems with Symbols, Low Severity 22

Problems with Constants, Low Severity 3

Other Changes in Constants 4

Header Files 1

Libraries 1

Test Info

Test Results

Problem Summary

Added Symbols 11

Removed Symbols 12

Problems with Data Types, High Severity 24

Problems with Data Types, Low Severity 4

Problems with Constants, Low Severity 6

Other Changes in Data Types 5

Other Changes in Symbols 22

Other Changes in Constants 5

Header Files 1

Libraries 1