gethostbyname和gethostbyaddr這兩個函數僅僅支持
IPv4,getaddrinfo函數能夠處理名字到地址以及服務到端口這兩種轉換,返回的是一個sockaddr結構的鏈表而不是一個地址清單。這些
sockaddr結構隨后可由套接口函數直接使用。如此以來,getaddrinfo函數把協議相關性安全隱藏在這個庫函數內部。應用程序只要處理由
getaddrinfo函數填寫的套接口地址結構。該函數在 POSIX規范中定義了。
#include<netdb.h>
int
getaddrinfo( const char *hostname, const char *service, const struct
addrinfo *hints, struct addrinfo **result );
返回0:? 成功
返回非0:? 出錯
hostname:
一個主機名或者地址串(IPv4的點分十進制串或者IPv6的16進制串)
service:一個服務名或者10進制端口號數串。
hints:
可以是一個空指針,也可以是一個指向某個addrinfo結構的指針,調用者在這個結構中填入關于期望返回的信息類型的暗示。舉例來說:如果指定的服務既
支持TCP也支持UDP,那么調用者可以把hints結構中的ai_socktype成員設置成SOCK_DGRAM使得返回的僅僅是適用于數據報套接口
的信息。
本函數通過result指針參數返回一個指向addrinfo結構鏈表的指針,而addrinfo結構定義在頭文件
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;
};
如
果本函數返回成功,那么由result參數指向的變量已被填入一個指針,它指向的是由其中的ai_next成員串聯起來的addrinfo結構鏈表。可以
導致返回多個addrinfo結構的情形有以下2個:
??? 1.???
如果與hostname參數關聯的地址有多個,那么適用于所請求地址簇的每個地址都返回一個對應的結構。
??? 2.???
如果service參數指定的服務支持多個套接口類型,那么每個套接口類型都可能返回一個對應的結構,具體取決于hints結構的ai_socktype
成員。
我們必須先分配一個hints結構,把它清零后填寫需要的字段,再調用getaddrinfo然后遍歷一個鏈表逐個嘗試每個返回地
址。
getaddrinfo解決了把主機名和服務名轉換成套接口地址結構的問題。
其中,如果getaddrinfo出
錯,那么返回一個非0的錯誤值。
#include<netdb.h>
const char
*gai_strerror( int error );
該函數以getaddrinfo返回的非0錯誤值的名字和含義為他的唯一參數,返回一個
指向對應的出錯信息串的指針。
由getaddrinfo返回的所有存儲空間都是動態獲取的,這些存儲空間必須通過調用
freeaddrinfo返回給系統。
#include< netdb.h >
void freeaddrinfo(
struct addrinfo *ai );
ai參數應指向由getaddrinfo返回的第一個addrinfo結構。這個連表中的
所有結構以及它們指向的任何動態存儲空間都被釋放掉。
例子:
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 );
}