欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

处理MaxMind数据库文件的库libmaxminddb使用介绍

程序员文章站 2022-06-17 19:23:09
名字 libmaxminddb - 用于处理 MaxMind 数据库文件的库 简介 #include int MMDB_open( const char...

名字

libmaxminddb - 用于处理 MaxMind 数据库文件的库

简介

#include 

int MMDB_open(
    const char *const filename,
    uint32_t flags,
    MMDB_s *const mmdb);
void MMDB_close(MMDB_s *const mmdb);

MMDB_lookup_result_s MMDB_lookup_string(
    MMDB_s *const mmdb,
    const char *const ipstr,
    int *const gai_error,
    int *const mmdb_error);
MMDB_lookup_result_s MMDB_lookup_sockaddr(
    MMDB_s *const mmdb,
    const struct sockaddr *const
    sockaddr,
    int *const mmdb_error);

int MMDB_get_value(
    MMDB_entry_s *const start,
    MMDB_entry_data_s *const entry_data,
    ...);
int MMDB_vget_value(
    MMDB_entry_s *const start,
    MMDB_entry_data_s *const entry_data,
    va_list va_path);
int MMDB_aget_value(
    MMDB_entry_s *const start,
    MMDB_entry_data_s *const entry_data,
    const char *const *const path);

int MMDB_get_entry_data_list(
    MMDB_entry_s *start,
    MMDB_entry_data_list_s **const entry_data_list);
void MMDB_free_entry_data_list(
    MMDB_entry_data_list_s *const entry_data_list);
int MMDB_get_metadata_as_entry_data_list(
    MMDB_s *const mmdb,
    MMDB_entry_data_list_s **const entry_data_list);
int MMDB_dump_entry_data_list(
    FILE *const stream,
    MMDB_entry_data_list_s *const entry_data_list,
    int indent);

int MMDB_read_node(
    MMDB_s *const mmdb,
    uint32_t node_number,
    MMDB_search_node_s *const node);

const char *MMDB_lib_version(void);
const char *MMDB_strerror(int error_code);

typedef struct MMDB_lookup_result_s {
    bool found_entry;
    MMDB_entry_s entry;
    uint16_t netmask;
} MMDB_lookup_result_s;

typedef struct MMDB_entry_data_s {
    bool has_data;
    union {
        uint32_t pointer;
        const char *utf8_string;
        double double_value;
        const uint8_t *bytes;
        uint16_t uint16;
        uint32_t uint32;
        int32_t int32;
        uint64_t uint64;
        {mmdb_uint128_t or uint8_t[16]} uint128;
        bool boolean;
        float float_value;
    };
    ...
    uint32_t data_size;
    uint32_t type;
} MMDB_entry_data_s;

typedef struct MMDB_entry_data_list_s {
    MMDB_entry_data_s entry_data;
    struct MMDB_entry_data_list_s *next;
} MMDB_entry_data_list_s;

描述

libmaxminddb 库提供用于处理 MaxMind DB 文件的功能。数据库和结果都由不同的数据结构表示。通过调用MMDB_open()打开数据库。 您可以使用MMDB_lookup_string()查找 IP 地址,或者使用MMDB_lookup_sockaddr()指向sockaddr结构的指针。

如果查找查找数据库中的IP地址,则返回MMDB_lookup_result_s结构。如果该结构表明数据库具有该IP的数据,则可以使用许多函数获取该数据。这些包括MMDB_get_value()和MMDB_get_entry_data_list()。

数据结构

由该库的maxminddb.h头文件导出的所有数据结构都是以typedef struct foo_s {...} foo_s的形式,因此您可以引用它们而不使用struct前缀。

该库提供以下数据结构:

MMDB_s

这是 MaxMind DB 文件的句柄。我们只记录了这个结构的一些供公众使用的字段。所有其他字段可能会更改,仅供内部使用。

typedef struct MMDB_s {
    uint32_t flags;
    const char *filename;
    ...
    MMDB_metadata_s metadata;
} MMDB_s;
uint32_t flags - 这个数据库打开的标志。

MMDB_metadata_s 和 MMDB_description_s

可以从MMDB_s结构获取此结构。它包含从数据库文件读取的元数据。 注意,你可以通过调用MMDB_get_metadata_as_entry_data_list()来更方便地访问元数据。

