TCP/IP编程中协议无关性的函数getaddrinfo()(2)

二、getaddrinfo函数详解:

1.getaddrinfo函数原型

函数

 

参数说明

 

int getaddrinfo(

const char* nodename

const char* servname,

const struct addrinfo* hints,//

struct addrinfo** res

);

 

nodename:节点名可以是主机名,也可以是数字地址。(IPV4的10进点分,或是IPV6的16进制)

servname:包含十进制数的端口号或服务名如(ftp,http)

hints:是一个空指针或指向一个addrinfo结构的指针,由调用者填写关于它所想返回的信息类型的线索。

res:存放返回addrinfo结构链表的指针

 

Getaddrinfo提供独立于协议的名称解析。

函数的前两个参数分别是节点名和服务名。节点名可以是主机名,也可以是地址串(IPv4的点分十进制数表示或IPv6的十六进制数字串)。服务名可以是十进制的端口号,也可以是已定义的服务名称,如ftp、http等。注意:其中节点名和服务名都是可选项,即节点名或服务名可以为NULL,此时调用的结果将取缺省设置,后面将详细讨论。

函数的第三个参数hints是addrinfo结构的指针,由调用者填写关于它所想返回的信息类型的线索。函数的返回值是一个指向addrinfo结构的链表指针res。

2.addrinfo结构

结构

 

固定的参数

 

typedef struct addrinfo {  

int ai_flags;  

int ai_family;  

int ai_socktype;  

int ai_protocol;  

size_t ai_addrlen;  

char* ai_canonname;  

struct sockaddr* ai_addr;  

struct addrinfo* ai_next;

}

 

ai_addrlen must be zero or a null pointer

ai_canonname must be zero or a null pointer

ai_addr must be zero or a null pointer

ai_next must be zero or a null pointer

 

可以改动的参数

 

ai_flags:AI_PASSIVE,AI_CANONNAME,AI_NUMERICHOST

ai_family: AF_INET,AF_INET6

ai_socktype:SOCK_STREAM,SOCK_DGRAM

ai_protocol:IPPROTO_IP, IPPROTO_IPV4, IPPROTO_IPV6 etc.

 
参数说明

在getaddrinfo函数之前通常需要对以下6个参数进行以下设置:nodename、servname、hints的ai_flags、ai_family、ai_socktype、ai_protocol

在6项参数中,对函数影响最大的是nodename,sername和hints.ai_flag

而ai_family只是有地址为v4地址或v6地址的区别。而ai_protocol一般是为0不作改动。

其中ai_flags、ai_family、ai_socktype说明如下:

参数

 

取值

 

 

说明

 

ai_family

 

AF_INET

 

2

 

IPv4

 

AF_INET6

 

23

 

IPv6

 

AF_UNSPEC

 

0

 

协议无关

 

ai_protocol

 

IPPROTO_IP

 

0

 

IP协议

 

IPPROTO_IPV4

 

4

 

IPv4

 

IPPROTO_IPV6

 

41

 

IPv6

 

IPPROTO_UDP

 

17

 

UDP

 

IPPROTO_TCP

 

6

 

TCP

 

ai_socktype

 

SOCK_STREAM

 

1

 

 

SOCK_DGRAM

 

2

 

数据报

 

ai_flags

 

AI_PASSIVE

 

1

 

被动的,用于bind,通常用于server socket

 

AI_CANONNAME

 

2

   

AI_NUMERICHOST

 

4

 

地址为数字串

 

对于ai_flags值的说明:

AI_NUMERICHOST

 

AI_CANONNAME

 

AI_PASSIVE

 

0/1

 

0/1

 

0/1

 

如上表所示,ai_flagsde值范围为0~7,取决于程序如何设置3个标志位,比如设置ai_flags为 “AI_PASSIVE|AI_CANONNAME”,ai_flags值就为3。三个参数的含义分别为:

(1)AI_PASSIVE当此标志置位时,表示调用者将在bind()函数调用中使用返回的地址结构。当此标志不置位时,表示将在connect()函数调用中使用。

当节点名位NULL,且此标志置位,则返回的地址将是通配地址。

如果节点名NULL,且此标志不置位,则返回的地址将是回环地址。

(2)AI_CANNONAME当此标志置位时,在函数所返回的第一个addrinfo结构中的ai_cannoname成员中,应该包含一个以空字符结尾的字符串,字符串的内容是节点名的正规名。

(3)AI_NUMERICHOST当此标志置位时,此标志表示调用中的节点名必须是一个数字地址字符串。

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:http://www.heiqu.com/18dca2f775c71ea9084bac870e861d90.html