2 onps栈使用说明——ping、域名解析等网络工具测试( 二 ) _生活百科

参数

nPing：ping_start()函数返回的ping测试句柄
unDstAddr：目标地址
usSeqNum：报文序号，用于唯一的标识发出的探测报文
ubTTL：ttl值，探测报文到达目标地址之前的生存时间
pfunGetCurMSecs：函数指针，这个函数返回系统定时器自启动以来的工作时长，单位：毫秒，其精度取决于os定时器粒度，其用于统计
ping的响应时间，必须提供这个函数，否则ping操作将无法完成
pfunRcvHandler：函数指针，收到响应报文后将调用这个函数完成用户指定的操作，ping_recv_handler()就是它的实际实现
ubWaitSecs：响应报文的最长等待时间，单位：秒
penErr：如果ping失败，该参数保存具体的错误码

返回值
大于0，ping成功；0，等待响应报文超时；小于0，失败，具体的错误信息参看pennErr保存的错误码。
2. dns测试这个测试需要为网卡设定好能够访问互联网的网关、DNS服务器地址等配置信息。当然如果采用dhcp动态地址申请的方式能够得到这些信息那就更省事了。dns查询工具的头文件为"net_tools/dns.h" 。
【2 onps栈使用说明——ping、域名解析等网络工具测试】

……#include "onps.h"#include "net_tools/ping.h"int main(void){if(open_npstack_load(&enErr)){printf("The open source network protocol stack (ver %s) is loaded successfully. \r\n", ONPS_VER);//* 协议栈加载成功，在这里初始化ethernet网卡或等待ppp链路就绪#if 0emac_init(); //* ethernet网卡初始化函数，并注册网卡到协议栈#elsewhile(!netif_is_ready("ppp0")) //* 等待ppp链路建立成功os_sleep_secs(1);#endif}else{printf("The open source network protocol stack failed to load, %s\r\n", onps_error(enErr));return -1;}//* dns查询测试in_addr_t unPrimaryDNS, unSecondaryDNS;INT nDnsClient = dns_client_start(&unPrimaryDNS, &unSecondaryDNS, 3, &enErr);if(nDnsClient < 0){//* dns客户端启动失败，输出一条错误日志printf("%s\r\n", onps_error(enErr));}else{//* 发送查询请求并等待dns服务器的应答in_addr_t unIp = dns_client_query(nDnsClient, unPrimaryDNS, unSecondaryDNS, "gitee.com", &enErr);if(unIp) //* 查询成功{CHAR szAddr[20];printf("The ip addr: %s\r\n", inet_ntoa_safe_ext(unIp, szAddr));}elseprintf("%s\r\n", onps_error(enErr)); //* 查询失败//* 结束dns查询，释放占用的协议栈资源dns_client_end(nDnsClient);}return 0;}

与ping测试工具相同，dns查询工具同样提供了一组简单的api函数用于实现域名查询。这一组函数包括dns_client_start()、dns_client_end()以及dns_client_query()，其使用说明如下：
函数原型
INT dns_client_start(in_addr_t *punPrimaryDNS, in_addr_t *punSecondaryDNS, CHAR bRcvTimeout, EN_ONPSERR *penErr);
功能
启动一个域名查询客户端。
参数

punPrimaryDNS：指针类型，用于接收主域名服务器地址。协议栈会选择缺省路由绑定的网卡，并得到网卡携带的dns服务器地址用于接下来的域名查询，该参数即用于保存主dns服务器的地址
punSecondaryDNS：指针类型，与上同，用于接收次域名服务器地址
bRcvTimeout：查询超时时间，单位：秒
penErr：如果启动失败，该参数用于接收具体的错误码

返回值
成功，返回当前启动的dns客户端的句柄；失败，返回值小于0，具体错误信息参看pennErr保存的错误码。
-
函数原型
void dns_client_end(INT nClient);
功能
结束dns客户端，释放占用的协议栈资源。
参数

nClient：dns_client_start()函数返回的dns客户端句柄

返回值
无
-
函数原型
in_addr_t dns_client_query(INT nClient, in_addr_t unPrimaryDNS, in_addr_t unSecondaryDNS, const CHAR *pszDomainName, EN_ONPSERR *penErr);