lwip中的getaddrinfo_ext

lwIP 中 getaddrinfo_ext 函数使用说明
函数原型
在 lwIP 库中，getaddrinfo_ext 是用于获取主机地址信息的扩展版本函数。其函数声明如下：
int getaddrinfo_ext(const char *nodename, const char *servname,
const struct addrinfo *hints, struct addrinfo **res,
void *(*mem_malloc)(size_t), void (*mem_free)(void *));

此函数允许应用程序通过提供自定义内存分配器来控制资源管理。
参数列表

const char *nodename: 主机名或 IP 地址字符串。
const char *servname: 服务名称或端口号字符串。
const struct addrinfo *hints: 提供查询条件和偏好设置的信息结构体指针。
struct addrinfo **res: 返回的结果链表头指针。
void *(*mem_malloc)(size_t): 自定义的 malloc 函数实现。
void (*mem_free)(void *): 自定义的 free 函数实现。

这些参数使得该函数更加灵活并适用于不同的应用场景[^1]。
结构体 addrinfo
为了更好地理解如何使用 getaddrinfo_ext，了解 addrinfo 结构非常重要。这个结构用来描述请求和服务之间的协议族、套接字类型以及其他属性。具体字段包括但不限于：

ai_family: 协议家族 (AF_INET 或 AF_INET6 等).
ai_socktype: 套接字类型 (SOCK_STREAM 或 SOCK_DGRAM 等).
ai_protocol: 特定传输层协议.
ai_addrlen: 地址长度.

错误处理
当调用失败时，返回值将是负数错误码；成功则返回0。常见的错误情况有EAI_AGAIN表示暂时无法解析节点名，EAI_FAIL表示永久性失败等.
示例代码
下面是一个简单的例子展示如何利用 getaddrinfo_ext 来获得指定域名对应的所有 IPv4 和 IPv6 地址:
#include "lwip/sockets.h"
#include "lwip/netdb.h"

// 定义自己的malloc/free方法作为参数传递给getaddrinfo_ext
static void* my_malloc(size_t size){
return mem_malloc(size);
}
static void my_free(void *ptr){
mem_free(ptr);
}

int main(){
struct addrinfo hints;
struct addrinfo *result;

memset(&hints, 0, sizeof(hints));
hints.ai_family = AF_UNSPEC; /* Allow both IPV4 and IPV6 */
hints.ai_socktype = SOCK_STREAM; /* TCP socket */

int status = getaddrinfo_ext("example.com", NULL, &hints, &result, my_malloc, my_free);

if(status != 0){
printf("Error calling getaddrinfo_ext: %s\n", gai_strerror(status));
return -1;
}

// Process the result...

freeaddrinfo(result); // Don't forget to release resources when done!

return 0;
}