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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
/***************************************************************************
* 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 */
/** */
/** Address Resolution Protocol (ARP) */
/** */
/**************************************************************************/
/**************************************************************************/
#define NX_SOURCE_CODE
/* Include necessary system files. */
#include "nx_api.h"
#include "nx_arp.h"
/**************************************************************************/
/* */
/* FUNCTION RELEASE */
/* */
/* _nx_arp_enable PORTABLE C */
/* 6.4.3 */
/* AUTHOR */
/* */
/* Yuxin Zhou, Microsoft Corporation */
/* */
/* DESCRIPTION */
/* */
/* This function enables the ARP management component for the */
/* specified IP instance. */
/* */
/* INPUT */
/* */
/* ip_ptr IP instance pointer */
/* arp_cache_memory Start of ARP cache memory */
/* arp_cache_size Size in bytes of cache memory */
/* memset Set the memory */
/* */
/* OUTPUT */
/* */
/* status Completion status */
/* */
/* CALLS */
/* */
/* None */
/* */
/* CALLED BY */
/* */
/* Application Code */
/* */
/**************************************************************************/
UINT _nx_arp_enable(NX_IP *ip_ptr, VOID *arp_cache_memory, ULONG arp_cache_size)
{
#ifndef NX_DISABLE_IPV4
ULONG i;
ULONG arp_entries;
NX_ARP *entry_ptr;
/* If trace is enabled, insert this event into the trace buffer. */
NX_TRACE_IN_LINE_INSERT(NX_TRACE_ARP_ENABLE, ip_ptr, arp_cache_memory, arp_cache_size, 0, NX_TRACE_ARP_EVENTS, 0, 0);
/* Clear the entire ARP cache. */
memset((void *)arp_cache_memory, 0, arp_cache_size);
/* Pickup starting address of ARP entry array. */
entry_ptr = (NX_ARP *)arp_cache_memory;
/* Determine how many ARP entries will fit in this cache area. */
arp_entries = arp_cache_size / sizeof(NX_ARP);
/* Initialize the forward pointers of available ARP entries. */
for (i = 0; i < (arp_entries - 1); i++)
{
/* Setup each entry to point to the next entry. */
entry_ptr -> nx_arp_pool_next = entry_ptr + 1;
entry_ptr++;
}
/* The entry now points to the last entry in the ARP array. Set its
next pointer to the first entry. */
entry_ptr -> nx_arp_pool_next = (NX_ARP *)arp_cache_memory;
/* Initialize the backward pointers of available ARP entries. */
for (i = 0; i < (arp_entries - 1); i++)
{
/* Setup each entry to point to the previous entry. */
entry_ptr -> nx_arp_pool_previous = entry_ptr - 1;
entry_ptr--;
}
/* The entry now points to the first entry, set the previous pointer
to the last entry. */
entry_ptr -> nx_arp_pool_previous = (entry_ptr + (arp_entries - 1));
/* At this point, everything is okay in the ARP enable call.. populate the
information in the IP structure. */
/* Setup the list head pointers in the IP instance. At first all ARP
entries are associated with the dynamic ARP list. The static ARP list
is NULL until static ARP entry calls are made. */
ip_ptr -> nx_ip_arp_static_list = NX_NULL;
ip_ptr -> nx_ip_arp_dynamic_list = (NX_ARP *)arp_cache_memory;
/* Store the initial ARP cache information in the IP control block. */
ip_ptr -> nx_ip_arp_cache_memory = arp_cache_memory;
ip_ptr -> nx_ip_arp_total_entries = arp_entries;
/* Setup the ARP periodic update routine. */
ip_ptr -> nx_ip_arp_periodic_update = _nx_arp_periodic_update;
/* Setup the ARP queue process routine. */
ip_ptr -> nx_ip_arp_queue_process = _nx_arp_queue_process;
/* Setup the ARP send packet routine. */
ip_ptr -> nx_ip_arp_packet_send = _nx_arp_packet_send;
/* Setup the ARP allocate service request pointer. */
ip_ptr -> nx_ip_arp_allocate = _nx_arp_entry_allocate;
/* Return successful completion. */
return(NX_SUCCESS);
#else /* NX_DISABLE_IPV4 */
NX_PARAMETER_NOT_USED(ip_ptr);
NX_PARAMETER_NOT_USED(arp_cache_memory);
NX_PARAMETER_NOT_USED(arp_cache_size);
return(NX_NOT_SUPPORTED);
#endif /* !NX_DISABLE_IPV4 */
}
|
