DNS#

Functions#

int32_t
rsi_dns_req(uint8_t ip_version, uint8_t *url_name, uint8_t *primary_server_address, uint8_t *secondary_server_address, rsi_rsp_dns_query_t *dns_query_resp, uint16_t length)

Query the IP address of a given domain name. This is a blocking API.

int32_t
rsi_dns_update(uint8_t ip_version, uint8_t *zone_name, uint8_t *host_name, uint8_t *server_address, uint16_t ttl, void(*dns_update_rsp_handler)(uint16_t status))

Update the host name for a given host and zone name. This is non-blocking API.

Function Documentation#

rsi_dns_req#

int32_t rsi_dns_req (uint8_t ip_version, uint8_t *url_name, uint8_t *primary_server_address, uint8_t *secondary_server_address, rsi_rsp_dns_query_t *dns_query_resp, uint16_t length)

Query the IP address of a given domain name. This is a blocking API.

Parameters
[in]ip_version

- IP version. 4: IPv4, 6: IPv6

[in]url_name

- Pointer to the domain name to resolve IP address

[in]primary_server_address

- IP address of the DNS server. This parameter is optional, if module gets the DNS server address using DHCP. If DNS server address is obtained using DHCP, in that case this parameter should be NULL.

[in]secondary_server_address

- IP address of the secondary DNS server. In case of no secondary DNS server, IP is NULL.

[out]dns_query_resp

- Pointer to hold DNS query results.

[in]length

- Length of the resultant buffer.

Returns

  • 0 - Success

  • Negative Value - Failure

Note

  • Precondition - rsi_config_ipaddress() API needs to be called before this API.

  • DNS mode is determined by the value of primary_server_address. If NULL, then DNS mode is set to DHCP (1), else it is set to Static IP Address (0).


Definition at line 38 of file network/protocols/rsi_dns.c

rsi_dns_update#

int32_t rsi_dns_update (uint8_t ip_version, uint8_t *zone_name, uint8_t *host_name, uint8_t *server_address, uint16_t ttl, void(*dns_update_rsp_handler)(uint16_t status))

Update the host name for a given host and zone name. This is non-blocking API.

Parameters
[in]ip_version

- IP version. 4: IPv4, 6: IPv6

[in]zone_name

- Pointer to a zone name and to update host name

[in]host_name

- HOST name of the domain

[in]server_address

- IP address of the DNS server. This parameter is optional, if module gets DNS server address using DHCP.

[in]ttl

- Time to live value of the host name.

[in]dns_update_rsp_handler

- Callback function called by driver on reception of DNS update response.

Returns

  • 0 - Success

  • Negative Value - Failure

Note


Definition at line 229 of file network/protocols/rsi_dns.c