函数getaddrinfo在库函数中隐藏了所有协议依赖性。应用 程序只需要处理由getaddrinfo填写的套接口地址结构。其函数原型为:
#include <netdb.h> int getaddrinfo(const char *hostname, const char *service, const struct addrinfo *hints, struct addrinfo **result);
这个函数通过result指针返回一个指向addrinfo结构链表的指针,该结构在<netdb.h>中定义:
struct addrinfo { int ai_flags;// AI_PASSIVE,AI_CANONNAME int ai_family;//AF_XXX int ai_socktype;//SOCK_XXX int ai_protocol;//0 or IPPROTO_xxx for IPv4 and IPv6 size_t ai_addrlen;//length of ai_addr char *ai_canonname;// ptr to canonical name for host struct sockaddr *ai_addr; //ptr to socket address structure struct addrinfo *ai_next;// ptr to next structure in linked list };
ai_flags(AI_PASSIVE或AI_CANONNAME)
ai_family
ai_socktype
ai_protocol
AI_PASSIVE标志表示该套接口是被动的打开 ,AI_CANNONAME标志则通知getaddrinfo函数返回主机的名字。如果hints是一个空指针,该函数将假定ai_flags,ai_socktype,ai_protocol的值为零,ai_family的值为AF_UNSPEC
如果函数返回成功(0),result 参数指向的变量将被填入一个指针,它指向一个通过ai_next指针串起来的addrinfo结构链表。
返回这个复合结构有两种方式。
1、如果与该hostname对应的有多个地址,将按请求的地址族(如果指定了ai_family线索)为每个地址返回一个结构
2、如果该服务在多种套接口类型上提供,将根据ai_socktype线索为每个套接口类型返回一个结构
在addrinfo结构中返回的信息可用于调用 socket,然后 调用 connect、sendto(客户)或bind(服务器)。socket函数的参数是addrinfo结构中的ai_family、ai_socktype和ai_addr。connect或bind函数的第二个参数和第三个参数是ai_addr(一个指向适当类型的套接口地址结构的指针,由getaddrinfo)填写和ai_addrlen(套接口地址结构的大小 )。
如果设置 了在hints结构中的AI_CANNONAME标志,返回的第一个结构的ai_canonname成员指向相应主机的名字。
如果枚举getaddrinfo的64种可能的输入(有六个输入变量),许多都 是无效的,有些没什么 意义。因则我们将注意力集中到一些常见情况
1、指定hostname和service.这在TCP或UDP客户程序中很常见。TCP客户程序遍历所有返回的IP地址,逐一调用 socket和connect,直到连接成功或所有地址被试过为止。
在UDP客户程序中,由getaddrinfo填写的套接口地址结构被用来调用 sendto或connect,如果第一个地址不行,就会尝试剩下的地址。
如果客户程序知道它只处理一种类型的口(例如,Telnet和FTP客户程序只处理TCP,TFTP客户程序只处理UDP),就应把hints结构中的ai_socket设为SOCK_STREAM或SOCK_DGRAM
2、典型的服务器程序只用指定service以及hints结构中的AI_PASSIVE标志,而不需要指明hostname.返回的套接口地址结构中应包含一个INADD_ANY或IN6ADDR_ANY_INIT的IP地址。TCP服务器程序随后调用 socket、bind和listen。如果服务器程序要malloc另一个套接口地址结构以从accept取得客户的地址,返回的ai_addrlen的值将给出所需的内存大小 。
UDP的服务器程序将调用 socket、bind和recvfrom。如果服务器要malloc另一个套接口地址结构以从recvfrom取得客户的地址。返回的ai_addrlen的值将给出所需的内存大小 。
和典型的客户程序代码一样,如果服务器程序知道它只处理一种类型的套接口,hints结构中ai_socket应被设为SOCK_STREAM或SOCK_DGRAM。