This chapter contains a description of the NetX Duo events.
The following is a list of NetX Duo events displayed by TraceX.
Icon | Meaning |
---|---|
Internal ARP Request Receive |
|
Internal ARP Request Send |
|
Internal ARP Response Receive |
|
Internal ARP Response Send |
|
Internal ICMP Receive |
|
Internal ICMP Send |
|
Internal NetX Duo IGMP Receive |
|
Internal IP Receive |
|
Internal IP Send |
|
Internal TCP Data Receive |
|
Internal TCP Data Send |
|
Internal TCP FIN Receive |
|
Internal TCP FIN Send |
|
Internal TCP RST Receive |
|
Internal TCP RST Send |
|
Internal TCP SYN Receive |
|
Internal TCP SYN Send |
|
Internal UDP Receive |
|
Internal UDP Send |
|
Internal RARP Receive |
|
Internal RARP Send |
|
Internal TCP Retry |
|
Internal TCP State Change |
|
Internal I/O Driver Packet Send |
|
Internal I/O Driver Initialize |
|
Internal I/O Driver Link Enable |
|
Internal I/O Driver Link Disable |
|
Internal I/O Driver Packet Broadcast |
|
Internal I/O Driver ARP Send |
|
Internal I/O Driver ARP Response Send |
|
Internal I/O Driver RARP Send |
|
Internal I/O Driver Multicast Join |
|
Internal I/O Driver Multicast Leave |
|
Internal I/O Driver Get Status |
|
Internal I/O Driver Get Speed |
|
Internal I/O Driver Get Duplex Type |
|
Internal I/O Driver Get Error Count |
|
Internal I/O Driver Get RX Count |
|
Internal I/O Driver Get TX Count |
|
Internal I/O Driver Get Allocation Errors |
|
Internal I/O Driver Un-initialize |
|
Internal I/O Driver Deferred Processing |
|
ARP Dynamic Entries Invalidate (nx_arp_dynamic_entries_invalidate) |
|
ARP Dynamic Entry Set (nx_arp_dynamic_entry_set) |
|
ARP Enable (nx_arp_enable) |
|
ARP Gratuitous Send (nx_arp_gratuitous_send) |
|
ARP Hardware Address Find (nx_arp_hardware_address_find) |
|
ARP Information Get (nx_arp_info_get) |
|
ARP IP Address Find (nx_arp_ip_address_find) |
|
ARP Static Entry Create (nx_arp_static_entry_create) |
|
ARP Static Entries Delete (nx_arp_static_entries_delete) |
|
ARP Static Entry Delete (nx_arp_static_entry_delete) |
|
Duo Cache Entry Delete (nxd_nd_cache_entry_delete) |
|
Duo Cache Entry Set (nxd_nd_cache_entry_set) |
|
Duo Cache Invalidate (nxd_nd_cache_invalidate) |
|
Duo Cache IP Address Find (nxd_nd_cache_ip_address_find) |
|
Duo ICMP Enable (nxd_icmp_enable) |
|
Duo ICMP IPv6 Ping (nxd_icmp_ping) |
|
Duo IP Max Payload Size Find (nx_max_payload_size_find) |
|
Duo IP Raw Packet Send (nxd_ip_raw_packet_send) |
|
Duo IPv6 Default Router Add (nxd_ipv6_default_router_add) |
|
Duo IPv6 Default Router Delete (nxd_ipv6_default_router_delete) |
|
Duo IPv6 Enable (nxd_ipv6_enable) |
|
Duo IPv6 Global Address Get (nxd_ipv6_global_address_get) |
|
Duo IPv6 Global Address Set (nxd_ipv6_global_address_set) |
|
Duo IPv6 Initiate Dad Process (nxd_ipv6_initiate_dad_process) |
|
Duo IPv6 Interface Address Get (nxd_ipv6_interface_address_get) |
|
Duo IPv6 Interface Address Set (nxd_ipv6_interface_address_set) |
|
Duo IPv6 Link Local Address Get (nxd_ipv6_linklocal_address_get) |
|
Duo IPv6 Link Local Address Set (nxd_ipv6_linklocal_address_set) |
|
Duo IPv6 Raw Packet Send (nxd_ipv6_raw_packet_send) |
|
Duo TCP Socket Peer Info Get (nxd_tcp_socket_peer_info_get) |
|
Duo TCP Socket Set Interface (nxd_tcp_socket_set_interface) |
|
Duo UDP Socket Send (nxd_udp_socket_send) |
|
Duo UDP Socket Set Interface (nxd_udp_socket_set_interface) |
|
Duo UDP Source Extract (nxd_udp_source_extract) |
|
ICMP Enable (nx_icmp_enable) |
|
ICMP Information Get (nx_icmp_info_get) |
|
ICMP Ping (nx_icmp_ping) |
|
IGMP Enable (nx_igmp_enable) |
|
IGMP Information Get (nx_igmp_info_get) |
|
IGMP Loopback Disable (nx_igmp_loopback_disable) |
|
IGMP Loopback Enable (nx_igmp_loopback_enable) |
|
IGMP Multicast Join (nx_igmp_multicast_join) |
|
IGMP Multicast Leave (nx_igmp_multicast_leave) |
|
IP Address Change Notify (nx_ip_address_change_notify) |
|
IP Address Get (nx_ip_address_get) |
|
IP Address Set (nx_ip_address_set) |
|
IP Create (nx_ip_create) |
|
IP Delete (nx_ip_delete) |
|
IP Driver Direct Command (nx_ip_driver_direct_command) |
|
IP Forwarding Disable (nx_ip_forwarding_disable) |
|
IP Forwarding Enable (nx_ip_forwarding_enable) |
|
IP Fragment Disable (nx_ip_fragment_disable) |
|
IP Fragment Enable (nx_ip_fragment_enable) |
|
IP Gateway Address Set (nx_ip_gateway_address_set) |
|
IP Information Get (nx_ip_info_get) |
|
IP Interface Attach (nx_ip_interface_attach) |
|
IP Interface Info Get (nx_ip_interface_info_get) |
|
IP Raw Packet Disable (nx_ip_raw_packet_disable) |
|
IP Raw Packet Enable (nx_ip_raw_packet_enable) |
|
IP Raw Packet Receive (nx_ip_raw_packet_receive) |
|
IP Raw Packet Send (nx_ip_raw_packet_send) |
|
IP Static Route Add (nx_ip_static_route_add) |
|
IP Static Route Delete (nx_ip_static_route_delete) |
|
IP Status Check (nx_ip_status_check) |
|
IPSEC Enable (nx_ipsec_enable) |
|
Packet Allocate (nx_packet_allocate) |
|
Packet Copy (nx_packet_copy) |
|
Packet Data Append (nx_packet_data_append) |
|
Packet Data Extract Offset (nx_packet_data_extract_offset) |
|
Packet Data Retrieve (nx_packet_data_retrieve) |
|
Packet Length Get (nx_packet_length_get) |
|
Packet Pool Create (nx_packet_pool_create) |
|
Packet Pool Delete (nx_packet_pool_delete) |
|
Packet Pool Information Get (nx_packet_pool_info_get) |
|
Packet Release (nx_packet_release) |
|
Packet Transmit Release (nx_packet_transmit_release) |
|
RARP Disable (nx_rarp_disable) |
|
RARP Enable (nx_rarp_enable) |
|
RARP Information Get (nx_rarp_info_get) |
|
System Initialize (nx_system_initialize) |
|
TCP Client Socket Bind (nx_tcp_client_socket_bind) |
|
TCP Client Socket Connect (nx_tcp_client_socket_connect) |
|
TCP Client Socket Port Get (nx_tcp_client_socket_port_get) |
|
TCP Client Socket Unbind (nx_tcp_client_socket_unbind) |
|
TCP Enable (nx_tcp_enable) |
|
TCP Free Port Find (nx_tcp_free_port_find) |
|
TCP Information Get (nx_tcp_info_get) |
|
TCP Server Socket Accept (nx_tcp_server_socket_accept) |
|
TCP Server Socket Listen (nx_tcp_server_socket_listen) |
|
TCP Server Socket Relisten (nx_tcp_server_socket_relisten) |
|
TCP Server Socket Unaccept (nx_tcp_server_socket_unaccept) |
|
TCP Server Socket Unlisten (nx_tcp_server_socket_unlisten) |
|
TCP Socket Bytes Available (nx_tcp_socket_bytes_available) |
|
TCP Socket Create (nx_tcp_socket_create) |
|
TCP Socket Delete (nx_tcp_socket_delete) |
|
TCP Socket Disconnect (nx_tcp_socket_disconnect) |
|
TCP Socket Information Get (nx_tcp_socket_info_get) |
|
TCP Socket MSS Get (nx_tcp_socket_mss_get) |
|
TCP Socket MSS Peer Get (nx_tcp_socket_mss_peer_get) |
|
TCP Socket MSS Set (nx_tcp_socket_mss_set) |
|
TCP Socket Peer Info Get (nx_tcp_socket_peer_info_get) |
|
TCP Socket Receive (nx_tcp_socket_receive) |
|
TCP Socket Receive Notify (nx_tcp_socket_receive_notify) |
|
TCP Socket Send (nx_tcp_socket_send) |
|
TCP Socket State Wait (nx_tcp_socket_state_wait) |
|
TCP Socket Transmit Configure (nx_tcp_socket_transmit_configure) |
|
TCP Socket Window Update Notify Set (nx_tcp_socket_window_update_notify_set) |
|
UDP Enable (nx_udp_enable) |
|
UDP Free Port Find (nx_udp_free_port_find) |
|
UDP Information Get (nx_udp_info_get) |
|
UDP Socket Bind (nx_udp_socket_bind) |
|
UDP Socket Bytes Available (nx_udp_socket_bytes_available) |
|
UDP Socket Checksum Disable (nx_udp_socket_checksum_disable) |
|
UDP Socket Checksum Enable (nx_udp_socket_checksum_enable) |
|
UDP Socket Create (nx_udp_socket_create) |
|
UDP Socket Delete (nx_udp_socket_delete) |
|
UDP Socket Information Get (nx_udp_socket_info_get) |
|
UDP Socket Interface Set (nx_udp_socket_interface_set) |
|
UDP Socket Port Get (nx_udp_socket_port_get) |
|
UDP Socket Receive (nx_udp_socket_receive) |
|
UDP Socket Receive Notify (nx_udp_socket_receive_notify) |
|
UDP Socket Send (nx_udp_socket_send) |
|
UDP Socket Unbind (nx_udp_socket_unbind) |
|
UDP Source Extract (nx_udp_source_extract) |
The following pages describe the NetX Duo Trace Events.
Description
This event represents finding an IP address associated with the supplied physical address via nx_arp_ip_address_find.
Information Fields
-
Info Field 1: Pointer to the IP instance
-
Info Field 2: IP address
-
Info Field 3: Physical address (MSW)
-
Info Field 4: Physical address (LSW)
Description
This event represents deleting a static ARP entry via nx_arp_static_entry_delete.
Information Fields
-
Info Field 1: Pointer to the IP instance
-
Info Field 2: IP address
-
Info Field 3: Physical address (MSW)
-
Info Field 4: Physical address (LSW)
Description
This event represents deleting an entry in the neighbor cache table via nx_udp_socket_create.
Information Fields
-
Info Field 1: Fourth (least significant) word of the IPv6 link local address to delete
-
Info Field 2: Not used
-
Info Field 3: Not used
-
Info Field 4: Not used
Description
This event represents creating a cache entry and adding to the neighbor cache table via nxd_nd_cache_entry_set.
Information Fields
-
Info Field 1: Fourth (least significant) word of the IPv6 address to add
-
Info Field 2: Physical address msb
-
Info Field 3: Physical address lsb
-
Info Field 4: Not used
Description
This event represents retrieving an IP address matching the supplied physical address from the cache table via nxd_nd_cache_ip_address_find.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Fourth (least significant) word of the IPv6 address
-
Info Field 3: Physical address msb
-
Info Field 4: Physical address lsb
Description
This event represents sending a raw IP packet out the specified network interface to the supplied IP destination addressvia nxd_ip_raw_packet_send.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to packet to send
-
Info Field 3: Pointer to destination address
-
Info Field 4: Packet protocol
Description
This event represents adding a default router to the IP instance’s IPv6 routing table via nxd_ipv6_default_router_add.
Information Fields
-
Info Field 1: Pointer to IP instance.
-
Info Field 2: Destination Network address.
-
Info Field 3: Life time information.
-
Info Field 4: Not used.
Description
This event represents removing a default router from the IP instance’s IPv6 routing table via nxd_ipv6_default_router_delete.
Information Fields
-
Info Field 1: Pointer to IP instance.
-
Info Field 2: Fourth word (least significant) of the default router IPv6 address.
-
Info Field 3: Not used.
-
Info Field 4: Not used.
Description
This event represents retrieving the global (primary) IP address on the IP instance located at index 1 in the IP instance interface table via nxd_ipv6_global_address_get.
Information Fields
-
Info Field 1: Pointer to IP instance.
-
Info Field 2: Fourth word (least significant) of the global address
-
Info Field 3: IPv6 address prefix length.
-
Info Field 4: Index into IP interface table (1).
Description
This event represents setting the global (primary) IP address on the IP instance located at index 1 in the IP instance interface table via nxd_ipv6_global_address_set.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Fourth word (least significant) of the global address
-
Info Field 3: IPv6 address prefix length
-
Info Field 4: Index into IP interface table (1)
Description
This event represents the start of the Duplicate Address Detection (DAD) process when the IP instance is assigned a link local or an IP interface address via nxd_ipv6_initiate_dad_process.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Not used
-
Info Field 3: Not used
-
Info Field 4: Not used
Description
This event represents retrieving the IP address and prefix at the specified index into the IP instance interface address table via nxd_ipv6_interface_address_get.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Fourth word (least significant) of the IPv6 address to return
-
Info Field 4: Index of interface into the IP instance interface table
Description
This event represents setting the IP address and prefix at the specified index into the IP instance interface address table. Not permitted on index zero (link local address) via nxd_ipv6_interface_address_set.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Fourth word (least significant) of the IPv6 address to return
-
Info Field 3: Prefix length
-
Info Field 4: Index of interface into the IP instance interface table
Description
This event represents retrieving the link local address of the specified IP instance via nxd_ipv6_linklocal_address_get.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Fourth word (least significant) of the IP v6 link local address
-
Info Field 3: Not used
-
Info Field 4: Not used
Description
This event represents setting the link local address of the IP instance via nxd_ipv6_linklocal_address_set.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Fourth (least significant) word of the IPv6 link local address
-
Info Field 3: Not used
-
Info Field 4: Not used
Description
This event represents sending a raw IP packet through the primary IP interface to the specified destination via nxd_ip_raw_packet_send.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to packet to send
-
Info Field 3: Destination IP address
-
Info Field 4: Not used
Description
This event extracts the sender data from a received TCP packet on the specified socket. It returns the IP address and port of the sender.
Information Fields
-
Info Field 1: Socket pointer
-
Info Field 2: Peer IP address
-
Info Field 3: Peer port
-
Info Field 4: The lease significant 32-bit of the IP address
Description
This event represents setting the outgoing socket interface after a client connects with a TCP server on the specified server IP address via nxd_tcp_client_socket_connect.
Information Fields
-
Info Field 1: Pointer to TCP Socket
-
Info Field 2: Interface ID
-
Info Field 3: Not used
-
Info Field 4: Not used
Description
This event represents sending a UDP packet through the specified socket with the input IP address and port via nxd_udp_socket_send.
Information Fields
-
Info Field 1: Pointer UDP Socket
-
Info Field 2: Pointer to UDP packet
-
Info Field 3: Packet length
-
Info Field 4: Not used
Description
This event represents setting the specified UDP socket outgoing interface to the interface corresponding to the input interface ID via nxd_udp_socket_set_interface.
Information Fields
-
Info Field 1: Pointer to UDP Socket
-
Info Field 2: Interface ID
-
Info Field 3: Not used
-
Info Field 4: Not used
Description
This event represents extracting the IP address and source port of a received packet (either IPv4 or IPv6). If IPv6, the fourth word (least significant) of the IP address is returned via nxd_udp_source_extract.
Information Fields
-
Info Field 1: Pointer to the packet
-
Info Field 2: IP version
-
Info Field 3: Source IP address (IPv4 or IPv6)
-
Info Field 4: Source port
Description
This event represents registering for IP change notification via nx_ip_address_change_notify.
Information Fields
-
Info Field 1: Pointer to the IP instance
-
Info Field 2: Callback function pointer
-
Info Field 3: Additional information pointer
-
Info Field 4: Not used
Description
This event represents a secondary network interface being attached to the IP instance via nx_ip_interface_attach.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Interface IP Address
-
Info Field 3: Index into IP interface table
-
Info Field 4: Not used
Description
This event represents information retrieved from the specified network interface via nx_ip_interface_info_get.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Interface IP address
-
Info Field 3: Interface MAC address msb
-
Info Field 4: Interface MAC address lsb
Description
This event represents packet data that is extracted into a supplied buffer from a packet via nx_udp_source_extract_offset.
Information Fields
-
Info Field 1: Pointer to packet
-
Info Field 2: Size of specified buffer
-
Info Field 3: Number of bytes copied
-
Info Field 4: Not used
Description
This event represents deleting a packet pool via nx_packet_pool_delete.
Information Fields
-
Info Field 1: Pointer to the packet pool
-
Info Field 2: Not used
-
Info Field 3: Not used
-
Info Field 4: Not used
Description
This event represents retrieving TCP information for the specified IP instance via nx_tcp_info_get.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Number of bytes sent
-
Info Field 3: Number of bytes received
-
Info Field 4: Number of invalid packets
Description
This event represents setting up the server socket after an active connection request was received via nx_tcp_server_socket_accept.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to socket
-
Info Field 3: Wait option
-
Info Field 4: Socket state
Description
This event represents register a listen request and a server socket for the specified TCP port via nx_tcp_server_socket_listen.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: TCP port number
-
Info Field 3: Pointer to socket
-
Info Field 4: Maximum number of connections that can be queued
Description
This event represents register another server socket for an existing listen request on the specified TCP port via nx_tcp_server_socket_relisten.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: TCP port number
-
Info Field 3: Pointer to socket
-
Info Field 4: Socket state
Description
This event represents removing the server socket from association with the port receiving an earlier passive connection via nx_tcp_server_socket_unaccept.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to socket
-
Info Field 3: Socket state
-
Info Field 4: Not used
Description
This event represents the number of bytes currently available on the specified TCP receiving socket via nx_tcp_socket_bytes_available.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to TCP socket
-
Info Field 3: Bytes received on the socket
-
Info Field 4: Not used
Description
This event represents getting information about a socket via nx_tcp_socket_info_get.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to socket
-
Info Field 3: Bytes sent through this socket
-
Info Field 4: Bytes received through this socket
Description
This event represents information retrieved from the TCP socket regarding the peer (e.g. >connecting host) IP address and port via nx_tcp_socket_peer_info_get.
Information Fields
-
Info Field 1: Pointer to TCP socket
-
Info Field 2: Peer IP address
-
Info Field 3: Peer port number
-
Info Field 4: Not used
Description
This event represents registering a receive notify callback for a socket via nx_tcp_socket_receive_notify.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to socket
-
Info Field 3: Pointer to receive notify callback Info Field 4: Not used
Description
This event represents waiting for a socket to enter a particular state via nx_tcp_socket_state_wait.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to socket
-
Info Field 3: Desired socket state
-
Info Field 4: Previous socket state
Description
This event represents configuring the transmit options for a socket via nx_tcp_socket_transmit_configure.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to socket
-
Info Field 3: Transmit queue depth
-
Info Field 4: Timeout value
Description
This event represents a TCP socket receiving notification of an increase in the remote host receive window via nx_tcp_window_update_notify_set.
Information Fields
-
Info Field 1: Pointer to TCP socket
-
Info Field 2: Not used
-
Info Field 3: Not used
-
Info Field 4: Not used
Description
This event represents the current number of bytes received on the UDP socket via nx_udp_socket_bytes_available.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to socket
-
Info Field 3: Bytes received on socket
-
Info Field 4: Not used
Description
This event represents getting information about a UDP socket via nx_udp_socket_info_get.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to socket
-
Info Field 3: Bytes sent through socket
-
Info Field 4: Bytes received through socket
Description
This event represents setting the outgoing interface of the specified UDP socket with the specified interface via nx_udp_socket_interface_set.
Information Fields
-
Info Field 1: Pointer to UDP socket
-
Info Field 2: Index corresponding to the interface for the socket
-
Info Field 3: Not used
-
Info Field 4: Not used
This event represents registering a receive notify callback via nx_udp_socket_receive_notify.
Information Fields
-
Info Field 1: Pointer to IP instance
-
Info Field 2: Pointer to socket
-
Info Field 3: Pointer to receive notify function Info Field 4: Not used