typedef struct MMDB_metadata_s {
    uint32_t node_count;
    uint16_t record_size;
    uint16_t ip_version;
    const char *database_type;
    struct {
        size_t count;
        const char **names;
    } languages;
    uint16_t binary_format_major_version;
    uint16_t binary_format_minor_version;
    uint64_t build_epoch;
    struct {
        size_t count;
        MMDB_description_s **descriptions;
    } description;
} MMDB_metadata_s;

typedef struct MMDB_description_s {
    const char *language;
    const char *description;
} MMDB_description_s;

这些结构大多是不言自明的。

ip_version应始终为4或6。binary_format_major_version应始终为2。

不要求数据库元数据包括语言或描述,因此元数据的这些部分的count可以为零。 MMDB_metadata_s的其他所有字段都应该被填充。

MMDB_lookup_result_s

这个结构作为查找IP的结果返回。

typedef struct MMDB_lookup_result_s {
    bool found_entry;
    MMDB_entry_s entry;
    uint16_t netmask;
} MMDB_lookup_result_s;

如果found_entry为 false,则该结构的其他成员不包含有意义的值。 应始终首先检查found_entry是否为真。

entry用于查找与IP地址相关的数据。

netmask表示该数据库中IP地址属于哪个子网。 例如,如果在 IPv4 数据库中查找地址1.1.1.1,并且返回的netmask为16,则该地址是1.1.0.0/16子网的一部分。

如果数据库是 IPv6 数据库,则返回的网络掩码始终是 IPv6 前缀长度(从0到128),即使该数据库还包含 IPv4 网络。 如果您查找 IPv4 地址,并希望将网络掩码转换为 IPv4 网络掩码值,则可以从值中减去96。

MMDB_result_s

不需要挖掘这个结构。你将从MMDB_lookup_result_s结构中得到这个结果,并将其传递给各种函数。

MMDB_entry_data_s

此结构用于返回 IP 的单个数据段条目。 这些条目可以反过来指向其他条目,就像 maps 和 arrays。这种结构的一些成员没有记录,因为它们仅供内部使用。

typedef struct MMDB_entry_data_s {
    bool has_data;
    union {
        uint32_t pointer;
        const char *utf8_string;
        double double_value;
        const uint8_t *bytes;
        uint16_t uint16;
        uint32_t uint32;
        int32_t int32;
        uint64_t uint64;
        {mmdb_uint128_t or uint8_t[16]} uint128;
        bool boolean;
        float float_value;
    };
    ...
    uint32_t data_size;
    uint32_t type;
} MMDB_entry_data_s;

如果对于给定的查询找到数据,则has_data成员为 true。更多详细信息,请参阅MMDB_get_value()。如果该成员为 false,那么结构中的其他值都没有意义。

结构开始时的 union 定义了实际数据。要确定哪个 union 成员被填充,应该查看type成员。 不应该在 API 返回的任何数据中填充 union 的pointer成员。指针应该始终在内部解决。

data_size成员仅与utf8_string和bytes数据相关。 utf8_string不以 null 结尾,必须使用data_size来确定其长度。

type成员可以与MMDB_DTYPE_ *宏中的一个进行比较。

128位整型

uint128数据的处理取决于你的平台如何支持 128 位整型。使用 GCC 4.4 和 4.5,我们可以写成unsigned int __attribute__ ((__mode__ (TI)))。 使用较新版本的 GCC(4.6+) 和 clang(3.2+),我们可以简单地写成“unsigned __int128”。

为了解决这些差异,这个库定义了一个mmdb_uint128_t类型。 此类型在maxminddb.h头文件中定义,因此您可以在自己的代码中使用它。

对于较老的编译器,我们不能使用整型,所以我们通过 16 字节的数组替代uint8_t的值。这是数据库中的原始数据。

该库提供了一个公共宏MMDB_UINT128_IS_BYTE_ARRAY。 如果为 true,那么uint128值作为字节数组返回,如果是 false,那么它们返回为mmdb_uint128_t整型。

数据类型的宏

该库为 MaxMind DB 定义的每种数据类型提供一个宏。

MMDB_DATA_TYPE_UTF8_STRING MMDB_DATA_TYPE_DOUBLE MMDB_DATA_TYPE_BYTES MMDB_DATA_TYPE_UINT16 MMDB_DATA_TYPE_UINT32 MMDB_DATA_TYPE_MAP MMDB_DATA_TYPE_INT32 MMDB_DATA_TYPE_UINT64 MMDB_DATA_TYPE_UINT128 MMDB_DATA_TYPE_ARRAY MMDB_DATA_TYPE_BOOLEAN MMDB_DATA_TYPE_FLOAT

