Events generated by the Network - DNS Client functions. More...
Functions | |
__STATIC_INLINE void | EvrNetDNS_InitClient (uint32_t num_entries) |
Event on DNS client initialize (Op) | |
__STATIC_INLINE void | EvrNetDNS_GetSocketFailed (void) |
Event on DNS client failed to allocate UDP socket (Error) | |
__STATIC_INLINE void | EvrNetDNS_ChangeDnsServer (int32_t server) |
Event on DNS client change active DNS server (Error) | |
__STATIC_INLINE void | EvrNetDNS_ClientStopTimeoutExpired (void) |
Event on DNS client stop operation timeout expired (Error) | |
__STATIC_INLINE void | EvrNetDNS_ReceiveFrame (const void *net_addr, uint32_t length) |
Event on DNS client receive frame from the server (Op) | |
__STATIC_INLINE void | EvrNetDNS_WrongServerPort (uint16_t udp_port) |
Event on DNS client wrong server port (Error) | |
__STATIC_INLINE void | EvrNetDNS_FrameTooShort (uint32_t length, uint32_t min_length) |
Event on DNS client receive frame is too short (Error) | |
__STATIC_INLINE void | EvrNetDNS_WrongServerAddress (void) |
Event on DNS client wrong DNS server address received (Error) | |
__STATIC_INLINE void | EvrNetDNS_ShowFrameHeader (const void *dns_header) |
Event on DNS client display send/receive frame header (Detail) | |
__STATIC_INLINE void | EvrNetDNS_WrongTransactionId (uint16_t tid, uint16_t tid_valid) |
Event on DNS client wrong transaction identifier (TID) received (Error) | |
__STATIC_INLINE void | EvrNetDNS_DnsRequestReceived (void) |
Event on DNS client received a DNS request (Error) | |
__STATIC_INLINE void | EvrNetDNS_OpcodeNotQuery (void) |
Event on DNS client OPCODE in a response is not QUERY (Error) | |
__STATIC_INLINE void | EvrNetDNS_MessageTruncated (void) |
Event on DNS client truncated response message received (Op) | |
__STATIC_INLINE void | EvrNetDNS_NoSuchNameFound (void) |
Event on DNS client no such name found message received (Op) | |
__STATIC_INLINE void | EvrNetDNS_RcodeAndRecursion (void) |
Event on DNS client RCODE not zero and recursion available received (Error) | |
__STATIC_INLINE void | EvrNetDNS_MoreAnswersReceived (void) |
Event on DNS client more than one answer received (Error) | |
__STATIC_INLINE void | EvrNetDNS_QnameNotTheSame (void) |
Event on DNS client QNAME in a response not the same as requested (Error) | |
__STATIC_INLINE void | EvrNetDNS_QtypeNotTheSame (void) |
Event on DNS client QTYPE in a response not the same as requested (Error) | |
__STATIC_INLINE void | EvrNetDNS_QclassNotInet (void) |
Event on DNS client QCLASS in a response is not CLASS_INET (Error) | |
__STATIC_INLINE void | EvrNetDNS_GotHostAddress (const void *net_addr, uint32_t ttl) |
Event on DNS client receive resolved IP address (Op) | |
__STATIC_INLINE void | EvrNetDNS_GotAuthorityAddress (const void *net_addr) |
Event on DNS client receive IP address of the authority (Op) | |
__STATIC_INLINE void | EvrNetDNS_RecordTypeNotSupported (uint16_t rr_type) |
Event on DNS client can not handle resource record type (Error) | |
__STATIC_INLINE void | EvrNetDNS_Resolve (const char *host_name, uint32_t length) |
Event on DNS client resolve host requested (Op) | |
__STATIC_INLINE void | EvrNetDNS_ResolveInvalidParameter (void) |
Event on DNS client invalid parameter for resolve request (Error) | |
__STATIC_INLINE void | EvrNetDNS_ResolveClientBusy (void) |
Event on DNS client resolve request failed, client busy (Error) | |
__STATIC_INLINE void | EvrNetDNS_ResolvedAddress (const void *net_addr) |
Event on DNS client resolved IP address internally (Op) | |
__STATIC_INLINE void | EvrNetDNS_ResolveDnsServerUnknown (void) |
Event on DNS client resolve failed, DNS server unknown (Error) | |
__STATIC_INLINE void | EvrNetDNS_SendRequest (const void *net_addr) |
Event on DNS client send resolve request to the server (Op) | |
__STATIC_INLINE void | EvrNetDNS_ClearCache (uint32_t deleted, uint32_t available) |
Event on DNS client clear cache requested (API) | |
__STATIC_INLINE void | EvrNetDNS_ClearCacheClientBusy (void) |
Event on DNS client clear cache request failed, client busy (Error) | |
__STATIC_INLINE void | EvrNetDNS_UninitClient (void) |
Event on DNS client de-initialize (Op) | |
Events generated by the Network - DNS Client functions.
The DNS client functions generate events that make it easier to troubleshoot errors, and allow the user to understand how the DNS client works.
__STATIC_INLINE void EvrNetDNS_ChangeDnsServer | ( | int32_t | server | ) |
Event on DNS client change active DNS server (Error)
server | DNS server to use
|
The event ChangeDnsServer is created when the DNS client has changed the active DNS server to a secondary or primary DNS server. This happened because the currently active DNS server was not responding to DNS client requests.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_ClearCache | ( | uint32_t | deleted, |
uint32_t | available | ||
) |
Event on DNS client clear cache requested (API)
deleted | number of entries deleted from cache |
available | number of entries available in cache |
The event ClearCache is created when the function netDNSc_ClearCache is executed.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_ClearCacheClientBusy | ( | void | ) |
Event on DNS client clear cache request failed, client busy (Error)
The event ClearCacheClientBusy is created when the function netDNSc_ClearCache is executed, and the DNS client is still busy resolving the host name.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_ClientStopTimeoutExpired | ( | void | ) |
Event on DNS client stop operation timeout expired (Error)
The event ClientStopTimeoutExpired is created when the DNS operation has expired but is not completed. The DNS client session is then terminated.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_DnsRequestReceived | ( | void | ) |
Event on DNS client received a DNS request (Error)
The event DnsRequestReceived is created when the network library receives a DNS request. The DNS client can not handle DNS requests, so the frame is discarded.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_FrameTooShort | ( | uint32_t | length, |
uint32_t | min_length | ||
) |
Event on DNS client receive frame is too short (Error)
length | frame length in bytes |
min_length | minimum length of the frame |
The event FrameTooShort is created when the network library receives the DNS frame that is too short. The frame is discarded.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_GetSocketFailed | ( | void | ) |
Event on DNS client failed to allocate UDP socket (Error)
The event GetSocketFailed is created when the DNS client is initialized, that is, when the function netInitialize is executed, and the service could not assign the UDP socket. To resolve this error, you must increase the number of available UDP sockets in the UDP socket configuration.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_GotAuthorityAddress | ( | const void * | net_addr | ) |
Event on DNS client receive IP address of the authority (Op)
net_addr | pointer to net address of the authority |
The event GotAuthorityAddress is created when the network library receives the DNS response with the IP address of the authoritative DNS server.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_GotHostAddress | ( | const void * | net_addr, |
uint32_t | ttl | ||
) |
Event on DNS client receive resolved IP address (Op)
net_addr | pointer to network address of the host |
ttl | address expiration timeout |
The event GotHostAddress is created when the network library receives a DNS response with the IP address of the requested host resolved.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_InitClient | ( | uint32_t | num_entries | ) |
Event on DNS client initialize (Op)
num_entries | number of entries available in cache |
The event InitClient is created when the DNS client is initialized, that is, when the function netInitialize is executed.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_MessageTruncated | ( | void | ) |
Event on DNS client truncated response message received (Op)
The event MessageTruncated is created when the network library receives a truncated DNS response. The message is accepted.
__STATIC_INLINE void EvrNetDNS_MoreAnswersReceived | ( | void | ) |
Event on DNS client more than one answer received (Error)
The event MoreAnswersReceived is created when the network library receives a DNS response that contains multiple answers. The frame is discarded.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_NoSuchNameFound | ( | void | ) |
Event on DNS client no such name found message received (Op)
The event NoSuchNameFound is created when the network library receives a DNS response message stating that the requested name can not be found in the DNS database. This means that the host name does not exist.
__STATIC_INLINE void EvrNetDNS_OpcodeNotQuery | ( | void | ) |
Event on DNS client OPCODE in a response is not QUERY (Error)
The event OpcodeNotQuery is created when the network library receives a DNS response in which the opcode is not a Query. The frame is discarded.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_QclassNotInet | ( | void | ) |
Event on DNS client QCLASS in a response is not CLASS_INET (Error)
The event QclassNotInet is created when the network library receives a DNS response with the DNS class that is not Internet. The frame is discarded.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_QnameNotTheSame | ( | void | ) |
Event on DNS client QNAME in a response not the same as requested (Error)
The event QnameNotTheSame is created when the network library receives a DNS response with a host name that is not the same as the requested host name. The frame is discarded.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_QtypeNotTheSame | ( | void | ) |
Event on DNS client QTYPE in a response not the same as requested (Error)
The event QtypeNotTheSame is created when the network library receives a DNS response with a DNS type that is not the same as the DNS type in the request. The frame is discarded.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_RcodeAndRecursion | ( | void | ) |
Event on DNS client RCODE not zero and recursion available received (Error)
The event RcodeAndRecursion is created when the network library receives a DNS response with non-zero rcode and the recursion is available. This is undefined state so the frame is discarded.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_ReceiveFrame | ( | const void * | net_addr, |
uint32_t | length | ||
) |
Event on DNS client receive frame from the server (Op)
net_addr | pointer to NET_ADDR address of the server |
length | frame length in bytes |
The event ReceiveFrame is created when the network library receives the DNS frame.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_RecordTypeNotSupported | ( | uint16_t | rr_type | ) |
Event on DNS client can not handle resource record type (Error)
rr_type | recource record type |
The event RecordTypeNotSupported is created when the network library receives a DNS response that contains a resource record type that is not supported in the DNS client. Such a resource record is ignored.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_Resolve | ( | const char * | host_name, |
uint32_t | length | ||
) |
Event on DNS client resolve host requested (Op)
host_name | name of the host to resolve |
length | length of the host_name string |
The event Resolve is created when the DNS client started the name resolution process, due to a call to the netDNSc_GetHostByName or netDNSc_GetHostByNameX function.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_ResolveClientBusy | ( | void | ) |
Event on DNS client resolve request failed, client busy (Error)
The event ResolveClientBusy is created when the function netDNSc_GetHostByName or netDNSc_GetHostByNameX is executed, and the DNS client is still busy resolving the host name.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_ResolvedAddress | ( | const void * | net_addr | ) |
Event on DNS client resolved IP address internally (Op)
net_addr | pointer to NET_ADDR address structure |
The event ResolvedAddress is created when the DNS client has resolved the requested host name internally. The host name was an ascii address, such as "192.168.0.100" or the local host name.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_ResolveDnsServerUnknown | ( | void | ) |
Event on DNS client resolve failed, DNS server unknown (Error)
The event ResolveDnsServerUnknown is created when the function netDNSc_GetHostByName or netDNSc_GetHostByNameX is executed, and the DNS server address is unknown.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_ResolveInvalidParameter | ( | void | ) |
Event on DNS client invalid parameter for resolve request (Error)
The event ResolveInvalidParameter is created when the DNS client can not start the name resolution process because the function netDNSc_GetHostByName or netDNSc_GetHostByNameX is called with an invalid input parameter.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_SendRequest | ( | const void * | net_addr | ) |
Event on DNS client send resolve request to the server (Op)
net_addr | pointer to NET_ADDR address structure |
The event SendRequest is created when the network library wants to send the DNS request message to DNS server.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_ShowFrameHeader | ( | const void * | dns_header | ) |
Event on DNS client display send/receive frame header (Detail)
dns_header | pointer to DNS frame header of 12 bytes
|
The event ShowFrameHeader is created when the network library wants to display detailed information about the DNS header.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_UninitClient | ( | void | ) |
Event on DNS client de-initialize (Op)
The event UninitClient is created when the function netUninitialize is executed.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_WrongServerAddress | ( | void | ) |
Event on DNS client wrong DNS server address received (Error)
The event WrongServerAddress is created when the network library receives the DNS frame from an invalid DNS server. The frame is discarded.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_WrongServerPort | ( | uint16_t | udp_port | ) |
Event on DNS client wrong server port (Error)
udp_port | wrong UDP port number |
The event WrongServerPort is created when the network library receives the DNS frame from invalid UDP server source port. The frame is discarded.
Value in the Event Recorder shows:
__STATIC_INLINE void EvrNetDNS_WrongTransactionId | ( | uint16_t | tid, |
uint16_t | tid_valid | ||
) |
Event on DNS client wrong transaction identifier (TID) received (Error)
tid | received transaction identifier |
tid_valid | valid transaction identifier |
The event WrongTransactionId is created when the network library receives the DNS response frame, but the received transaction identification (TID) is not identical to the transaction identifier of our DNS request. The frame is therefore discarded.
Value in the Event Recorder shows: