Events generated by the Network - Neighbor Discovery for IPv6 functions. More...

Functions
__STATIC_INLINE void	EvrNetNDP_InitCache (uint16_t if_id, uint32_t num_entries)
	Event on NDP cache initialize (Op) More...

__STATIC_INLINE void	EvrNetNDP_FrameCheckFailed (uint16_t if_id, uint8_t msg_type)
	Event on NDP discovery frame consistency check failed (Error) More...

__STATIC_INLINE void	EvrNetNDP_AddressNotLinkLocal (uint16_t if_id, const uint8_t *ip6_addr)
	Event on NDP receive address not link-local (Op) More...

__STATIC_INLINE void	EvrNetNDP_RouterAdvertisement (uint16_t if_id, uint8_t hop_limit, uint8_t flags, uint16_t lifetime)
	Event on NDP receive Router Advertisement (RA) message (Op) More...

__STATIC_INLINE void	EvrNetNDP_OptionMtu (uint16_t if_id, uint32_t mtu)
	Event on NDP option Maximum transmission unit (MTU) (Op) More...

__STATIC_INLINE void	EvrNetNDP_OptionSourceMacAddress (uint16_t if_id, const uint8_t *src_addr)
	Event on NDP option Source link-layer (MAC) address (Op) More...

__STATIC_INLINE void	EvrNetNDP_OptionPrefixInfo (const uint8_t *opt_prefix)
	Event on NDP option address prefix info (Op) More...

__STATIC_INLINE void	EvrNetNDP_PrefixInfoNotValid (uint16_t if_id)
	Event on NDP prefix information option not valid (Op) More...

__STATIC_INLINE void	EvrNetNDP_WrongTargetAddress (uint16_t if_id, const uint8_t *targ_addr)
	Event on NDP receive wrong target address (Op) More...

__STATIC_INLINE void	EvrNetNDP_NeighborSolicitation (uint16_t if_id, const uint8_t *targ_addr)
	Event on NDP receive Neighbor Solicitation (NS) message (Op) More...

__STATIC_INLINE void	EvrNetNDP_ProbeRequest (uint16_t if_id)
	Event on NDP receive probe request (Op) More...

__STATIC_INLINE void	EvrNetNDP_NeighborAdvertisement (uint16_t if_id, const uint8_t *targ_addr)
	Event on NDP receive Neighbor Advertisement (NA) message (Op) More...

__STATIC_INLINE void	EvrNetNDP_ProbeResponse (uint16_t if_id)
	Event on NDP receive probe response (Op) More...

__STATIC_INLINE void	EvrNetNDP_WrongDestinationAddress (uint16_t if_id, const uint8_t *dst_addr)
	Event on NDP receive wrong destination address (Op) More...

__STATIC_INLINE void	EvrNetNDP_SendReply (uint16_t if_id, const uint8_t *targ_addr)
	Event on NDP send advertisement reply to solicitation message (Op) More...

__STATIC_INLINE void	EvrNetNDP_ShowFlags (uint16_t if_id, uint32_t flags)
	Event on NDP display advertisement message flags (Op) More...

__STATIC_INLINE void	EvrNetNDP_SendRequest (uint16_t if_id, uint32_t type)
	Event on NDP send solicitation request (Op) More...

__STATIC_INLINE void	EvrNetNDP_ShowTargetAddress (uint16_t if_id, const uint8_t *targ_addr)
	Event on NDP display target IPv6 address (Op) More...

__STATIC_INLINE void	EvrNetNDP_OptionTargetMacAddress (uint16_t if_id, const uint8_t *targ_addr)
	Event on NDP option target link-layer (MAC) address (Op) More...

__STATIC_INLINE void	EvrNetNDP_CacheEntryUpdate (uint16_t if_id, uint32_t entry)
	Event on NDP cache entry update (Op) More...

__STATIC_INLINE void	EvrNetNDP_WrongResponse (uint16_t if_id, uint8_t msg_type)
	Event on NDP wrong response received (Error) More...

__STATIC_INLINE void	EvrNetNDP_MakeLinkLocalAddress (uint16_t if_id, const uint8_t *local_addr)
	Event on NDP make link-local address (Op) More...

__STATIC_INLINE void	EvrNetNDP_MakeTempAddress (uint16_t if_id, const uint8_t *temp_addr)
	Event on NDP make temporary address (SLAAC) using prefix info (Op) More...

__STATIC_INLINE void	EvrNetNDP_CacheIpRefreshed (uint16_t if_id, const uint8_t *ip6_addr)
	Event on NDP cached IP address refreshed (Op) More...

__STATIC_INLINE void	EvrNetNDP_CacheAdd (uint16_t if_id, const uint8_t ip6_addr, const uint8_t mac_addr, uint8_t type)
	Event on NDP add entry to NDP cache (Op) More...

__STATIC_INLINE void	EvrNetNDP_RouterListFull (uint16_t if_id, uint32_t max_count)
	Event on NDP cache add router list full (Op) More...

__STATIC_INLINE void	EvrNetNDP_CacheAllocFailed (uint16_t if_id)
	Event on NDP allocate free cache entry failed (Error) More...

__STATIC_INLINE void	EvrNetNDP_CacheEntryAdded (uint16_t if_id, uint32_t entry, uint32_t timeout)
	Event on NDP cache entry added (Op) More...

__STATIC_INLINE void	EvrNetNDP_CacheEntryDeleted (uint16_t if_id, uint32_t entry, const uint8_t *ip6_addr, uint8_t type)
	Event on NDP cache entry deleted (Op) More...