还有一些仅供内部使用的类型:

MMDB_DATA_TYPE_EXTENDED MMDB_DATA_TYPE_POINTER MMDB_DATA_TYPE_CONTAINER MMDB_DATA_TYPE_END_MARKER

如果您在返回的数据中看到其中的一个,那么一定是发生错误了。 可能是数据库已损坏或生成不正确或 libmaxminddb 代码中存在错误。

指针的值和MMDB_close()

utf8_string,bytes和(也许)这个结构的uint128成员都是直接指向数据库数据部分的指针。这可能是一个malloc或mmap的内存块。在这两种情况下,调用MMDB_close()后,这些指针将变为无效。

如果您在此之后需要引用此数据,则应使用适当的函数(strdup,memcpy等)复制数据。

MMDB_entry_data_list_s

该结构封装了MMDB_entry_data_s结构的链表。

typedef struct MMDB_entry_data_list_s {
    MMDB_entry_data_s entry_data;
    struct MMDB_entry_data_list_s *next;
} MMDB_entry_data_list_s;

此结构可让您通过遍历链表来查看整个 map 或 array 数据。

MMDB_search_node_s

该结构将两个记录封装在搜索节点中。如果您想要编写遍历整个搜索树的代码,而不是查找特定的 IP 地址,这是非常有用的。

typedef struct MMDB_search_node_s {
    uint64_t left_record;
    uint64_t right_record;
    uint8_t left_record_type;
    uint8_t right_record_type;
    MMDB_entry_s left_record_entry;
    MMDB_entry_s right_record_entry;
} MMDB_search_node_s;

两种记录类型将采用以下值之一:

MMDB_RECORD_TYPE_SEARCH_NODE - 记录指向下一个搜索节点。 MMDB_RECORD_TYPE_EMPTY - 记录是一个占位符,表示没有 IP 地址的数据。搜索应该在此处结束。 MMDB_RECORD_TYPE_DATA - 记录用于数据库数据部分中的数据。查找记录的数据时,使用记录条目。 MMDB_RECORD_TYPE_INVALID - 记录无效。查找无效节点或数据库已损坏。

MMDB_entry_s仅在类型为MMDB_RECORD_TYPE_DATA时有效。尝试使用其他记录类型的条目将导致错误或无效的数据。

状态码

该库返回(或填充)许多函数的状态码。这些状态码是:

MMDB_SUCCESS - 一切正常 MMDB_FILE_OPEN_ERROR - 尝试打开 MaxMind DB 文件时出错。 MMDB_IO_ERROR - IO 操作失败。检查 errno 获取更多的细节。 MMDB_CORRUPT_SEARCH_TREE_ERROR - 在搜索树中查找 IP 地址,给了我们一个不可能的结果。数据库已损坏或生成不正确或 libmaxminddb 代码中存在错误。 MMDB_INVALID_METADATA_ERROR - 数据库中的某些内容是错误的。包括丢失的元数据以及不可能的值(如ip_version为7)。 MMDB_UNKNOWN_DATABASE_FORMAT_ERROR - 数据库元数据表明它的主版本不是 2。该库只能处理版本 2。 MMDB_OUT_OF_MEMORY_ERROR - 内存分配调用(malloc等)失败。 MMDB_INVALID_DATA_ERROR - 数据部分中的条目包含无效数据。例如,一个uint16字段声称超过 2 个字节长。数据库可能已损坏或生成不正确。 MMDB_INVALID_LOOKUP_PATH_ERROR - 传递给MMDB_get_value,MMDB_vget_value或MMDB_aget_value的查找路径包含一个数组偏移量为负整数或大于 LONG_MAX 的整数。 MMDB_LOOKUP_PATH_DOES_NOT_MATCH_DATA_ERROR - 传递到MMDB_get_value,MMDB_vget_value或MMDB_aget_value的查找路径与条目的数据结构不匹配。有很多原因可能会发生。查找路径可以包括不在 map 中的 key。查找路径可以包括大于数组的索引。当路径期望找到不存在的 map 或 array 时,也可能发生。

所有状态代码都应该被视为int值。

