@CHIP-RTOS C Library - TCP/IP API

getHostByAddr2

This function can be used to find the (canonical) domain name associated with a host by one of its IPv6 addresses via the Domain Name Service (DNS).
The operating system manages a DNS cache. Thus it is save to call this function each time you need the respective domain name. The function will not issue another request to the name server before the cached name has expired.

short getHostByAddr2( struct in6_addr far *address,

char far *domainName );

Parameters

address

Pointer to the host's IP address of type struct in6_addr.

domainName

Pointer to a buffer where the function is to store the domain name; A domain name can be up to 254 characters long. Adding one byte for the trailing zero byte of the string, the buffer must have a size of at least 255 bytes.

Return Value

Zero in case of success or negative error code

Comments

DNS queries consume a relative large part of your task's stack.

See Also

getHostByName        getHostByName2        getHostByAddr
getMailHosts        setNameServer        

RTOS API

This library function invokes a RTOS software interrupt. Refer to the RTOS API function DNS_GET_HOST_BY_ADDR2 for more details.

Supported since or modified in @CHIP-RTOS version

SC12	SC13	SC11	SC1x3	SC2x
n/a	n/a	n/a	V1.05	V1.00

Supported by @CHIP-RTOS C Library since version

CLIB
V2.04