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 get DNS server address using DHCP.

[in]secondary_server_address

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

[in]dns_query_resp

- Pointer to hold DNS query results. This is an out parameter.

[in]length

- Length of the resultant buffer.

Returns

  • 0 - Success Negative Value - Failure

Note

  • Refer to Error Codes section for the description of the above error codes Error Codes.


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(*)(uint16_t status) dns_update_rsp_handler)

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 get 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

  • Refer to Error Codes section for the description of the above error codes Error Codes.


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