MMDB_strerror()

const char *MMDB_strerror(int error_code)

此函数需要状态代码并返回一个解释状态的字符串。

函数

此库提供以下导出的函数:

MMDB_open()

int MMDB_open(
    const char *const filename,
    uint32_t flags,
    MMDB_s *const mmdb);

此函数打开 MaxMind DB 文件的句柄。它的返回值是上面定义的状态代码。始终检查此调用的返回值。

MMDB_s mmdb;
int status =
    MMDB_open("/path/to/file.mmdb", MMDB_MODE_MMAP, &mmdb);
if (MMDB_SUCCESS != status) { ... }
...
MMDB_close(&mmdb);

传入的MMDB_s结构可以在栈中或从堆中分配。但是,如果打开成功,它将包含堆分配的数据,因此需要使用MMDB_close()关闭它。如果返回的状态不是MMDB_SUCCESS,那么这个库确保在返回之前释放所有分配的内存。

目前提供的 flags 是:

MMDB_MODE_MMAP - 用mmap()打开数据库。

传递其他值的flags可能会产生不可预知的结果。将来我们可以添加额外的 flags,可以按位或与模式一起,以及其他模式。

也可以传递0作为flags值,在这种情况下,数据库将使用默认 flags 打开。然而,这些默认值可能会在将来的版本中更改。当前默认值为MMDB_MODE_MMAP。

MMDB_close()

void MMDB_close(MMDB_s *const mmdb);

释放从MMDB_s结构中保留的任何已分配的或 mmap 的内存。它不释放分配给结构本身的内存! 如果你从堆中分配了结构,那么你将负责释放它。

MMDB_lookup_string()

MMDB_lookup_result_s MMDB_lookup_string(
    MMDB_s *const mmdb,
    const char *const ipstr,
    int *const gai_error,
    int *const mmdb_error);

此函数查找以 null 结尾的 IP 地址。在内部,它调用getaddrinfo()来将地址解析为二进制形式。 然后它调用MMDB_lookup_sockaddr()来查找数据库中的地址。如果您已经解析了一个地址,可以直接调用MMDB_lookup_sockaddr(),而不用两次解析地址。

int gai_error, mmdb_error;
MMDB_lookup_result_s result =
    MMDB_lookup_string(&mmdb, "1.2.3.4", &gai_error, &mmdb_error);
if (0 != gai_error) { ... }
if (MMDB_SUCCESS != mmdb_error) { ... }

if (result.found_entry) { ... }

此函数始终返回一个MMDB_lookup_result_s结构,但您也应该检查gai_error和mmdb_error参数。如果这些中的任何一个错误,则返回的结构是无意义的。

如果没有发生错误,您仍然需要确保返回结果中的found_entry成员为 true。 如果不是,这意味着 IP 地址在数据库中没有条目。

即使数据库包含 IPv4 和 IPv6 地址的数据,此函数也可以与 IPv4 地址一起使用。IPv4 地址将被查找为“::xxx.xxx.xxx.xxx”,而不是重新映射到为 IPv4 映射的 IPv6 地址分配的:: ffff:xxx.xxx.xxx.xxx块。

如果将 IPv6 地址传递到只有 IPv4 数据的数据库,那么found_entry将为 false,但是mmdb_error状态仍将是MMDB_SUCCESS。

MMDB_lookup_sockaddr()

MMDB_lookup_result_s MMDB_lookup_sockaddr(
    MMDB_s *const mmdb,
    const struct sockaddr *const sockaddr,
    int *const mmdb_error);

此函数查找已由getaddrinfo()解析的 IP 地址。

除了不调用getaddrinfo(),此函数与MMDB_lookup_string()函数相同。

int mmdb_error;
MMDB_lookup_result_s result =
    MMDB_lookup_sockaddr(&mmdb, address->ai_addr, &mmdb_error);
if (MMDB_SUCCESS != mmdb_error) { ... }

if (result.found_entry) { ... }

数据查找函数

有 3 个函数与查找 IP 地址相关。

int MMDB_get_value(
    MMDB_entry_s *const start,
    MMDB_entry_data_s *const entry_data,
    ...);
int MMDB_vget_value(
    MMDB_entry_s *const start,
    MMDB_entry_data_s *const entry_data,
    va_list va_path);
int MMDB_aget_value(
    MMDB_entry_s *const start,
    MMDB_entry_data_s *const entry_data,
    const char *const *const path);

