All µC/DNSc require a run-time configuration that must be passed during the initialization. DNS run-time configuration template files are provided (see µC/DNSc Directories and Files). The run-time configuration template file (dns-c_cfg.* ) should be copied into application folder and modified following your requirements.
Micrium provides sample configuration code free of charge; however, most sample code will likely require modification depending on the combination feature requirements and memory limitation.
Structure Fields
µC/DNSc run-time configuration is based on large structure that contains different configuration sections with many parameter settings. This section describes the instance configuration settings, and should provide you an in-depth understanding of all parameters configuration. You will also discover which settings to modify in order to enhance the functionalities and the performances. Refer to the configuration field description section for further details.
DNSc Run-time Configuration Structure
Configuration Fields Description
Memory allocation configuration
Structure Field | Type | Description | Possible Values |
|---|---|---|---|
MemSegPtr | MEM_SEG |
| DEF_NULL to allocate the memory from the HEAP Pointer to a memory segment to allocate from (see µC/LIB - Memory Segments) |
Default DNS server configuration
Structure Field | Type | Description | Possible Values |
|---|---|---|---|
ServerDfltPtr | CPU_CHAR |
| Pointer to a string that contains the IP address. |
Cache configuration
Structure Field | Type | Description | Possible Values |
|---|---|---|---|
HostNameLenMax | CPU_INT16U |
| MUST be >= 2 |
CacheEntriesMaxNbr | CPU_INT08U | MUST be >= 1 | |
AddrIPv4MaxPerHost | CPU_INT08U | MUST be >= 0 | |
AddrIPv6MaxPerHost | CPU_INT08U | MUST be >= 0 |
Request configuration
Structure Field | Type | Description | Possible Values |
|---|---|---|---|
TaskDly_ms | CPU_INT08U |
| Default value: [DNSc_DFLT_TASK_DLY_MS] = 50ms MUST be >= 1 |
ReqRetryNbrMax | CPU_INT08U | Default value: [DNSc_DFLT_REQ_RETRY_NBR_MAX] = 2 MUST be >= 1 | |
ReqRetryTimeout_ms | CPU_INT16U | Default value: [DNSc_DFLT_REQ_RETRY_TIMEOUT_MS] = 1000ms MUST be >= 100 |