getaddrinfo()函數詳解

gethostbyname和gethostbyaddr這兩個函數僅僅支持IPv4,getaddrinfo()函數能夠處理名字到地址以及服務到端口這兩種轉換,返回的是一個sockaddr結構的鏈表而不是一個地址清單。這些sockaddr結構隨後可由套接口函數直接使用。如此以來,getaddrinfo函數把協議相關性安全隱藏在這個庫函數內部。應用程序只要處理由getaddrinfo函數填寫的套接口地址結構。
#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 );
}
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章