C / C++ / 系统课时
解析主机名与服务地址
解析主机名与服务地址
网络程序如果把 IPv4、IPv6 和端口结构写死在代码里,很快会遇到兼容性问题。本节使用 getaddrinfo() 把主机名和服务统一解析为可直接交给 Socket API 的地址列表,再用 getnameinfo() 把二进制地址安全地转换回文本形式。
学习目标
- 使用
getaddrinfo()同时处理 IPv4 与 IPv6 地址解析。 - 根据
addrinfo链表读取候选地址,而不手工拼装地址结构。 - 使用
getnameinfo()输出数值型主机地址与服务端口,并正确释放解析结果。
从主机名得到候选地址
getaddrinfo(node, service, hints, &result) 接收主机名与服务,返回一条 addrinfo 链表。每个节点都描述一个候选地址,其中 ai_family 表示 IPv4 或 IPv6,ai_socktype 表示流式或数据报 Socket,ai_addr 指向已经填好的 sockaddr 地址对象。
把 hints.ai_family 设为 AF_UNSPEC,可以让解析器同时接受 IPv4 和 IPv6;把 hints.ai_socktype 设为 SOCK_STREAM,则只保留适合 TCP 的结果。这样业务代码无需判断并手工构造 sockaddr_in 或 sockaddr_in6。

主示例:同时打印 IPv4 和 IPv6 结果
下面程序接收两个参数:主机名和服务。它使用 AF_UNSPEC 查询所有可用地址,再用 getnameinfo() 以数值形式打印地址与端口。使用数值输出可以避免反向 DNS 或服务名查询带来的额外不确定性。
#include <netdb.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/socket.h>
static const char *family_name(int family) {
if (family == AF_INET) {
return "AF_INET";
}
if (family == AF_INET6) {
return "AF_INET6";
}
return "OTHER";
}
int main(int argc, char **argv) {
if (argc != 3) {
fprintf(stderr, "usage: %s <host> <service>\n", argv[0]);
return 2;
}
struct addrinfo hints;
memset(&hints, 0, sizeof(hints));
hints.ai_family = AF_UNSPEC;
hints.ai_socktype = SOCK_STREAM;
struct addrinfo *result = NULL;
int rc = getaddrinfo(argv[1], argv[2], &hints, &result);
if (rc != 0) {
fprintf(stderr, "getaddrinfo: %s\n", gai_strerror(rc));
return 1;
}
for (const struct addrinfo *ai = result; ai != NULL; ai = ai->ai_next) {
char host[NI_MAXHOST];
char service[NI_MAXSERV];
rc = getnameinfo(ai->ai_addr, ai->ai_addrlen,
host, sizeof(host),
service, sizeof(service),
NI_NUMERICHOST | NI_NUMERICSERV);
if (rc != 0) {
fprintf(stderr, "getnameinfo: %s\n", gai_strerror(rc));
continue;
}
printf("family=%s address=%s service=%s\n",
family_name(ai->ai_family), host, service);
}
freeaddrinfo(result);
return 0;
}编译并解析本机名称:
gcc -Wall -Wextra -O2 resolve.c -o resolve
./resolve localhost 8080预期输出形态如下;实际条目数量、顺序以及 <IP> 会受 /etc/hosts、NSS 与系统 IPv4/IPv6 配置影响:
family=<VALUE> address=<IP> service=8080
family=<VALUE> address=<IP> service=8080常见系统会出现 AF_INET、AF_INET6 中的一种或两种。程序不依赖具体顺序,因此调用 connect() 时通常应遍历候选节点,逐个尝试,直到成功或列表耗尽。
错误处理与资源释放
getaddrinfo() 和 getnameinfo() 的错误码不是 errno 体系,应该传给 gai_strerror() 生成说明文本。只有当 getaddrinfo() 返回 0 时,result 才是可遍历结果;使用结束后必须调用 freeaddrinfo(result) 释放整条链表。
解析主机名时还要区分“解析成功”和“连接成功”。getaddrinfo() 只负责得到候选地址,并不会测试目标端口是否可达;真正建立连接仍需对每个 ai_addr 调用 socket() 与 connect()。
什么时候不要硬编码地址结构
如果程序只接受固定的 sockaddr_in,就会把 IPv4 假设扩散到参数解析、连接逻辑和日志输出中。使用 getaddrinfo() 后,调用方只处理通用的 sockaddr 指针和长度,IPv4/IPv6 差异被封装在结果节点里。
当输入已经是数值 IP 时,仍然可以使用 getaddrinfo();需要禁止 DNS 查询时,可在 hints.ai_flags 中加入 AI_NUMERICHOST。反过来,getnameinfo() 若指定 NI_NUMERICHOST | NI_NUMERICSERV,则只做二进制到数值文本的转换,不发起名称解析,更适合日志和诊断路径。