uIP hostname resolver functions
[The uIP TCP/IP stack]

The uIP DNS resolver functions are used to lookup a hostname and map it to a numerical IP address. More...

Files

file  resolv.c
 

DNS host name to IP address resolver.


Functions

void resolv_query (const char *name)
 Queues a name so that a question for the name will be sent out.
uip_ipaddr_tresolv_lookup (const char *name)
 Look up a hostname in the array of known hostnames.
uip_ipaddr_tresolv_getserver (void)
 Obtain the currently configured DNS server.
void resolv_conf (const uip_ipaddr_t *dnsserver)
 Configure a DNS server.

Variables

process_event_t resolv_event_found
 Event that is broadcasted when a DNS name has been resolved.

Detailed Description

The uIP DNS resolver functions are used to lookup a hostname and map it to a numerical IP address.

It maintains a list of resolved hostnames that can be queried with the resolv_lookup() function. New hostnames can be resolved using the resolv_query() function.

The event resolv_event_found is posted when a hostname has been resolved. It is up to the receiving process to determine if the correct hostname has been found by calling the resolv_lookup() function with the hostname.


Function Documentation

void resolv_conf ( const uip_ipaddr_t dnsserver  ) 

Configure a DNS server.

Parameters:
dnsserver A pointer to a 4-byte representation of the IP address of the DNS server to be configured.

Definition at line 509 of file resolv.c.

References process_post(), and uip_ipaddr_copy.

Referenced by main().

uip_ipaddr_t* resolv_getserver ( void   ) 

Obtain the currently configured DNS server.

Returns:
A pointer to a 4-byte representation of the IP address of the currently configured DNS server or NULL if no DNS server has been configured.

Definition at line 493 of file resolv.c.

References uip_udp_conn::ripaddr.

uip_ipaddr_t* resolv_lookup ( const char *  name  ) 

Look up a hostname in the array of known hostnames.

Note:
This function only looks in the internal array of known hostnames, it does not send out a query for the hostname if none was found. The function resolv_query() can be used to send a query for a hostname.
Returns:
A pointer to a 4-byte representation of the hostname's IP address, or NULL if the hostname was not found in the array of hostnames.

Definition at line 467 of file resolv.c.

void resolv_query ( const char *  name  ) 

Queues a name so that a question for the name will be sent out.

Parameters:
name The hostname that is to be queried.

Definition at line 418 of file resolv.c.

References tcpip_poll_udp().


Generated on Mon Apr 11 14:23:51 2011 for Contiki 2.5 by  doxygen 1.6.1