get_host_by_name

#include <rtl.h>

U8 get_host_by_name (
    U8* hostn,                                /* Pointer to the hostname. */
    void (*cbfunc)(U8 event, U8* host_ip) );  /* Function to call when    */
                                              /* the DNS request ends.    */

The get_host_by_name function resolves the IP address of a host from a hostname. The argument hostn is a pointer to a NULL terminated string that specifies the hostname. The function get_host_by_name starts the DNS client on TCPnet, to send a request to the DNS server.

The argument cbfunc specifies a user provided callback function that the DNS client calls when an event ends the DNS session. The DNS client specifies the event and the host IP address (in case of DNS_EVT_SUCCESS) when calling the cbfunc function.

The get_host_by_name function is in the RL-TCPnet library. The prototype is defined in rtl.h.

note

• The hostname argument hostn can also point to the dotted decimal IP address in sting format (for example "192.168.0.100"). In this case, the DNS client calls the cbfunc function immediately with the IP address.

The get_host_by_name function returns a code that specifies either the state of the dns resolving process or an error. If the return code is an error, then the current DNS request is ignored:

static void dns_cbfunc (U8 event, U8 *ip);

void resolve_host (void) {
  U8 res;

  res = get_host_by_name ("www.keil.com",dns_cbfunc);
  switch (res) {
    case DNS_RES_OK:
      break;
    case DNS_ERROR_BUSY:
      printf("DNS Resolver is still busy. Request ignored.\n");
      break;
    case DNS_ERROR_LABEL:
      printf("Host name label too long or contains invalid characters.\n");
      break;
    case DND_ERROR_NAME:
      printf("Host name too long or domain missing.\n");
      break;
    case DNS_ERROR_NOSRV:
      printf("DNS Server IP address not specified.\n");
      break;
    case DNS_ERROR_PARAM:
      printf("Parameters are invalid.\n");
      break;
  }
}