gethostbyname和gethostbyaddr這兩個(gè)函數(shù)僅僅支持
IPv4,getaddrinfo函數(shù)能夠處理名字到地址以及服務(wù)到端口這兩種轉(zhuǎn)換,返回的是一個(gè)sockaddr結(jié)構(gòu)的鏈表而不是一個(gè)地址清單。這些
sockaddr結(jié)構(gòu)隨后可由套接口函數(shù)直接使用。如此以來,getaddrinfo函數(shù)把協(xié)議相關(guān)性安全隱藏在這個(gè)庫(kù)函數(shù)內(nèi)部。應(yīng)用程序只要處理由
getaddrinfo函數(shù)填寫的套接口地址結(jié)構(gòu)。該函數(shù)在 POSIX規(guī)范中定義了。
#include<netdb.h>
int
getaddrinfo( const char *hostname, const char *service, const struct
addrinfo *hints, struct addrinfo **result );
返回0:? 成功
返回非0:? 出錯(cuò)
hostname:
一個(gè)主機(jī)名或者地址串(IPv4的點(diǎn)分十進(jìn)制串或者IPv6的16進(jìn)制串)
service:一個(gè)服務(wù)名或者10進(jìn)制端口號(hào)數(shù)串。
hints:
可以是一個(gè)空指針,也可以是一個(gè)指向某個(gè)addrinfo結(jié)構(gòu)的指針,調(diào)用者在這個(gè)結(jié)構(gòu)中填入關(guān)于期望返回的信息類型的暗示。舉例來說:如果指定的服務(wù)既
支持TCP也支持UDP,那么調(diào)用者可以把hints結(jié)構(gòu)中的ai_socktype成員設(shè)置成SOCK_DGRAM使得返回的僅僅是適用于數(shù)據(jù)報(bào)套接口
的信息。
本函數(shù)通過result指針參數(shù)返回一個(gè)指向addrinfo結(jié)構(gòu)鏈表的指針,而addrinfo結(jié)構(gòu)定義在頭文件
netdb.h中:
struct addrinfo{
??? int ?? ?? ai_flags;??
??? int
?? ?? ai_family;
??? int ?? ?? ai_socktype;
??? int ?? ??
ai_protocol;
??? socklen_t ai_addrlen;
??? char ?? *ai_canonname;
???
struct sockaddr *ai_addr;
??? struct addrinfo *ai_next;
};
如
果本函數(shù)返回成功,那么由result參數(shù)指向的變量已被填入一個(gè)指針,它指向的是由其中的ai_next成員串聯(lián)起來的addrinfo結(jié)構(gòu)鏈表??梢?
導(dǎo)致返回多個(gè)addrinfo結(jié)構(gòu)的情形有以下2個(gè):
??? 1.???
如果與hostname參數(shù)關(guān)聯(lián)的地址有多個(gè),那么適用于所請(qǐng)求地址簇的每個(gè)地址都返回一個(gè)對(duì)應(yīng)的結(jié)構(gòu)。
??? 2.???
如果service參數(shù)指定的服務(wù)支持多個(gè)套接口類型,那么每個(gè)套接口類型都可能返回一個(gè)對(duì)應(yīng)的結(jié)構(gòu),具體取決于hints結(jié)構(gòu)的ai_socktype
成員。
我們必須先分配一個(gè)hints結(jié)構(gòu),把它清零后填寫需要的字段,再調(diào)用getaddrinfo然后遍歷一個(gè)鏈表逐個(gè)嘗試每個(gè)返回地
址。
getaddrinfo解決了把主機(jī)名和服務(wù)名轉(zhuǎn)換成套接口地址結(jié)構(gòu)的問題。
其中,如果getaddrinfo出
錯(cuò),那么返回一個(gè)非0的錯(cuò)誤值。
#include<netdb.h>
const char
*gai_strerror( int error );
該函數(shù)以getaddrinfo返回的非0錯(cuò)誤值的名字和含義為他的唯一參數(shù),返回一個(gè)
指向?qū)?yīng)的出錯(cuò)信息串的指針。
由getaddrinfo返回的所有存儲(chǔ)空間都是動(dòng)態(tài)獲取的,這些存儲(chǔ)空間必須通過調(diào)用
freeaddrinfo返回給系統(tǒng)。
#include< netdb.h >
void freeaddrinfo(
struct addrinfo *ai );
ai參數(shù)應(yīng)指向由getaddrinfo返回的第一個(gè)addrinfo結(jié)構(gòu)。這個(gè)連表中的
所有結(jié)構(gòu)以及它們指向的任何動(dòng)態(tài)存儲(chǔ)空間都被釋放掉。
例子:
struct addrinfo *host_serv(
const char *host, const char *serv, int family, int socktype )
{
???
int n;
??? struct?? addrinfo? hints,? *res;
??? bzero(
&hints, sizeof(struct addrinfo) );
??? hints.ai_flags =
AI_CANONNAME;
??? hints.ai_family = family;
??? hints.ai_socktype =
socktype;
??? if( (n = getaddrinfo( host, serv, &hints,
&res ) ) != 0 )
??? ?? return (NULL);
??? return ( res );
}