__STATIC_INLINE void	EvrNetNDP_CacheEntryRefreshed (uint16_t if_id, uint32_t entry, const uint8_t *ip6_addr)
	Event on NDP cache entry refreshed (Op) More...

__STATIC_INLINE void	EvrNetNDP_CacheFind (uint16_t if_id, const uint8_t *ip6_addr)
	Event on NDP find IP address in cache (Op) More...

__STATIC_INLINE void	EvrNetNDP_GatewayUnknown (uint16_t if_id, const uint8_t *ip6_addr)
	Event on NDP cache add gateway unknown (Error) More...

__STATIC_INLINE void	EvrNetNDP_UsingGateway (uint16_t if_id, const uint8_t *ip6_addr)
	Event on NDP using gateway to access external address (Op) More...

__STATIC_INLINE void	EvrNetNDP_UnresolvedMacAddress (uint16_t if_id, const uint8_t *ip6_addr)
	Event on NDP unresolved MAC address in cache (Error) More...

__STATIC_INLINE void	EvrNetNDP_EntryFound (uint16_t if_id, uint32_t entry)
	Event on NDP cache entry found (Op) More...

__STATIC_INLINE void	EvrNetNDP_CacheIp (uint16_t if_id, const uint8_t *ip6_addr)
	Event on netNDP_CacheIP execute (API) More...

__STATIC_INLINE void	EvrNetNDP_CacheIpInvalidParameter (uint16_t if_id)
	Event on netNDP_CacheIP invalid parameter (Error) More...

__STATIC_INLINE void	EvrNetNDP_GetIp (uint16_t if_id, const uint8_t mac_addr, const uint8_t ip6_addr)
	Event on netNDP_GetIP resolving success (API) More...

__STATIC_INLINE void	EvrNetNDP_GetIpInvalidParameter (uint16_t if_id)
	Event on netNDP_GetIP invalid parameter (Error) More...

__STATIC_INLINE void	EvrNetNDP_GetIpEntryNotFound (uint16_t if_id, const uint8_t *mac_addr)
	Event on netNDP_GetIP entry with MAC address not found in cache (Op) More...

__STATIC_INLINE void	EvrNetNDP_GetMac (uint16_t if_id, const uint8_t ip6_addr, const uint8_t mac_addr)
	Event on netNDP_GetMAC resolving success (API) More...

__STATIC_INLINE void	EvrNetNDP_GetMacInvalidParameter (uint16_t if_id)
	Event on netNDP_GetMAC invalid parameter (Error) More...

__STATIC_INLINE void	EvrNetNDP_GetMacEntryNotFound (uint16_t if_id, const uint8_t *ip6_addr)
	Event on netNDP_GetMAC entry with IP address not found in cache (Op) More...

__STATIC_INLINE void	EvrNetNDP_Probe (uint16_t if_id, const uint8_t *ip6_addr)
	Event on netNDP_Probe execute (API) More...

__STATIC_INLINE void	EvrNetNDP_ProbeInvalidParameter (uint16_t if_id)
	Event on netNDP_Probe invalid parameter (Error) More...

__STATIC_INLINE void	EvrNetNDP_ProbeBusy (uint16_t if_id)
	Event on NDP probe process busy (Error) More...

__STATIC_INLINE void	EvrNetNDP_ProbeRetransmit (uint16_t if_id, const uint8_t *ip6_addr)
	Event on NDP probe retransmit (Op) More...

__STATIC_INLINE void	EvrNetNDP_ProbeTimeout (uint16_t if_id, const uint8_t *ip6_addr)
	Event on NDP probe timeout (Op) More...

__STATIC_INLINE void	EvrNetNDP_ClearCache (uint16_t if_id, uint32_t deleted, uint32_t available)
	Event on NDP clear cache request (API) More...

__STATIC_INLINE void	EvrNetNDP_ClearCacheInvalidParam (uint16_t if_id)
	Event on netNDP_ClearCache invalid parameter (Error) More...

__STATIC_INLINE void	EvrNetNDP_ClearCacheClientBusy (uint16_t if_id)
	Event on NDP clear cache client busy (Error) More...

__STATIC_INLINE void	EvrNetNDP_CacheEntryTimeout (uint16_t if_id, uint32_t entry, const uint8_t ip6_addr, const uint8_t mac_addr, uint32_t type)
	Event on NDP cache entry timeout (Op) More...

__STATIC_INLINE void	EvrNetNDP_EntryReleased (uint16_t if_id, uint32_t entry)
	Event on NDP cache entry released (Op) More...

__STATIC_INLINE void	EvrNetNDP_ResolveEntry (uint16_t if_id, uint32_t entry)
	Event on resolve NDP cache entry (Op) More...

__STATIC_INLINE void	EvrNetNDP_RefreshEntry (uint16_t if_id, uint32_t entry)
	Event on refresh NDP cache entry (Op) More...

__STATIC_INLINE void	EvrNetNDP_UninitCache (uint16_t if_id)
	Event on NDP cache de-initialize (Op) More...

Description

Events generated by the Network - Neighbor Discovery for IPv6 functions.

The Network Neighbor Discovery functions generate events that report events in the NDP address resolver and NDP cache and help in troubleshooting.

Function Documentation

◆ EvrNetNDP_AddressNotLinkLocal()

