Outline ![]()
Files ![]()
loading...
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
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
/**************************************************************************/
/* */
/* Copyright (c) Microsoft Corporation. All rights reserved. */
/* */
/* This software is licensed under the Microsoft Software License */
/* Terms for Microsoft Azure RTOS. Full text of the license can be */
/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
/* and in the root directory of this software. */
/* */
/**************************************************************************/
/**************************************************************************/
/**************************************************************************/
/** */
/** NetX Component */
/** */
/** Internet Group Management Protocol (IGMP) */
/** */
/**************************************************************************/
/**************************************************************************/
/**************************************************************************/
/* */
/* COMPONENT DEFINITION RELEASE */
/* */
/* nx_igmp.h PORTABLE C */
/* 6.1.9 */
/* AUTHOR */
/* */
/* Yuxin Zhou, Microsoft Corporation */
/* */
/* DESCRIPTION */
/* */
/* This file defines the NetX Internet Group Management Protocol (IGMP)*/
/* component, including all data types and external references. It is */
/* assumed that nx_api.h and nx_port.h have already been included. */
/* */
/* RELEASE HISTORY */
/* */
/* DATE NAME DESCRIPTION */
/* */
/* 05-19-2020 Yuxin Zhou Initial Version 6.0 */
/* 09-30-2020 Yuxin Zhou Modified comment(s), */
/* resulting in version 6.1 */
/* 10-15-2021 Yuxin Zhou Modified comment(s), included */
/* necessary header file, */
/* resulting in version 6.1.9 */
/* */
/**************************************************************************/
#ifndef NX_IGMP_H
#define NX_IGMP_H
#include "nx_api.h"
#ifndef NX_DISABLE_IPV4
/* Define IGMP types and codes. */
/* IGMPv2 combines version field with the type field ffectively, and calls the 8 bit
field the Type field. IGMPv2 uses Type 0x11, 0x16, and 0x17 in this field, while
IGMPv1 uses Type 1 and 2 in the lower 4 bits, combined with version 1 in the upper 4 bits
for 0x11 and 0x12 as the possible values. */
/* Define the IGMP version in the IGMP header. */
#define NX_IGMP_VERSION 0x10000000
/* Define the numeric version of IGMP protocol used by NetX. */
#define NX_IGMP_HOST_VERSION_1 1
#define NX_IGMP_HOST_VERSION_2 2
/* Define the IGMP query message type and mask in the IGMP header. */
#define NX_IGMP_ROUTER_QUERY_TYPE 0x01000000
#define NX_IGMP_TYPE_MASK 0x0F000000
/* Define the IGMPv1 type for membership join reports. */
#define NX_IGMP_HOST_RESPONSE_TYPE 0x02000000
/* Define IGMPv2 types for membership join and leave reports. */
#define NX_IGMP_HOST_V2_JOIN_TYPE 0x16000000
#define NX_IGMP_HOST_V2_LEAVE_TYPE 0x17000000
/* Define the IGMPv2 type mask in the IGMP header. */
#define NX_IGMPV2_TYPE_MASK 0xFF000000
/* Define the IGMPv2 maximum response time mask in the IGMP header. Max value is 0x64,
left intentionally blank in IGMPv1 queries and all IGMP reports. Maximum response time
is in tenth's of a second. */
#define NX_IGMP_MAX_RESP_TIME_MASK 0x00FF0000
/* For IGMPv1 only, define the IGMP maximum delay time to 10 seconds as per RFC 1112. This is achieved if
the slow NetX IP periodic thread timer executes every second (e.g. NX_IP_PERIODIC_RATE is set to 100)
and the threadx timer interrupt occurs every 10 ms). */
#define NX_IGMP_MAX_UPDATE_TIME 10
/* Define the time to live for IGMP packets. RFC 1112 and 2236 specify
time to live should be set at 1. */
#define NX_IGMP_TTL 1
/* Define the IP "all hosts" multicast address. */
#define NX_ALL_HOSTS_ADDRESS IP_ADDRESS(224, 0, 0, 1)
/* Define the IP "all routers" multicast address. */
#define NX_ALL_ROUTERS_ADDRESS IP_ADDRESS(224, 0, 0, 2)
/* Define Basic IGMP packet header data type. This will be used to
build new IGMP packets and to examine incoming IGMP queries sent
to NetX. */
typedef struct NX_IGMP_HEADER_STRUCT
{
/* Define the first 32-bit word of the IGMP header. This word contains
the following information:
bits 31-28 IGMP 4-bit version (Version 1)
bits 27-24 IGMP 4-bit type defined as follows:
Type Field IGMP Message Type
1 Router Query Request
2 Host Query Response
bits 15-0 IGMP 16-bit checksum
*/
ULONG nx_igmp_header_word_0;
/* Define the second and final word of the IGMP header. This word contains
the following information:
bits 31-0 32-bit group address (class D IP address)
*/
ULONG nx_igmp_header_word_1;
} NX_IGMP_HEADER;
/* Define the IGMP query response message size. */
#define NX_IGMP_HEADER_SIZE sizeof(NX_IGMP_HEADER)
/* Define IGMP internal function prototypes. */
UINT _nx_igmp_multicast_interface_join_internal(NX_IP *ip_ptr, ULONG group_address, UINT interface_index, UINT update_time);
UINT _nx_igmp_multicast_interface_leave_internal(NX_IP *ip_ptr, ULONG group_address, UINT interface_index);
UINT _nx_igmp_interface_report_send(NX_IP *ip_ptr, ULONG group_address, UINT interface_index, UINT is_joining);
VOID _nx_igmp_periodic_processing(NX_IP *ip_ptr);
VOID _nx_igmp_packet_process(NX_IP *ip_ptr, NX_PACKET *packet_ptr);
VOID _nx_igmp_packet_receive(NX_IP *ip_ptr, NX_PACKET *packet_ptr);
VOID _nx_igmp_queue_process(NX_IP *ip_ptr);
UINT _nx_igmp_multicast_check(NX_IP *ip_ptr, ULONG group_address, NX_INTERFACE *nx_interface);
#endif /* NX_DISABLE_IPV4 */
/* Define IGMP function prototypes. */
UINT _nx_igmp_enable(NX_IP *ip_ptr);
UINT _nx_igmp_info_get(NX_IP *ip_ptr, ULONG *igmp_reports_sent, ULONG *igmp_queries_received,
ULONG *igmp_checksum_errors, ULONG *current_groups_joined);
UINT _nx_igmp_loopback_disable(NX_IP *ip_ptr);
UINT _nx_igmp_loopback_enable(NX_IP *ip_ptr);
UINT _nx_igmp_multicast_join(NX_IP *ip_ptr, ULONG group_address);
UINT _nx_igmp_multicast_interface_join(NX_IP *ip_ptr, ULONG group_address, UINT interface_index);
UINT _nx_igmp_multicast_leave(NX_IP *ip_ptr, ULONG group_address);
UINT _nx_igmp_multicast_interface_leave(NX_IP *ip_ptr, ULONG group_address, UINT interface_index);
/* Define error checking shells for API services. These are only referenced by the
application. */
UINT _nxe_igmp_enable(NX_IP *ip_ptr);
UINT _nxe_igmp_info_get(NX_IP *ip_ptr, ULONG *igmp_reports_sent, ULONG *igmp_queries_received,
ULONG *igmp_checksum_errors, ULONG *current_groups_joined);
UINT _nxe_igmp_loopback_disable(NX_IP *ip_ptr);
UINT _nxe_igmp_loopback_enable(NX_IP *ip_ptr);
UINT _nxe_igmp_multicast_join(NX_IP *ip_ptr, ULONG group_address);
UINT _nxe_igmp_multicast_interface_join(NX_IP *ip_ptr, ULONG group_address, UINT interface_index);
UINT _nxe_igmp_multicast_leave(NX_IP *ip_ptr, ULONG group_address);
UINT _nxe_igmp_multicast_interface_leave(NX_IP *ip_ptr, ULONG group_address, UINT interface_index);
#endif
Details ![]()
Show: from Types: Columns: ![]( "Show Project Names")
![]( "Show Locations")
![]( "Show Referring Symbols")
![]( "Show Scope")
This file uses the notable symbols shown below. Click anywhere in the file to view more details.