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。

getaddrinfo 与 getnameinfo 地址解析流程

主示例:同时打印 IPv4 和 IPv6 结果

下面程序接收两个参数:主机名和服务。它使用 AF_UNSPEC 查询所有可用地址,再用 getnameinfo() 以数值形式打印地址与端口。使用数值输出可以避免反向 DNS 或服务名查询带来的额外不确定性。

c
#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;
}

编译并解析本机名称:

bash
gcc -Wall -Wextra -O2 resolve.c -o resolve
./resolve localhost 8080

预期输出形态如下;实际条目数量、顺序以及 <IP> 会受 /etc/hosts、NSS 与系统 IPv4/IPv6 配置影响:

text
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,则只做二进制到数值文本的转换,不发起名称解析,更适合日志和诊断路径。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

解析主机名与服务地址

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通