__STATIC_INLINE void EvrNetNDP_AddressNotLinkLocal	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on NDP receive address not link-local (Op)

Parameters

if_id	network interface identifier
ip6_addr	pointer to IPv6 source address

Remarks: Nodes must silently discard RA messages if source IP not link-local.

The event AddressNotLinkLocal is created when the network library receives the router advertisement message, but the source IPv6 address is not link-local. The frame is therefore discarded.

Value in the Event Recorder shows:

netif: network interface identifier.
src_addr: source IPv6 address of received RA message.

◆ EvrNetNDP_CacheAdd()

__STATIC_INLINE void EvrNetNDP_CacheAdd	(	uint16_t	if_id,
		const uint8_t *	ip6_addr,
		const uint8_t *	mac_addr,
		uint8_t	type
	)

Event on NDP add entry to NDP cache (Op)

Parameters

if_id	network interface identifier
ip6_addr	pointer to IPv6 address
mac_addr	pointer to MAC address
type	cache entry type: 0x01: Host 0x02: Router

The event CacheAdd is created when the network library wants to add a new host to the NDP cache table.

Value in the Event Recorder shows:

netif: network interface identifier.
ip: IPv6 address of the host to be added to the cache.
mac: MAC address of the host to be added to the cache.
type: cache entry type to be added (Host, Router).

◆ EvrNetNDP_CacheAllocFailed()

__STATIC_INLINE void EvrNetNDP_CacheAllocFailed ( uint16_t if_id )

Event on NDP allocate free cache entry failed (Error)

Parameters

if_id network interface identifier

The event CacheAllocFailed is created when the network library wants to add new host to the NDP cache table, but it fails. Therefore, the new host is not cached. In order to get rid of such events, you must increase the size of the NDP cache table in the ethernet interface configuration.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_CacheEntryAdded()

__STATIC_INLINE void EvrNetNDP_CacheEntryAdded	(	uint16_t	if_id,
		uint32_t	entry,
		uint32_t	timeout
	)

Event on NDP cache entry added (Op)

Parameters

if_id	network interface identifier
entry	cache entry number
timeout	entry timeout in seconds

The event CacheEntryAdded is created when the network library successfully added the new host to the NDP cache table.

Value in the Event Recorder shows:

netif: network interface identifier.
entry: assigned cache entry identifier.
tout: cache entry timeout in seconds.

◆ EvrNetNDP_CacheEntryDeleted()

__STATIC_INLINE void EvrNetNDP_CacheEntryDeleted	(	uint16_t	if_id,
		uint32_t	entry,
		const uint8_t *	ip6_addr,
		uint8_t	type
	)

Event on NDP cache entry deleted (Op)

Parameters

if_id	network interface identifier
entry	cache entry number
ip6_addr	pointer to IPv6 address
type	cache entry type: 0x01: Host 0x02: Router

The event CacheEntryDeleted is created when the network library successfully deleted the router entry from the NDP cache table.

Value in the Event Recorder shows:

netif: network interface identifier.
entry: cache entry identifier.
ip: IPv6 address of the router.
type: cache entry type (Router).

◆ EvrNetNDP_CacheEntryRefreshed()

__STATIC_INLINE void EvrNetNDP_CacheEntryRefreshed	(	uint16_t	if_id,
		uint32_t	entry,
		const uint8_t *	ip6_addr
	)

Event on NDP cache entry refreshed (Op)

Parameters

if_id	network interface identifier
entry	cache entry number
ip6_addr	pointer to IPv6 address

The event CacheEntryRefreshed is created when the network library receives the unicast IPv6 frame, and refresh the entry in the local cache.

Value in the Event Recorder shows:

netif: network interface identifier.
entry: cache entry identifier.
ip: IPv6 address of the cached entry.

◆ EvrNetNDP_CacheEntryTimeout()

__STATIC_INLINE void EvrNetNDP_CacheEntryTimeout	(	uint16_t	if_id,
		uint32_t	entry,
		const uint8_t *	ip6_addr,
		const uint8_t *	mac_addr,
		uint32_t	type
	)

Event on NDP cache entry timeout (Op)

Parameters

if_id	network interface identifier
entry	cache entry number
ip6_addr	pointer to IPv6 address
mac_addr	pointer to MAC address
type	cache entry type: 0x01: Host 0x02: Router

The event CacheEntryTimeout is created when the validity of the NDP cached host has expired. The host will be refreshed or removed from the cache.

Value in the Event Recorder shows:

netif: network interface identifier.
entry: identifier of the host cache entry.
type: type of host cache entry (Host, Router).
ip: IPv6 address of the host cache entry.
mac: MAC address of the host cache entry.

◆ EvrNetNDP_CacheEntryUpdate()

__STATIC_INLINE void EvrNetNDP_CacheEntryUpdate	(	uint16_t	if_id,
		uint32_t	entry
	)

Event on NDP cache entry update (Op)

Parameters

if_id	network interface identifier
entry	cache entry number

The event CacheEntryUpdate is created when the network library receives the network advertisement response and updates the local cached entry.

Value in the Event Recorder shows:

netif: network interface identifier.
entry: identifier of the host cache entry.

◆ EvrNetNDP_CacheFind()

__STATIC_INLINE void EvrNetNDP_CacheFind	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on NDP find IP address in cache (Op)

Parameters

if_id	network interface identifier
ip6_addr	pointer to IPv6 address

The event CacheFind is created when the network library wants to find the host in the NDP cache table to resolve its MAC address. If the host is not in the NDP cache, the network library creates a new entry in the table and starts the resolution process.

