Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Argument Checking and Debug Configuration

Most functions in μC/DNSc include code to validate arguments that are passed to it. Specifically, μC/DNSc checks to see if passed pointers are NULL, if arguments are within valid ranges, etc. The following constants configure additional argument checking.

 

Constant
Description
Possible Values
DNSc_CFG_ARG_CHK_EXT_EN
Allows code to be generated to check arguments for functions that can be called by the user and, for functions which are internal but receive arguments from an API that the user can call.DEF_ENABLED or DEF_DISABLED

 

Table - Argument Checking and Debug Configuration

Mode configuration

 

 

Constant
Description
Possible Values
DNSc_CFG_MODE_ASYNC_EN

Configure DNSc_CFG_MODE_ASYNC_EN to enable/disable the DNS client asynchronous communication mode.

When ENABLED, A dedicated task will handle all host resolution request. It will be possible to call DNS API to get remote host address without blocking.

When DISABLED, The API to get remote host will always block until the resolution is completed.

DEF_ENABLED or DEF_DISABLED
DNSc_CFG_MODE_BLOCK_EN

Configure DNSc_CFG_MODE_BLOCK_EN to enable/disable the blocking option when the asynchronous communication is enabled.

When ENABLED, It will be possible to block when calling the DNS API to get remote host until the resolution is completed (via a flag option).

When DISABLED, The API to get remote host will always be non-blocking, must poll DNS client to know when the resolution is completed.

DEF_ENABLED or DEF_DISABLED

 

Table - Mode Configuration