这三个函数允许三种略有不同的调用风格,但它们都做同样的事情。

第一个参数是MMDB_entry_s值。在大多数情况下,这将来自MMDB_lookup_string()或MMDB_lookup_sockaddr()返回的MMDB_lookup_result_s值。

第二个参数是对MMDB_entry_data_s结构的引用。这将被填充正在查找的数据(如果有)。如果没有找到,那么这个结构的has_data成员将是 false。如果has_data为 true,那么可以查看data_type成员。

最后一个参数是查找路径。该路径由表示在查找中使用的 map keys(例如,“城市”)或数组索引(例如,“0”,“1”)的字符串组成。这允许您操纵复杂的数据结构。例如:

{
    "names": {
        "en": "Germany",
        "de": "Deutschland"
    },
    "cities": [ "Berlin", "Frankfurt" ]
}

我们可以使用以下代码查找英文名称:

MMDB_lookup_result_s result =
    MMDB_lookup_sockaddr(&mmdb, address->ai_addr, &mmdb_error);
MMDB_entry_data_s entry_data;
int status =
    MMDB_get_value(&result.entry, &entry_data,
                   "names", "en", NULL);
if (MMDB_SUCCESS != status) { ... }
if (entry_data.has_data) { ... }

如果我们想找到第一个城市,查找路径将是"cities", "0"。如果没有提供查找路径,将获得与* map 对应的条目。查找路径必须始终以NULL结尾,无论您调用哪个函数。

MMDB_get_value函数接受可变数量的参数。MMDB_entry_data_s *结构指针之后的所有参数都是查找路径。最后一个参数必须为NULL。

MMDB_vget_value函数接受一个va_list作为查找路径。va_arg()检索的最后一个元素必须为NULL。

最后,MMDB_aget_value接受字符串数组作为查找路径。该数组的最后一个成员必须为NULL。

如果要一次获取所有条目数据,可以调用MMDB_get_entry_data_list()。

对于三个函数中的每个函数,返回值是如上定义的状态代码。

MMDB_get_entry_data_list()

int MMDB_get_entry_data_list(
    MMDB_entry_s *start,
    MMDB_entry_data_list_s **const entry_data_list);

此函数允许一次获取复杂数据结构的所有数据,而不是重复调用MMDB_get_value()查找每个数据。

MMDB_lookup_result_s result =
    MMDB_lookup_sockaddr(&mmdb, address->ai_addr, &mmdb_error);
MMDB_entry_data_list_s *entry_data_list, *first;
int status =
    MMDB_get_entry_data_list(&result.entry, &entry_data_list);
if (MMDB_SUCCESS != status) { ... }
// save this so we can free this data later
first = entry_data_list;

while (1) {
    MMDB_entry_data_list_s *next = entry_data_list = entry_data_list->next;
    if (NULL == next) {
        break;
    }

    switch (next->entry_data.type) {
        case MMDB_DATA_TYPE_MAP: { ... }
        case MMDB_DATA_TYPE_UTF8_STRING: { ... }
        ...
    }
}

MMDB_free_entry_data_list(first);

您可以解释entry_data_list数据结构。列表以深度优先遍历连接。我们以这种结构为例:

{
    "names": {
        "en": "Germany",
        "de": "Deutschland"
    },
    "cities": [ "Berlin", "Frankfurt" ]
}

该清单将包括以下项目:

MAP - * map UTF8_STRING - “名称”键 MAP - “名称”键的 map UTF8_STRING - “en”键 UTF8_STRING - “en”键的值 UTF8_STRING - “de”键 UTF8_STRING - “de”键的值 UTF8_STRING - “cities”键 ARRAY - “cities”键的值 UTF8_STRING - 数组[0] UTF8_STRING - 数组[1]

函数的返回值是如上定义的状态码。

MMDB_free_entry_data_list()

void MMDB_free_entry_data_list(
    MMDB_entry_data_list_s *const entry_data_list);

MMDB_get_entry_data_list()和MMDB_get_metadata_as_entry_data_list()函数将从堆中分配链表结构。调用此函数释放MMDB_entry_data_list_s结构。

MMDB_get_metadata_as_entry_data_list()

int MMDB_get_metadata_as_entry_data_list(
    MMDB_s *const mmdb,
    MMDB_entry_data_list_s **const entry_data_list);

