参考的文章:
https://www.cnblogs.com/LubinLew/p/POSIX-DataStructure.html#struct_addrinfo
https://baike.baidu.com/item/getaddrinfo/9021771?fr=aladdin
在做的一个项目,用到getaddrinfo函数,从linux 移植到windows上,做一小结。
getaddrinfo函数能够处理名字到地址以及服务到端口这两种转换,返回的是一个sockaddr结构的链表而不是一个地址清单。这些sockaddr结构随后可由套接口函数直接使用。如此一来,getaddrinfo函数把协议相关性安全隐藏在这个库函数内部。应用程序只要处理由getaddrinfo函数填写的套接口地址结构。该函数在 POSIX规范中定义了。
IPv6中引入了新的API getaddrinfo(),它是协议无关的,既可用于IPv4也可用于IPv6。
包含头文件
Linux下为#include<netdb.h>
windows下为#include <ws2tcpip.h>
int getaddrinfo( const char *hostname, const char *service, const struct addrinfo *hints, struct addrinfo **result );
参数说明
hostname:一个主机名或者地址串(IPv4的点分十进制串或者IPv6的16进制串) //本项目使用的是地址串
例如:主机名(“www.baidu.com”)或者是数字化的地址字符串(IPv4的点分十进制串(“192.168.1.100”)或者IPv6的16进制串(“2000::1:2345:6789:abcd”)),
如果 ai_flags 中设置了AI_NUMERICHOST 标志,那么该参数只能是数字化的地址字符串,不能是域名,该标志的作用就是阻止进行域名解析。
service:服务名可以是十进制的端口号,也可以是已定义的服务名称,如ftp、http等 //本项目使用的是端口号
例如:服务名可以是十进制的端口号(“8080”)字符串,也可以是已定义的服务名称,如”ftp”、”http”等,详细请查看/etc/services 文件,最后翻译成对应服务的端口号。如果此参数设置为NULL,那么返回的socket地址中的端口号不会被设置。
hints:可以是一个空指针,也可以是一个指向某个addrinfo结构体的指针,调用者在这个结构中填入关于期望返回的信息类型的暗示。举例来说:指定的服务既可支持TCP也可支持UDP,所以调用者可以把hints结构中的ai_socktype成员设置成SOCK_DGRAM使得返回的仅仅是适用于数据报套接口的信息。
具体介绍一下hints结构体的参数设置
hint.ai_flags = AI_NUMERICSERV;
1)如果 ai_flags 设置了AI_NUMERICSERV 标志并且service未设置为NULL,那么该参数必须是一个指向10进制的端口号字符串,不能设定成服务名,该标志就是用来阻止服务名解析。
2)如果设置了 AI_PASSIVE 标志,并且 nodename 是 NULL, 那么返回的socket地址可以用于的bind()函数,返回的地址是通配符地址(wildcard address, IPv4时是INADDR_ANY,IPv6时是IN6ADDR_ANY_INIT),这样应用程序(典型是server)就可以使用这个通配符地址用来接收任何请求主机地址的连接;
3)如果 nodename 不是NULL,那么 AI_PASSIVE 标志被忽略;如果未设置AI_PASSIVE标志,返回的socket地址可以用于connect(), sendto(), 或者 sendmsg()函数。
4)如果 nodename 是NULL,那么网络地址会被设置为lookback接口地址(IPv4时是INADDR_LOOPBACK,IPv6时是IN6ADDR_LOOPBACK_INIT)。
hint.ai_family = AF_UNSPEC; /* hint 的限定设置 */
当 ai_family 指定为AF_INT6(IPv6)时,如果没有找到IPv6地址,那么会返回IPv4-mapped IPv6 地址,
也就是说如果没有找到AAAA record(用来将域名解析到IPv6地址的DNS记录),那么就查询A record(IPv4),
将找到的IPv4地址映射到IPv6地址, IPv4-mapped IPv6 地址其实是IPv6内嵌IPv4的一种方式,
地址的形式为”0::FFFF:a.b.c.d”,例如”::ffff:192.168.89.9″(混合格式)这个地址仍然是一个IPv6地址, 只是”0000:0000:0000:0000:0000:ffff:c0a8:5909″(16机制格式)的另外一种写法罢了。
当 ai_family 不是AF_INT6(IPv6)时,该标志被忽略。查询IPv4和IPv6地址
只有当主机配置了IPv4地址才进行查询IPv4地址;只有当主机配置了IPv6地址才进行查询IPv6地址.
ai_flags值的说明
如上表所示,ai_flags的值的范围为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当此标志置位时,此标志表示调用中的节点名必须是一个数字地址字符串。
result:本函数通过result指针参数返回一个指向addrinfo结构体链表的指针。
所以根据需要返回的addrinfo restult (使用目的),选择合适的参数组合。
如果 getaddrinfo() 函数执行成功,返回值为 0 , 其他情况返回值表示错误种别。使用函数gai_strerror() 可以获取可读性的错误信息,用法用strerror()相同,
错误种别如下:
指定的主机上没有请求的address family对应的网络地址.
DNS(name server)返回临时性错误. 可以稍后重试.
hints.ai_flags 包含了无效的标志; 或者 hints.ai_flags 包含了 AI_CANONNAME 标志但是 name 是 NULL.
DNS(name server)返回永久性错误
不支持的 address family(hints.ai_family).
内存耗尽.
指定的网络主机存在,但是其未定义任何网络地址.
nodename 或者 servname 未知;或者两者都设置为NULL;
或者设置了 AI_NUMERICSERV 标志但是 servname 不是一个数字化的端口名字符串。
请求的socket类型不支持请求的服务类型.例如服务类型是 “shell” (基于流的socket服务),
但是 hints.ai_protocol 是 IPPROTO_UDP 或者hints.ai_socktype 是 SOCK_DGRAM;
或者 servname 不是NULL 但是 hints.ai_socktype 是 SOCK_RAW (原始套接字不支持服务的概念).
不支持请求的socket类型. 例如, hints.ai_socktype 和 hints.ai_protocol 冲突 (例如分别是SOCK_DGRAM、IPPROTO_TCP).
系统调用错误,检查 errno.
使用说明
在getaddrinfo函数之前通常需要对以下6个参数进行以下设置:nodename、servname、hints的ai_flags、ai_family、ai_socktype、ai_protocol。
在6项参数中,对函数影响最大的是nodename,sername和 h i n t s . ai_flag,而ai_family只是有地址为v4地址或v6地址的区别。ai_protocol一般是为0不作改动。
实际常用设置
一般情况下,client/server编程中,server端调用bind(如果面向连接的还需要listen),client则不用调用bind函数,解析地址后直接connect(面向连接)或直接发送数据(无连接)。因此,比较常见的情况有
(1) 通常服务器端在调用getaddrinfo之前,ai_flags设置AI_PASSIVE,用于bind;主机名nodename通常会设置为NULL,返回通配地址[::]。
(2) 客户端调用getaddrinfo时,ai_flags一般不设置AI_PASSIVE,但是主机名nodename和服务名servname(更愿意称之为端口)则应该不为空。
(3) 当然,即使不设置AI_PASSIVE,取出的地址也并非不可以被bind,很多程序中ai_flags直接设置为0,即3个标志位都不设置,这种情况下只要hostname和servname设置的没有问题就可以正确bind。
在项目中,应该是第二种方式使用,hostname = IP地址,目的是获取一个符合要求的addrinfo 结构体,以便socket的connect。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
如需转载请保留出处:http://bianchenghao.cn/10727.html