Programming Guide

The following sections provide sample code describing how to use µC/DNSc.

API reference

Wherever you want to use µC/DNSc, you should include the following header:

Include file	Description
Source/dns-c.h	Contains DNSc API definitions

Function name	Description
DNSc_Init()	Initialize µC/DNSc module's objects and tasks. This function must be called prior to any other API

Function name	Description
DNSc_GetHost()	Resolve or retrieve a host name from the cache

Function name	Description
DNSc_CacheClrAll()	Clear (flush) all entries in the DNS cache.
DNSc_CacheClrHost()	Remove a specific host name from the DNS cache.

Function name	Description
DNSc_CfgServerByStr()	Configure default server using a string.
DNSc_CfgServerByAddr()	Configure default server using an DNS address object.
DNSc_GetServerByStr()	Get the default server configured in string format.
DNSc_GetServerByAddr()	Get the default server configured in DNS object format.

µC/TCP-IP command module.

Wherever you want to use initialize the command in µC/Shell, you should include the following header:

Include file	Description
Cmd/dns-c_cmd.h	Contains DNSc Command definitions

Function name	Description
DNScCmd_Init()	Function to load DNS client command into shell.

Command	Description	Argument	Usage example
dns_get_host	Resolve a host name. Will printout all address retrieved for an host.	Host name.	dns_get_host micrium.com
dns_server_set	Configure the default server.	server ip address.	dns_server_set 8.8.8.8
dns_cache_clr	Clear all host of the DNS cache	none.	dns_cache_clr
dns_help	Print help	none	dns_help