此函数允许获取数据库元数据作为MMDB_entry_data_list_s结构的链表。这可以是直接使用元数据结构来处理元数据的更方便的方法。

MMDB_entry_data_list_s *entry_data_list, *first;
int status =
    MMDB_get_metadata_as_entry_data_list(&mmdb, &entry_data_list);
if (MMDB_SUCCESS != status) { ... }
first = entry_data_list;
... // do something with the data
MMDB_free_entry_data_list(first);

函数的返回值是如上定义的状态码。

MMDB_dump_entry_data_list()

int MMDB_dump_entry_data_list(
    FILE *const stream,
    MMDB_entry_data_list_s *const entry_data_list,
    int indent);

此函数接收MMDB_entry_data_list_s结构的链表,并将其字符串给stream。indent参数是生成输出的起始缩进级别。嵌套数据结构(maps,array 等)递增。

stream必须是文件句柄(stdout等)。如果您的平台提供了类似 GNU open_memstream()的功能,你可以使用它来以字符串形式捕获输出。

输出以 JSON-ish 格式进行格式化,但值以其数据类型标记(除了分别用“{}”和“[]”显示的 maps 和 arrays)。

具体的输出格式可能会在将来的版本中更改,因此您不应该依赖此功能生成的特定格式。 它旨在用于以可读方式向用户显示数据,并用于调试目的。

函数的返回值是如上定义的状态码。

MMDB_read_node()

int MMDB_read_node(
    MMDB_s *const mmdb,
    uint32_t node_number,
    MMDB_search_node_s *const node);

读取搜索树中的特定节点。第三个参数是对该函数的MMDB_search_node_s结构的引用。

返回值是状态码。如果传递的node_number大于数据库中的节点数,则此函数将返回MMDB_INVALID_NODE_NUMBER_ERROR,否则返回MMDB_SUCCESS。

搜索树中的第一个节点始终是节点 0。如果要遍历整个搜索树,您将首先读取节点 0,然后根据每个记录的类型,按照构成该节点的记录进行跟踪。如果类型为MMDB_RECORD_TYPE_SEARCH_NODE,那么该记录将包含一个整数,以便下一个查找节点。

MMDB_lib_version()

const char *MMDB_lib_version(void)

这个函数返回一个字符串的库版本,类似“2.0.0”。

例子

#include 
#include 
#include 
#include 

int main(int argc, char **argv)
{
    char *filename = argv[1];
    char *ip_address = argv[2];

    MMDB_s mmdb;
    int status = MMDB_open(filename, MMDB_MODE_MMAP, &mmdb);

    if (MMDB_SUCCESS != status) {
        fprintf(stderr, "\n  Can't open %s - %s\n",
                filename, MMDB_strerror(status));

        if (MMDB_IO_ERROR == status) {
            fprintf(stderr, "    IO error: %s\n", strerror(errno));
        }
        exit(1);
    }

    int gai_error, mmdb_error;
    MMDB_lookup_result_s result =
        MMDB_lookup_string(&mmdb, ip_address, &gai_error, &mmdb_error);

    if (0 != gai_error) {
        fprintf(stderr,
                "\n  Error from getaddrinfo for %s - %s\n\n",
                ip_address, gai_strerror(gai_error));
        exit(2);
    }

    if (MMDB_SUCCESS != mmdb_error) {
        fprintf(stderr,
                "\n  Got an error from libmaxminddb: %s\n\n",
                MMDB_strerror(mmdb_error));
        exit(3);
    }

    MMDB_entry_data_list_s *entry_data_list = NULL;

    int exit_code = 0;
    if (result.found_entry) {
        int status = MMDB_get_entry_data_list(&result.entry,
                                              &entry_data_list);

        if (MMDB_SUCCESS != status) {
            fprintf(
                stderr,
                "Got an error looking up the entry data - %s\n",
                MMDB_strerror(status));
            exit_code = 4;
            goto end;
        }

        if (NULL != entry_data_list) {
            MMDB_dump_entry_data_list(stdout, entry_data_list, 2);
        }
    } else {
        fprintf(
            stderr,
            "\n  No entry for this IP address (%s) was found\n\n",
            ip_address);
        exit_code = 5;
    }

    end:
        MMDB_free_entry_data_list(entry_data_list);
        MMDB_close(&mmdb);
        exit(exit_code);
}