1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
/***************************************************************************
* Copyright (c) 2024 Microsoft Corporation
* Copyright (c) 2025-present Eclipse ThreadX Contributors
*
* This program and the accompanying materials are made available under the
* terms of the MIT License which is available at
* https://opensource.org/licenses/MIT.
*
* SPDX-License-Identifier: MIT
**************************************************************************/
/**************************************************************************/
/**************************************************************************/
/** */
/** NetX Component */
/** */
/** Internet Control Message Protocol (ICMP) */
/** */
/**************************************************************************/
/**************************************************************************/
#define NX_SOURCE_CODE
/* Include necessary system files. */
#include "nx_api.h"
#include "nx_icmpv6.h"
#ifdef FEATURE_NX_IPV6
/**************************************************************************/
/* */
/* FUNCTION RELEASE */
/* */
/* _nx_icmp_ping6 PORTABLE C */
/* 6.4.3 */
/* AUTHOR */
/* */
/* Yuxin Zhou, Microsoft Corporation */
/* */
/* DESCRIPTION */
/* */
/* This function builds an ICMPv6 ping request packet and calls the */
/* associated driver to send it out on the network. The function will */
/* then suspend for the specified time waiting for the ICMP ping */
/* response. */
/* */
/* Note that for multicast or link local destination addresses, NetX */
/* Duo will default to the primary interface. To specify a non primary*/
/* interface to send pings out on with these address destination */
/* address types, use the nx_icmp_interface_ping6 service. */
/* */
/* INPUT */
/* */
/* ip_ptr Pointer to IP instance */
/* ip_address IPv6 address to ping */
/* data_ptr Pointer to user data to */
/* include in ping packet */
/* data_size Size of user data */
/* response_ptr Pointer to response packet */
/* wait_option Time out on packet allocate */
/* and sending packet */
/* */
/* OUTPUT */
/* */
/* status Actual completion status */
/* */
/* CALLS */
/* */
/* _nxd_ipv6_interface_find Finds outgoing interface */
/* _nx_icmp_interface_ping6 Handle details of sending pings*/
/* */
/* CALLED BY */
/* */
/* Application Code */
/* */
/**************************************************************************/
UINT _nx_icmp_ping6(NX_IP *ip_ptr, NXD_ADDRESS *ip_address, CHAR *data_ptr, ULONG data_size,
NX_PACKET **response_ptr, ULONG wait_option)
{
UINT status;
NXD_IPV6_ADDRESS *outgoing_address;
/* Clear the destination pointer. */
*response_ptr = NX_NULL;
/* Find a suitable outgoing interface. */
status = _nxd_ipv6_interface_find(ip_ptr, ip_address -> nxd_ip_address.v6,
&outgoing_address, NX_NULL);
/* Cannot find usable outgoing interface. */
if (status != NX_SUCCESS)
{
return(status);
}
/* Now send the actual ping packet. */
/*lint -e{644} suppress variable might not be initialized, since "outgoing_address" was initialized in _nxd_ipv6_interface_find. */
status = _nx_icmp_interface_ping6(ip_ptr, ip_address, data_ptr, data_size, outgoing_address, response_ptr, wait_option);
return(status);
}
#endif /* FEATURE_NX_IPV6 */
|
