getaddrinfo()函式詳解

2021-06-07 19:55:00 字數 1583 閱讀 4366

gethostbyname和gethostbyaddr這兩個函式僅僅支援ipv4,getaddrinfo()函式能夠處理名字到位址以及服務到埠這兩種轉換,返回的是乙個sockaddr結構的鍊錶而不是乙個位址清單。這些sockaddr結構隨後可由套介面函式直接使用。如此以來,getaddrinfo函式把協議相關性安全隱藏在這個庫函式內部。應用程式只要處理由getaddrinfo函式填寫的套介面位址結構。

#include

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;

如果本函式返回成功,那麼由result引數指向的變數已被填入乙個指標,它指向的是由其中的ai_next成員串聯起來的addrinfo結構鍊錶。可以導致返回多個addrinfo結構的情形有以下2個:

1.    如果與hostname引數關聯的位址有多個,那麼適用於所請求位址簇的每個位址都返回乙個對應的結構。

2.    如果service引數指定的服務支援多個套介面型別,那麼每個套介面型別都可能返回乙個對應的結構,具體取決於hints結構的ai_socktype成員。

我們必須先分配乙個hints結構,把它清零後填寫需要的字段,再呼叫getaddrinfo然後遍歷乙個鍊錶逐個嘗試每個返回位址。

getaddrinfo解決了把主機名和服務名轉換成套介面位址結構的問題。

其中,如果getaddrinfo出錯,那麼返回乙個非0的錯誤值。

#include

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 )

getaddrinfo 函式詳解

1.概述 ipv4中使用gethostbyname 函式 完成主機名到位址解析,這個函式僅僅支援ipv4,且不允許呼叫者指定所需位址型別的任何資訊,返回的結構只包含了用於儲存ipv4位址的空間。ipv6中引入了getaddrinfo 的新api,它是協議無關的,既可用於ipv4也可用於ipv6。ge...

getaddrinfo 函式詳解

getaddrinfo 函式詳解 1.概述 ipv4中使用 gethostbyname 函式 完成主機名到位址解析,這個函式僅僅支援ipv4,且不允許呼叫者指定所需位址型別的任何資訊,返回的結構只包含了用於儲存ipv4位址的空間。ipv6中引入了getaddrinfo 的新api,它是協議無關的,既...

getaddrinfo 函式詳解

getaddrinfo 函式詳解 1.概述 ipv4中使用 gethostbyname 函式完成主機名到位址解析,這個函式僅僅支援ipv4,且不允許呼叫者指定所需位址型別的任何資訊,返回的結構只包含了用於儲存ipv4位址的空間。ipv6中引入了getaddrinfo 的新api,它是協議無關的,既可...