Value in the Event Recorder shows:

netif: network interface identifier.
ip: IPv6 address of the host being searched in the cache.

◆ EvrNetNDP_CacheIp()

__STATIC_INLINE void EvrNetNDP_CacheIp	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on netNDP_CacheIP execute (API)

Parameters

if_id	network interface identifier
ip6_addr	pointer to requested IPv6 address

The event CacheIp is created when the function netNDP_CacheIP is executed.

Value in the Event Recorder shows:

netif: network interface identifier.
ip: IPv6 address of the host being requested.

◆ EvrNetNDP_CacheIpInvalidParameter()

__STATIC_INLINE void EvrNetNDP_CacheIpInvalidParameter ( uint16_t if_id )

Event on netNDP_CacheIP invalid parameter (Error)

Parameters

if_id network interface identifier

The event CacheIpInvalidParameter is created when the function netNDP_CacheIP is executed, and the function input parameter is invalid.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_CacheIpRefreshed()

__STATIC_INLINE void EvrNetNDP_CacheIpRefreshed	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on NDP cached IP address refreshed (Op)

Parameters

if_id	network interface identifier
ip6_addr	pointer to IPv6 address

The event CacheIpRefreshed is created when the network library wants to add a new host to the NDP cache table, but finds it already cached. Therefore, the new host is only refreshed in the cache table.

Value in the Event Recorder shows:

netif: network interface identifier.
ip: IPv6 address of the host to be added to the cache.

◆ EvrNetNDP_ClearCache()

__STATIC_INLINE void EvrNetNDP_ClearCache	(	uint16_t	if_id,
		uint32_t	deleted,
		uint32_t	available
	)

Event on NDP clear cache request (API)

Parameters

if_id	network interface identifier
deleted	number of entries deleted from cache
available	number of entries available in cache

The event ClearCache is created when the function netNDP_ClearCache is executed.

Value in the Event Recorder shows:

netif: network interface identifier.
deleted: number of deleted cache entries.
max: maximum number of NDP cache entries.

◆ EvrNetNDP_ClearCacheClientBusy()

__STATIC_INLINE void EvrNetNDP_ClearCacheClientBusy ( uint16_t if_id )

Event on NDP clear cache client busy (Error)

Parameters

if_id network interface identifier

The event ClearCacheClientBusy is created when the function netNDP_ClearCache is executed, and the internal cache process is still in progress. For example, netNDP_Probe is still running and not yet complete.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_ClearCacheInvalidParam()

__STATIC_INLINE void EvrNetNDP_ClearCacheInvalidParam ( uint16_t if_id )

Event on netNDP_ClearCache invalid parameter (Error)

Parameters

if_id network interface identifier

The event ClearCacheInvalidParam is created when the function netNDP_ClearCache is executed, and the function input parameter is invalid.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_EntryFound()

__STATIC_INLINE void EvrNetNDP_EntryFound	(	uint16_t	if_id,
		uint32_t	entry
	)

Event on NDP cache entry found (Op)

Parameters

if_id	network interface identifier
entry	cache entry number

The event EntryFound is created when the network library wants to notify that it has found the host in the NDP cache table.

Value in the Event Recorder shows:

netif: network interface identifier.
entry: identifier of the host cache entry.

◆ EvrNetNDP_EntryReleased()

__STATIC_INLINE void EvrNetNDP_EntryReleased	(	uint16_t	if_id,
		uint32_t	entry
	)

Event on NDP cache entry released (Op)

Parameters

if_id	network interface identifier
entry	cache entry number

The event EntryReleased is created when the cached host entry is released from the NDP cache.

Value in the Event Recorder shows:

netif: network interface identifier.
entry: identifier of the host cache entry.

◆ EvrNetNDP_FrameCheckFailed()

__STATIC_INLINE void EvrNetNDP_FrameCheckFailed	(	uint16_t	if_id,
		uint8_t	msg_type
	)

Event on NDP discovery frame consistency check failed (Error)

Parameters

if_id	network interface identifier
msg_type	discovery message type 134: Router Advertisement 135: Neighbor Solicitation 136: Neighbor Advertisement

The event FrameCheckFailed is created when the network library has checked the received NDP discovery frame and found the inconsistency. The frame is therefore discarded.

Value in the Event Recorder shows:

netif: network interface identifier.
type: received discovery message type.

◆ EvrNetNDP_GatewayUnknown()

__STATIC_INLINE void EvrNetNDP_GatewayUnknown	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on NDP cache add gateway unknown (Error)

Parameters

if_id	network interface identifier
ip6_addr	pointer to IPv6 address of a gateway

The event GatewayUnknown is created when the network library wants to find the non-local host in the NDP cache table. The network library uses the gateway to access the host, but finds that the gateway address is not specified.

Value in the Event Recorder shows:

netif: network interface identifier.
gw: IPv6 address of the default gateway.

◆ EvrNetNDP_GetIp()

__STATIC_INLINE void EvrNetNDP_GetIp	(	uint16_t	if_id,
		const uint8_t *	mac_addr,
		const uint8_t *	ip6_addr
	)

Event on netNDP_GetIP resolving success (API)

Parameters

if_id	network interface identifier
mac_addr	pointer to requested MAC address
ip6_addr	pointer to resolved IPv6 address

The event GetIp is created when the function netNDP_GetIP is executed.

Value in the Event Recorder shows:

