LwIP Application Developers Manual5---高层协议之DNS

时间：2022-10-04 15:10:23

1.前言

lwIP提供一个基本的DNS客户端（1.3.0后引进），通过使用DNS(Domain Name System)协议来允许应用程序解决主机名到地址的转换。

在文件lwipopts.h里面定义LWIP_DNS的值为非零值可以使能DNS。

如果DHCP与lwIP DNS客户端一起工作，那么DNS将会自动被配置使用提供的DNS服务器（如果DHCP提供一个）。

2.Application DNS requests with Raw/Native API

Raw API应用可以使用dns_gethostbyname()函数来请求一次查找，并指定一个回调函数当查找结束时来通知应用程序。

你可以通过如下来阅读函数头部，该函数会马上返回。如果请求的地址已经知道，那么该函数会马上通过指针参数返回。

当一个DNS服务器的请求结束时，你的回调函数将会被调用

* err_t

* dns_gethostbyname(const char *hostname, struct ip_addr *addr, dns_found_callback found,

*                  void *callback_arg)

*

* Resolve a hostname (string) into an IP address.

* NON-BLOCKING callback version for use with raw API!!!

*

* Returns immediately with one of err_t return codes:

* - ERR_OK if hostname is a valid IP address string or the host

*   name is already in the local names table.

* - ERR_INPROGRESS enqueue a request to be sent to the DNS server

*   for resolution if no errors are present.

*

* @param hostname the hostname that is to be queried

* @param addr pointer to a struct ip_addr where to store the address if it is already

*             cached in the dns_table (only valid if ERR_OK is returned!)

* @param found a callback function to be called on success, failure or timeout (only if

*              ERR_INPROGRESS is returned!)

* @param callback_arg argument to pass to the callback function

*    callback function and argument defined as follows:

*     A function of this type must be implemented by the application using the DNS resolver.

*      @param name pointer to the name that was looked up.

*      @param ipaddr pointer to a struct ip_addr containing the IP address of the hostname,

*        or NULL if the name could not be found (or on any other error).

*      @param callback_arg a user-specified callback argument passed to dns_gethostbyname:

*

* typedef void (*dns_found_callback)(const char *name, struct ip_addr *ipaddr, void *callback_arg);

A sample call:

struct ip_addr resolved;

  switch(dns_gethostbyname("www.lwIP.com", &resolved, smtp_serverFound, NULL)){

  case ERR_OK:

    // numeric or cached, returned in resolved

    smtp.serverIP.addr = resolved->addr;

    smtp.state = SMTP_NAME_RESOLVED;

    break;

  case ERR_INPROGRESS:

    // need to ask, will return data via callback

    smtp.state = SMTP_NAME_RESOLVING;

    break;

  default:

    // bad arguments in function call

    break;

  }

A sample DNS callback function:

void smtp_serverFound(const char *name, struct ip_addr *ipaddr, void *arg)

{

  if ((ipaddr) && (ipaddr->addr))

  {

    smtp.serverIP.addr = ipaddr->addr;

    smtp.state = SMTP_NAME_RESOLVED;

    if (smtp_connect() == ERR_OK)

      return;

    smtp.lastError = SMTP_CONNECT_FAILED;

  }

  else

    smtp.lastError = SMTP_UNKNOWN_HOST;

  smtp.state = SMTP_IDLE;

}

3.Application DNS requests with Netconn API

err_t netconn_gethostbyname(const char *name, ip_addr_t *addr)

See also netconn_gethostbyname().

4.Application DNS requests with Sockets API

For socket based apps, a gethostbyname() wrapper function is provided that blocks during the lookup if necessary. Use the following functions:

  • gethostbyname() - standard implementation, blocks if necessary until lookup complete or fails
  • gethostbyname_r() - thread-safe version of gethostbyname (separate buffer for each invokation)

5.External References

DNS-related RFCs

6.Revisions

  • Local static host lookup table support (added in 1.3.1)
  • Return multiple IP addresses (future)
  • Return other RR (record) types e.g. MX, SRV... (future)
  • implement a "Dynamic DNS update" message (future)

相关文章