netif: network interface identifier.
ip: returned IPv6 address of the host.
mac: MAC address of the host being requested.

◆ EvrNetNDP_GetIpEntryNotFound()

__STATIC_INLINE void EvrNetNDP_GetIpEntryNotFound	(	uint16_t	if_id,
		const uint8_t *	mac_addr
	)

Event on netNDP_GetIP entry with MAC address not found in cache (Op)

Parameters

if_id	network interface identifier
mac_addr	pointer to requested MAC address

The event GetIpEntryNotFound is created when the function netNDP_GetIP is executed, but the requested MAC address of the host in the cache is missing.

Value in the Event Recorder shows:

netif: network interface identifier.
mac: MAC address of the host being requested.

◆ EvrNetNDP_GetIpInvalidParameter()

__STATIC_INLINE void EvrNetNDP_GetIpInvalidParameter ( uint16_t if_id )

Event on netNDP_GetIP invalid parameter (Error)

Parameters

if_id network interface identifier

The event GetIpInvalidParameter is created when the function netNDP_GetIP is executed, and the function input parameter is invalid.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_GetMac()

__STATIC_INLINE void EvrNetNDP_GetMac	(	uint16_t	if_id,
		const uint8_t *	ip6_addr,
		const uint8_t *	mac_addr
	)

Event on netNDP_GetMAC resolving success (API)

Parameters

if_id	network interface identifier
ip6_addr	pointer to requested IPv6 address
mac_addr	pointer to resolved MAC address

The event GetMac is created when the function netNDP_GetMAC is executed.

Value in the Event Recorder shows:

netif: network interface identifier.
mac: returned MAC address of the host.
ip: IPv6 address of the host being requested.

◆ EvrNetNDP_GetMacEntryNotFound()

__STATIC_INLINE void EvrNetNDP_GetMacEntryNotFound	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on netNDP_GetMAC entry with IP address not found in cache (Op)

Parameters

if_id	network interface identifier
ip6_addr	pointer to requested IPv6 address

The event GetMacEntryNotFound is created when the function netNDP_GetMAC is executed, but the requested IPv6 address of the host in the cache is missing.

Value in the Event Recorder shows:

netif: network interface identifier.
ip: IPv6 address of the host being requested.

◆ EvrNetNDP_GetMacInvalidParameter()

__STATIC_INLINE void EvrNetNDP_GetMacInvalidParameter ( uint16_t if_id )

Event on netNDP_GetMAC invalid parameter (Error)

Parameters

if_id network interface identifier

The event GetMacInvalidParameter is created when the function netNDP_GetMAC is executed, and the function input parameter is invalid.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_InitCache()

__STATIC_INLINE void EvrNetNDP_InitCache	(	uint16_t	if_id,
		uint32_t	num_entries
	)

Event on NDP cache initialize (Op)

Parameters

if_id	network interface identifier
num_entries	number of entries available in NDP cache

The event InitCache is created when the NDP service is initialized, that is, when the function netInitialize is executed.

Value in the Event Recorder shows:

netif: network interface identifier.
entries: number of entries available in NDP cache table.

◆ EvrNetNDP_MakeLinkLocalAddress()

__STATIC_INLINE void EvrNetNDP_MakeLinkLocalAddress	(	uint16_t	if_id,
		const uint8_t *	local_addr
	)

Event on NDP make link-local address (Op)

Parameters

if_id	network interface identifier
local_addr	pointer to link-local address

The event MakeLinkLocalAddress is created when the network library generates the link-local IPv6 address. The address is generated from the interface's MAC address using the EUI-64 format.

Value in the Event Recorder shows:

netif: network interface identifier.
local_addr: generated link-local IPv6 address.

◆ EvrNetNDP_MakeTempAddress()

__STATIC_INLINE void EvrNetNDP_MakeTempAddress	(	uint16_t	if_id,
		const uint8_t *	temp_addr
	)

Event on NDP make temporary address (SLAAC) using prefix info (Op)

Parameters

if_id	network interface identifier
temp_addr	pointer to temporary address

The event MakeLinkLocalAddress is created when the network library generates the temporary IPv6 address. The address is generated from the interface's MAC address using the EUI-64 format and received prefix information from the router.

Value in the Event Recorder shows:

netif: network interface identifier.
temp_addr: generated temporary IPv6 address.

◆ EvrNetNDP_NeighborAdvertisement()

__STATIC_INLINE void EvrNetNDP_NeighborAdvertisement	(	uint16_t	if_id,
		const uint8_t *	targ_addr
	)

Event on NDP receive Neighbor Advertisement (NA) message (Op)

Parameters

if_id	network interface identifier
targ_addr	pointer to target address

The event NeighborAdvertisement is created when the network library receives a valid neighbor advertisement message.

Value in the Event Recorder shows:

netif: network interface identifier.
targ_addr: received target IPv6 address.

◆ EvrNetNDP_NeighborSolicitation()

__STATIC_INLINE void EvrNetNDP_NeighborSolicitation	(	uint16_t	if_id,
		const uint8_t *	targ_addr
	)

Event on NDP receive Neighbor Solicitation (NS) message (Op)

Parameters

if_id	network interface identifier
targ_addr	pointer to target address

The event NeighborSolicitation is created when the network library receives a valid neighbor solicitation message.

Value in the Event Recorder shows:

netif : network interface identifier.
targ_addr: received target IPv6 address.

◆ EvrNetNDP_OptionMtu()

__STATIC_INLINE void EvrNetNDP_OptionMtu	(	uint16_t	if_id,
		uint32_t	mtu
	)

Event on NDP option Maximum transmission unit (MTU) (Op)

Parameters

if_id	network interface identifier
mtu	maximum transmission unit

The event OptionMtu is created when the network library receives the router advertisement, and finds the MTU option in the message.

Value in the Event Recorder shows:

netif: network interface identifier.
mtu: advertised IPv6 MTU in bytes.

◆ EvrNetNDP_OptionPrefixInfo()

__STATIC_INLINE void EvrNetNDP_OptionPrefixInfo ( const uint8_t * opt_prefix )

Event on NDP option address prefix info (Op)

Parameters

opt_prefix

pointer to prefix info structure (32 bytes)

Type: 1 byte
Length: 1 byte
PrefixLen: 1 byte
Flags: 1 byte
Valid: 4 bytes
Preferred: 4 bytes
Reserved: 4 bytes
Prefix: 16 bytes

The event OptionPrefixInfo is created when the network library receives the router advertisement, and finds the prefix information options in the message.

Value in the Event Recorder shows:

prefix: prefix address and prefix length.
valid: prefix valid time in seconds.
prefrd: prefix preferred time in seconds.
flags: prefix flags.

◆ EvrNetNDP_OptionSourceMacAddress()

__STATIC_INLINE void EvrNetNDP_OptionSourceMacAddress	(	uint16_t	if_id,
		const uint8_t *	src_addr
	)

Event on NDP option Source link-layer (MAC) address (Op)

Parameters

if_id	network interface identifier
src_addr	source link-layer address

The event OptionSourceMacAddress is created when the network library receives the neighbor solicitation or router advertisement, and finds the source MAC address option in the message.

Value in the Event Recorder shows:

netif: network interface identifier.
addr: source link-layer address (MAC).

◆ EvrNetNDP_OptionTargetMacAddress()

__STATIC_INLINE void EvrNetNDP_OptionTargetMacAddress	(	uint16_t	if_id,
		const uint8_t *	targ_addr
	)

Event on NDP option target link-layer (MAC) address (Op)

Parameters

if_id	network interface identifier
targ_addr	target link-layer address

The event OptionTargetMacAddress is created when the network library wants to display the target MAC address option found in the received neighbor advertisement message.

Value in the Event Recorder shows:

netif: network interface identifier.
addr: received target link-layer address (MAC).

◆ EvrNetNDP_PrefixInfoNotValid()

__STATIC_INLINE void EvrNetNDP_PrefixInfoNotValid ( uint16_t if_id )

Event on NDP prefix information option not valid (Op)

Remarks: Nodes must silently discard not valid RA messages.

The event PrefixInfoNotValid is created when the network library receives the router advertisement message, validates the prefix information and finds errors in it. Therefore, the advertised prefix information is ignored.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_Probe()

__STATIC_INLINE void EvrNetNDP_Probe	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on netNDP_Probe execute (API)

Parameters

if_id	network interface identifier
ip6_addr	pointer to requested IPv6 address

The event Probe is created when the function netNDP_Probe is executed.

Value in the Event Recorder shows:

netif: network interface identifier.
ip: IPv6 address of the host being tested.

◆ EvrNetNDP_ProbeBusy()

__STATIC_INLINE void EvrNetNDP_ProbeBusy ( uint16_t if_id )

Event on NDP probe process busy (Error)

Parameters

if_id network interface identifier

The event ProbeBusy is created when the function netNDP_Probe is executed, and the internal probe process is still busy.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_ProbeInvalidParameter()

__STATIC_INLINE void EvrNetNDP_ProbeInvalidParameter ( uint16_t if_id )

Event on netNDP_Probe invalid parameter (Error)

Parameters

if_id network interface identifier

The event ProbeInvalidParameter is created when the function netNDP_Probe is executed, and the function input parameter is invalid.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_ProbeRequest()

__STATIC_INLINE void EvrNetNDP_ProbeRequest ( uint16_t if_id )

Event on NDP receive probe request (Op)

Parameters

if_id network interface identifier

The event ProbeRequest is created when the network library receives a valid neighbor solicitation message, which is identified as the address probe request. This usually happens when the host checks if the requested IPv6 address is already in use.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_ProbeResponse()

__STATIC_INLINE void EvrNetNDP_ProbeResponse ( uint16_t if_id )

Event on NDP receive probe response (Op)

Parameters

if_id network interface identifier

The event ProbeResponse is created when the network library receives the response to address probe request that was sent. This usually happens when the requested IPv6 address is already in use.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_ProbeRetransmit()

__STATIC_INLINE void EvrNetNDP_ProbeRetransmit	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on NDP probe retransmit (Op)

Parameters

if_id	network interface identifier
ip6_addr	pointer to IPv6 address of probed host

The event ProbeRetransmit is created when the network library resends the request for testing the IPv6 address, if it is in use.

Value in the Event Recorder shows:

netif: network interface identifier.
ip: IPv6 address of the host being tested.

◆ EvrNetNDP_ProbeTimeout()

__STATIC_INLINE void EvrNetNDP_ProbeTimeout	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on NDP probe timeout (Op)

Parameters

if_id	network interface identifier
ip6_addr	pointer to IPv6 address of probed host

The event ProbeTimeout is created when the network library has left the IPv6 address test procedure, since no host responded. The tested IPv6 address is considered to be free.

Value in the Event Recorder shows:

netif: network interface identifier.
ip: IPv6 address of the host being tested.

◆ EvrNetNDP_RefreshEntry()

__STATIC_INLINE void EvrNetNDP_RefreshEntry	(	uint16_t	if_id,
		uint32_t	entry
	)

Event on refresh NDP cache entry (Op)

Parameters

if_id	network interface identifier
entry	cache entry number

The event RefreshEntry is created when the network library wants to refresh the required NDP entry in the cache. This happens when the NDP entry expires, and the type of entry is Inuse-IP.

Value in the Event Recorder shows:

netif: network interface identifier.
entry: identifier of the host cache entry.

◆ EvrNetNDP_ResolveEntry()

__STATIC_INLINE void EvrNetNDP_ResolveEntry	(	uint16_t	if_id,
		uint32_t	entry
	)

Event on resolve NDP cache entry (Op)

Parameters

if_id	network interface identifier
entry	cache entry number

The event ResolveEntry is created when the network library wants to resolve the required NDP entry in the cache. This usually happens when the NDP entry is created, but it is not yet resolved or has expired.

Value in the Event Recorder shows:

netif: network interface identifier.
entry: identifier of the host cache entry.

◆ EvrNetNDP_RouterAdvertisement()

__STATIC_INLINE void EvrNetNDP_RouterAdvertisement	(	uint16_t	if_id,
		uint8_t	hop_limit,
		uint8_t	flags,
		uint16_t	lifetime
	)

Event on NDP receive Router Advertisement (RA) message (Op)

Parameters

if_id	network interface identifier
hop_limit	current hop limit
flags	advertisement flags 0x80: M-flag (Managed address configuration) 0x40: O-flag (Other configuration)
lifetime	router lifetime in seconds

The event RouterAdvertisement is created when the network library receives a valid router advertisement message.

Value in the Event Recorder shows:

netif: network interface identifier.
hop_limit: current hop limit.
flags: advertised configuration M and O flags.
lifetime: advertised router lifetime in seconds.

◆ EvrNetNDP_RouterListFull()

__STATIC_INLINE void EvrNetNDP_RouterListFull	(	uint16_t	if_id,
		uint32_t	max_count
	)

Event on NDP cache add router list full (Op)

Parameters

if_id	network interface identifier
max_count	maximum number of routers cached

The event RouterListFull is created when the network library wants to add a new router to the NDP cache table, but all router cache entries are used.

Value in the Event Recorder shows:

netif: network interface identifier.
max_count: maximum number of router cache entries.

◆ EvrNetNDP_SendReply()

__STATIC_INLINE void EvrNetNDP_SendReply	(	uint16_t	if_id,
		const uint8_t *	targ_addr
	)

Event on NDP send advertisement reply to solicitation message (Op)

Parameters

if_id	network interface identifier
targ_addr	pointer to target address

The event SendReply is created when the network library wants to send a reply to the received neighbor solicitation message.

Value in the Event Recorder shows:

netif: network interface identifier.
targ_addr: destination IPv6 address for replying.

◆ EvrNetNDP_SendRequest()

__STATIC_INLINE void EvrNetNDP_SendRequest	(	uint16_t	if_id,
		uint32_t	type
	)

Event on NDP send solicitation request (Op)

Parameters

if_id	network interface identifier
type	request type 133: Router Solicitation 135: Neighbor Solicitation

The event SendRequest is created when the network library wants to send a solicitation message.

Value in the Event Recorder shows:

netif: network interface identifier.
type: message type to send (ROUTER_SOL, NEIGHB_SOL).

◆ EvrNetNDP_ShowFlags()

__STATIC_INLINE void EvrNetNDP_ShowFlags	(	uint16_t	if_id,
		uint32_t	flags
	)

Event on NDP display advertisement message flags (Op)

Parameters

if_id	network interface identifier
flags	message flags

The event ShowFlags is created when the network library wants to display the flags for the neighbor advertisement reply.

Value in the Event Recorder shows:

netif: network interface identifier.
flags: advertisement flags for the message.

◆ EvrNetNDP_ShowTargetAddress()

__STATIC_INLINE void EvrNetNDP_ShowTargetAddress	(	uint16_t	if_id,
		const uint8_t *	targ_addr
	)

Event on NDP display target IPv6 address (Op)

Parameters

if_id	network interface identifier
targ_addr	pointer to target address

The event ShowTargetAddress is created when the network library wants to display the target address for the solicitation message being generated.

Value in the Event Recorder shows:

netif: network interface identifier.
targ_addr: target IPv6 address.

◆ EvrNetNDP_UninitCache()

__STATIC_INLINE void EvrNetNDP_UninitCache ( uint16_t if_id )

Event on NDP cache de-initialize (Op)

Parameters

if_id network interface identifier

The event UninitCache is created when the function netUninitialize is executed.

Value in the Event Recorder shows:

netif: network interface identifier.

◆ EvrNetNDP_UnresolvedMacAddress()

__STATIC_INLINE void EvrNetNDP_UnresolvedMacAddress	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on NDP unresolved MAC address in cache (Error)

Parameters

if_id	network interface identifier
ip6_addr	pointer to requested IPv6 address

The event UnresolvedMacAddress is created when the network library wants to find the host in the NDP cache table to resolve its MAC address, but the host is in the process of resolving. MAC address is not yet valid.

Value in the Event Recorder shows:

netif: network interface identifier.
ip: IPv6 address of the host being searched in the cache.

◆ EvrNetNDP_UsingGateway()

__STATIC_INLINE void EvrNetNDP_UsingGateway	(	uint16_t	if_id,
		const uint8_t *	ip6_addr
	)

Event on NDP using gateway to access external address (Op)

Parameters

if_id	network interface identifier
ip6_addr	pointer to IPv6 address of a gateway

The event UsingGateway is created when the network library wants to find the non-local host in the NDP cache table. The network library uses the gateway to access the host.

Value in the Event Recorder shows:

netif: network interface identifier.
gw: IPv6 address of the default gateway.

◆ EvrNetNDP_WrongDestinationAddress()

__STATIC_INLINE void EvrNetNDP_WrongDestinationAddress	(	uint16_t	if_id,
		const uint8_t *	dst_addr
	)

Event on NDP receive wrong destination address (Op)

Parameters

if_id	network interface identifier
dst_addr	pointer to destination address

The event WrongDestinationAddress is created when the network library receives the neighbor advertisement message, but the destination address is not ours. The message is therefore discarded.

Value in the Event Recorder shows:

netif: network interface identifier.
dst_addr: received destination IPv6 address.

◆ EvrNetNDP_WrongResponse()

__STATIC_INLINE void EvrNetNDP_WrongResponse	(	uint16_t	if_id,
		uint8_t	msg_type
	)

Event on NDP wrong response received (Error)

Parameters

if_id	network interface identifier
msg_type	discovery message type 136: Neighbor Advertisement

The event WrongResponse is created when the network library receives the network advertisement response, but the library does not wait for it, or the mandatory options in the message are missing.

Value in the Event Recorder shows:

netif: network interface identifier.
type: received message type (NEIGHB_ADVER).

◆ EvrNetNDP_WrongTargetAddress()

__STATIC_INLINE void EvrNetNDP_WrongTargetAddress	(	uint16_t	if_id,
		const uint8_t *	targ_addr
	)

Event on NDP receive wrong target address (Op)

Parameters

if_id	network interface identifier
targ_addr	pointer to target address

The event WrongTargetAddress is created when the network library receives the neighbor solicitation message, but the target IPv6 address is not ours. The message is therefore discarded.

Value in the Event Recorder shows:

netif: network interface identifier.
targ_addr: received target IPv6 address.

Functions

Description

Function Documentation

◆ EvrNetNDP_AddressNotLinkLocal()

◆ EvrNetNDP_CacheAdd()

◆ EvrNetNDP_CacheAllocFailed()

◆ EvrNetNDP_CacheEntryAdded()

◆ EvrNetNDP_CacheEntryDeleted()

◆ EvrNetNDP_CacheEntryRefreshed()

◆ EvrNetNDP_CacheEntryTimeout()

◆ EvrNetNDP_CacheEntryUpdate()

◆ EvrNetNDP_CacheFind()

◆ EvrNetNDP_CacheIp()

◆ EvrNetNDP_CacheIpInvalidParameter()

◆ EvrNetNDP_CacheIpRefreshed()

◆ EvrNetNDP_ClearCache()

◆ EvrNetNDP_ClearCacheClientBusy()

◆ EvrNetNDP_ClearCacheInvalidParam()

◆ EvrNetNDP_EntryFound()

◆ EvrNetNDP_EntryReleased()

◆ EvrNetNDP_FrameCheckFailed()

◆ EvrNetNDP_GatewayUnknown()

◆ EvrNetNDP_GetIp()

◆ EvrNetNDP_GetIpEntryNotFound()

◆ EvrNetNDP_GetIpInvalidParameter()

◆ EvrNetNDP_GetMac()

◆ EvrNetNDP_GetMacEntryNotFound()

◆ EvrNetNDP_GetMacInvalidParameter()

◆ EvrNetNDP_InitCache()

◆ EvrNetNDP_MakeLinkLocalAddress()

◆ EvrNetNDP_MakeTempAddress()

◆ EvrNetNDP_NeighborAdvertisement()

◆ EvrNetNDP_NeighborSolicitation()

◆ EvrNetNDP_OptionMtu()

◆ EvrNetNDP_OptionPrefixInfo()

◆ EvrNetNDP_OptionSourceMacAddress()

◆ EvrNetNDP_OptionTargetMacAddress()

◆ EvrNetNDP_PrefixInfoNotValid()

◆ EvrNetNDP_Probe()

◆ EvrNetNDP_ProbeBusy()

◆ EvrNetNDP_ProbeInvalidParameter()

◆ EvrNetNDP_ProbeRequest()

◆ EvrNetNDP_ProbeResponse()

◆ EvrNetNDP_ProbeRetransmit()

◆ EvrNetNDP_ProbeTimeout()

◆ EvrNetNDP_RefreshEntry()

◆ EvrNetNDP_ResolveEntry()

◆ EvrNetNDP_RouterAdvertisement()

◆ EvrNetNDP_RouterListFull()

◆ EvrNetNDP_SendReply()

◆ EvrNetNDP_SendRequest()

◆ EvrNetNDP_ShowFlags()

◆ EvrNetNDP_ShowTargetAddress()

◆ EvrNetNDP_UninitCache()

◆ EvrNetNDP_UnresolvedMacAddress()

◆ EvrNetNDP_UsingGateway()

◆ EvrNetNDP_WrongDestinationAddress()

◆ EvrNetNDP_WrongResponse()

◆ EvrNetNDP_WrongTargetAddress()