1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun * Fundamental constants relating to IP Protocol
3*4882a593Smuzhiyun *
4*4882a593Smuzhiyun * Copyright (C) 2020, Broadcom.
5*4882a593Smuzhiyun *
6*4882a593Smuzhiyun * Unless you and Broadcom execute a separate written software license
7*4882a593Smuzhiyun * agreement governing use of this software, this software is licensed to you
8*4882a593Smuzhiyun * under the terms of the GNU General Public License version 2 (the "GPL"),
9*4882a593Smuzhiyun * available at http://www.broadcom.com/licenses/GPLv2.php, with the
10*4882a593Smuzhiyun * following added to such license:
11*4882a593Smuzhiyun *
12*4882a593Smuzhiyun * As a special exception, the copyright holders of this software give you
13*4882a593Smuzhiyun * permission to link this software with independent modules, and to copy and
14*4882a593Smuzhiyun * distribute the resulting executable under terms of your choice, provided that
15*4882a593Smuzhiyun * you also meet, for each linked independent module, the terms and conditions of
16*4882a593Smuzhiyun * the license of that module. An independent module is a module which is not
17*4882a593Smuzhiyun * derived from this software. The special exception does not apply to any
18*4882a593Smuzhiyun * modifications of the software.
19*4882a593Smuzhiyun *
20*4882a593Smuzhiyun *
21*4882a593Smuzhiyun * <<Broadcom-WL-IPTag/Dual:>>
22*4882a593Smuzhiyun */
23*4882a593Smuzhiyun
24*4882a593Smuzhiyun #ifndef _bcmip_h_
25*4882a593Smuzhiyun #define _bcmip_h_
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun #ifndef _TYPEDEFS_H_
28*4882a593Smuzhiyun #include <typedefs.h>
29*4882a593Smuzhiyun #endif
30*4882a593Smuzhiyun
31*4882a593Smuzhiyun /* This marks the start of a packed structure section. */
32*4882a593Smuzhiyun #include <packed_section_start.h>
33*4882a593Smuzhiyun
34*4882a593Smuzhiyun /* IPV4 and IPV6 common */
35*4882a593Smuzhiyun #define IP_VER_OFFSET 0x0 /* offset to version field */
36*4882a593Smuzhiyun #define IP_VER_MASK 0xf0 /* version mask */
37*4882a593Smuzhiyun #define IP_VER_SHIFT 4 /* version shift */
38*4882a593Smuzhiyun #define IP_VER_4 4 /* version number for IPV4 */
39*4882a593Smuzhiyun #define IP_VER_6 6 /* version number for IPV6 */
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun #define IP_VER(ip_body) \
42*4882a593Smuzhiyun ((((uint8 *)(ip_body))[IP_VER_OFFSET] & IP_VER_MASK) >> IP_VER_SHIFT)
43*4882a593Smuzhiyun
44*4882a593Smuzhiyun #define IP_PROT_ICMP 0x1 /* ICMP protocol */
45*4882a593Smuzhiyun #define IP_PROT_IGMP 0x2 /* IGMP protocol */
46*4882a593Smuzhiyun #define IP_PROT_TCP 0x6 /* TCP protocol */
47*4882a593Smuzhiyun #define IP_PROT_UDP 0x11 /* UDP protocol type */
48*4882a593Smuzhiyun #define IP_PROT_GRE 0x2f /* GRE protocol type */
49*4882a593Smuzhiyun #define IP_PROT_ICMP6 0x3a /* ICMPv6 protocol type */
50*4882a593Smuzhiyun
51*4882a593Smuzhiyun /* IPV4 field offsets */
52*4882a593Smuzhiyun #define IPV4_VER_HL_OFFSET 0 /* version and ihl byte offset */
53*4882a593Smuzhiyun #define IPV4_TOS_OFFSET 1 /* type of service offset */
54*4882a593Smuzhiyun #define IPV4_PKTLEN_OFFSET 2 /* packet length offset */
55*4882a593Smuzhiyun #define IPV4_PKTFLAG_OFFSET 6 /* more-frag,dont-frag flag offset */
56*4882a593Smuzhiyun #define IPV4_PROT_OFFSET 9 /* protocol type offset */
57*4882a593Smuzhiyun #define IPV4_CHKSUM_OFFSET 10 /* IP header checksum offset */
58*4882a593Smuzhiyun #define IPV4_SRC_IP_OFFSET 12 /* src IP addr offset */
59*4882a593Smuzhiyun #define IPV4_DEST_IP_OFFSET 16 /* dest IP addr offset */
60*4882a593Smuzhiyun #define IPV4_OPTIONS_OFFSET 20 /* IP options offset */
61*4882a593Smuzhiyun #define IPV4_MIN_HEADER_LEN 20 /* Minimum size for an IP header (no options) */
62*4882a593Smuzhiyun
63*4882a593Smuzhiyun /* IPV4 field decodes */
64*4882a593Smuzhiyun #define IPV4_VER_MASK 0xf0 /* IPV4 version mask */
65*4882a593Smuzhiyun #define IPV4_VER_SHIFT 4 /* IPV4 version shift */
66*4882a593Smuzhiyun
67*4882a593Smuzhiyun #define IPV4_HLEN_MASK 0x0f /* IPV4 header length mask */
68*4882a593Smuzhiyun #define IPV4_HLEN(ipv4_body) (4 * (((uint8 *)(ipv4_body))[IPV4_VER_HL_OFFSET] & IPV4_HLEN_MASK))
69*4882a593Smuzhiyun
70*4882a593Smuzhiyun #define IPV4_HLEN_MIN (4 * 5) /* IPV4 header minimum length */
71*4882a593Smuzhiyun
72*4882a593Smuzhiyun #define IPV4_ADDR_LEN 4 /* IPV4 address length */
73*4882a593Smuzhiyun
74*4882a593Smuzhiyun #define IPV4_ADDR_NULL(a) ((((uint8 *)(a))[0] | ((uint8 *)(a))[1] | \
75*4882a593Smuzhiyun ((uint8 *)(a))[2] | ((uint8 *)(a))[3]) == 0)
76*4882a593Smuzhiyun
77*4882a593Smuzhiyun #define IPV4_ADDR_BCAST(a) ((((uint8 *)(a))[0] & ((uint8 *)(a))[1] & \
78*4882a593Smuzhiyun ((uint8 *)(a))[2] & ((uint8 *)(a))[3]) == 0xff)
79*4882a593Smuzhiyun
80*4882a593Smuzhiyun #define IPV4_TOS_DSCP_MASK 0xfc /* DiffServ codepoint mask */
81*4882a593Smuzhiyun #define IPV4_TOS_DSCP_SHIFT 2 /* DiffServ codepoint shift */
82*4882a593Smuzhiyun
83*4882a593Smuzhiyun #define IPV4_TOS(ipv4_body) (((uint8 *)(ipv4_body))[IPV4_TOS_OFFSET])
84*4882a593Smuzhiyun
85*4882a593Smuzhiyun #define IPV4_TOS_PREC_MASK 0xe0 /* Historical precedence mask */
86*4882a593Smuzhiyun #define IPV4_TOS_PREC_SHIFT 5 /* Historical precedence shift */
87*4882a593Smuzhiyun
88*4882a593Smuzhiyun #define IPV4_TOS_LOWDELAY 0x10 /* Lowest delay requested */
89*4882a593Smuzhiyun #define IPV4_TOS_THROUGHPUT 0x8 /* Best throughput requested */
90*4882a593Smuzhiyun #define IPV4_TOS_RELIABILITY 0x4 /* Most reliable delivery requested */
91*4882a593Smuzhiyun
92*4882a593Smuzhiyun #define IPV4_TOS_ROUTINE 0
93*4882a593Smuzhiyun #define IPV4_TOS_PRIORITY 1
94*4882a593Smuzhiyun #define IPV4_TOS_IMMEDIATE 2
95*4882a593Smuzhiyun #define IPV4_TOS_FLASH 3
96*4882a593Smuzhiyun #define IPV4_TOS_FLASHOVERRIDE 4
97*4882a593Smuzhiyun #define IPV4_TOS_CRITICAL 5
98*4882a593Smuzhiyun #define IPV4_TOS_INETWORK_CTRL 6
99*4882a593Smuzhiyun #define IPV4_TOS_NETWORK_CTRL 7
100*4882a593Smuzhiyun
101*4882a593Smuzhiyun #define IPV4_PROT(ipv4_body) (((uint8 *)(ipv4_body))[IPV4_PROT_OFFSET])
102*4882a593Smuzhiyun
103*4882a593Smuzhiyun #define IPV4_FRAG_RESV 0x8000 /* Reserved */
104*4882a593Smuzhiyun #define IPV4_FRAG_DONT 0x4000 /* Don't fragment */
105*4882a593Smuzhiyun #define IPV4_FRAG_MORE 0x2000 /* More fragments */
106*4882a593Smuzhiyun #define IPV4_FRAG_OFFSET_MASK 0x1fff /* Fragment offset */
107*4882a593Smuzhiyun
108*4882a593Smuzhiyun #define IPV4_ADDR_STR_LEN 16 /* Max IP address length in string format */
109*4882a593Smuzhiyun
110*4882a593Smuzhiyun /* IPV4 packet formats */
111*4882a593Smuzhiyun BWL_PRE_PACKED_STRUCT struct ipv4_addr {
112*4882a593Smuzhiyun uint8 addr[IPV4_ADDR_LEN];
113*4882a593Smuzhiyun } BWL_POST_PACKED_STRUCT;
114*4882a593Smuzhiyun
115*4882a593Smuzhiyun BWL_PRE_PACKED_STRUCT struct ipv4_hdr {
116*4882a593Smuzhiyun uint8 version_ihl; /* Version and Internet Header Length */
117*4882a593Smuzhiyun uint8 tos; /* Type Of Service */
118*4882a593Smuzhiyun uint16 tot_len; /* Number of bytes in packet (max 65535) */
119*4882a593Smuzhiyun uint16 id;
120*4882a593Smuzhiyun uint16 frag; /* 3 flag bits and fragment offset */
121*4882a593Smuzhiyun uint8 ttl; /* Time To Live */
122*4882a593Smuzhiyun uint8 prot; /* Protocol */
123*4882a593Smuzhiyun uint16 hdr_chksum; /* IP header checksum */
124*4882a593Smuzhiyun uint8 src_ip[IPV4_ADDR_LEN]; /* Source IP Address */
125*4882a593Smuzhiyun uint8 dst_ip[IPV4_ADDR_LEN]; /* Destination IP Address */
126*4882a593Smuzhiyun } BWL_POST_PACKED_STRUCT;
127*4882a593Smuzhiyun
128*4882a593Smuzhiyun /* IPV6 field offsets */
129*4882a593Smuzhiyun #define IPV6_PAYLOAD_LEN_OFFSET 4 /* payload length offset */
130*4882a593Smuzhiyun #define IPV6_NEXT_HDR_OFFSET 6 /* next header/protocol offset */
131*4882a593Smuzhiyun #define IPV6_HOP_LIMIT_OFFSET 7 /* hop limit offset */
132*4882a593Smuzhiyun #define IPV6_SRC_IP_OFFSET 8 /* src IP addr offset */
133*4882a593Smuzhiyun #define IPV6_DEST_IP_OFFSET 24 /* dst IP addr offset */
134*4882a593Smuzhiyun
135*4882a593Smuzhiyun /* IPV6 field decodes */
136*4882a593Smuzhiyun #define IPV6_TRAFFIC_CLASS(ipv6_body) \
137*4882a593Smuzhiyun (((((uint8 *)(ipv6_body))[0] & 0x0f) << 4) | \
138*4882a593Smuzhiyun ((((uint8 *)(ipv6_body))[1] & 0xf0) >> 4))
139*4882a593Smuzhiyun
140*4882a593Smuzhiyun #define IPV6_FLOW_LABEL(ipv6_body) \
141*4882a593Smuzhiyun (((((uint8 *)(ipv6_body))[1] & 0x0f) << 16) | \
142*4882a593Smuzhiyun (((uint8 *)(ipv6_body))[2] << 8) | \
143*4882a593Smuzhiyun (((uint8 *)(ipv6_body))[3]))
144*4882a593Smuzhiyun
145*4882a593Smuzhiyun #define IPV6_PAYLOAD_LEN(ipv6_body) \
146*4882a593Smuzhiyun ((((uint8 *)(ipv6_body))[IPV6_PAYLOAD_LEN_OFFSET + 0] << 8) | \
147*4882a593Smuzhiyun ((uint8 *)(ipv6_body))[IPV6_PAYLOAD_LEN_OFFSET + 1])
148*4882a593Smuzhiyun
149*4882a593Smuzhiyun #define IPV6_NEXT_HDR(ipv6_body) \
150*4882a593Smuzhiyun (((uint8 *)(ipv6_body))[IPV6_NEXT_HDR_OFFSET])
151*4882a593Smuzhiyun
152*4882a593Smuzhiyun #define IPV6_PROT(ipv6_body) IPV6_NEXT_HDR(ipv6_body)
153*4882a593Smuzhiyun
154*4882a593Smuzhiyun #define IPV6_ADDR_LEN 16 /* IPV6 address length */
155*4882a593Smuzhiyun
156*4882a593Smuzhiyun /* IPV4 TOS or IPV6 Traffic Classifier or 0 */
157*4882a593Smuzhiyun #define IP_TOS46(ip_body) \
158*4882a593Smuzhiyun (IP_VER(ip_body) == IP_VER_4 ? IPV4_TOS(ip_body) : \
159*4882a593Smuzhiyun IP_VER(ip_body) == IP_VER_6 ? IPV6_TRAFFIC_CLASS(ip_body) : 0)
160*4882a593Smuzhiyun
161*4882a593Smuzhiyun #define IP_DSCP46(ip_body) (IP_TOS46(ip_body) >> IPV4_TOS_DSCP_SHIFT);
162*4882a593Smuzhiyun
163*4882a593Smuzhiyun /* IPV4 or IPV6 Protocol Classifier or 0 */
164*4882a593Smuzhiyun #define IP_PROT46(ip_body) \
165*4882a593Smuzhiyun (IP_VER(ip_body) == IP_VER_4 ? IPV4_PROT(ip_body) : \
166*4882a593Smuzhiyun IP_VER(ip_body) == IP_VER_6 ? IPV6_PROT(ip_body) : 0)
167*4882a593Smuzhiyun
168*4882a593Smuzhiyun /* IPV6 extension headers (options) */
169*4882a593Smuzhiyun #define IPV6_EXTHDR_HOP 0
170*4882a593Smuzhiyun #define IPV6_EXTHDR_ROUTING 43
171*4882a593Smuzhiyun #define IPV6_EXTHDR_FRAGMENT 44
172*4882a593Smuzhiyun #define IPV6_EXTHDR_AUTH 51
173*4882a593Smuzhiyun #define IPV6_EXTHDR_NONE 59
174*4882a593Smuzhiyun #define IPV6_EXTHDR_DEST 60
175*4882a593Smuzhiyun
176*4882a593Smuzhiyun #define IPV6_EXTHDR(prot) (((prot) == IPV6_EXTHDR_HOP) || \
177*4882a593Smuzhiyun ((prot) == IPV6_EXTHDR_ROUTING) || \
178*4882a593Smuzhiyun ((prot) == IPV6_EXTHDR_FRAGMENT) || \
179*4882a593Smuzhiyun ((prot) == IPV6_EXTHDR_AUTH) || \
180*4882a593Smuzhiyun ((prot) == IPV6_EXTHDR_NONE) || \
181*4882a593Smuzhiyun ((prot) == IPV6_EXTHDR_DEST))
182*4882a593Smuzhiyun
183*4882a593Smuzhiyun #define IPV6_MIN_HLEN 40
184*4882a593Smuzhiyun
185*4882a593Smuzhiyun #define IPV6_EXTHDR_LEN(eh) ((((struct ipv6_exthdr *)(eh))->hdrlen + 1) << 3)
186*4882a593Smuzhiyun
187*4882a593Smuzhiyun BWL_PRE_PACKED_STRUCT struct ipv6_exthdr {
188*4882a593Smuzhiyun uint8 nexthdr;
189*4882a593Smuzhiyun uint8 hdrlen;
190*4882a593Smuzhiyun } BWL_POST_PACKED_STRUCT;
191*4882a593Smuzhiyun
192*4882a593Smuzhiyun BWL_PRE_PACKED_STRUCT struct ipv6_exthdr_frag {
193*4882a593Smuzhiyun uint8 nexthdr;
194*4882a593Smuzhiyun uint8 rsvd;
195*4882a593Smuzhiyun uint16 frag_off;
196*4882a593Smuzhiyun uint32 ident;
197*4882a593Smuzhiyun } BWL_POST_PACKED_STRUCT;
198*4882a593Smuzhiyun
199*4882a593Smuzhiyun /* deprecated and replaced by ipv6_exthdr_len_check */
200*4882a593Smuzhiyun static INLINE int32
ipv6_exthdr_len(uint8 * h,uint8 * proto)201*4882a593Smuzhiyun ipv6_exthdr_len(uint8 *h, uint8 *proto)
202*4882a593Smuzhiyun {
203*4882a593Smuzhiyun uint16 len = 0, hlen;
204*4882a593Smuzhiyun struct ipv6_exthdr *eh = (struct ipv6_exthdr *)h;
205*4882a593Smuzhiyun
206*4882a593Smuzhiyun while (IPV6_EXTHDR(eh->nexthdr)) {
207*4882a593Smuzhiyun if (eh->nexthdr == IPV6_EXTHDR_NONE)
208*4882a593Smuzhiyun return -1;
209*4882a593Smuzhiyun else if (eh->nexthdr == IPV6_EXTHDR_FRAGMENT)
210*4882a593Smuzhiyun hlen = 8U;
211*4882a593Smuzhiyun else if (eh->nexthdr == IPV6_EXTHDR_AUTH)
212*4882a593Smuzhiyun hlen = (uint16)((eh->hdrlen + 2U) << 2U);
213*4882a593Smuzhiyun else
214*4882a593Smuzhiyun hlen = (uint16)IPV6_EXTHDR_LEN(eh);
215*4882a593Smuzhiyun
216*4882a593Smuzhiyun len += hlen;
217*4882a593Smuzhiyun eh = (struct ipv6_exthdr *)(h + len);
218*4882a593Smuzhiyun }
219*4882a593Smuzhiyun
220*4882a593Smuzhiyun *proto = eh->nexthdr;
221*4882a593Smuzhiyun return len;
222*4882a593Smuzhiyun }
223*4882a593Smuzhiyun
224*4882a593Smuzhiyun /* determine length of exthdr with length checking */
225*4882a593Smuzhiyun static INLINE int32
ipv6_exthdr_len_check(uint8 * h,uint16 plen,uint8 * proto)226*4882a593Smuzhiyun ipv6_exthdr_len_check(uint8 *h, uint16 plen, uint8 *proto)
227*4882a593Smuzhiyun {
228*4882a593Smuzhiyun uint16 len = 0, hlen;
229*4882a593Smuzhiyun struct ipv6_exthdr *eh = (struct ipv6_exthdr *)h;
230*4882a593Smuzhiyun
231*4882a593Smuzhiyun /* must have at least one exthdr */
232*4882a593Smuzhiyun if (plen < sizeof(struct ipv6_exthdr)) {
233*4882a593Smuzhiyun return -1;
234*4882a593Smuzhiyun }
235*4882a593Smuzhiyun
236*4882a593Smuzhiyun /* length check before accessing next exthdr */
237*4882a593Smuzhiyun while ((plen >= len + sizeof(struct ipv6_exthdr)) && IPV6_EXTHDR(eh->nexthdr)) {
238*4882a593Smuzhiyun if (eh->nexthdr == IPV6_EXTHDR_NONE) {
239*4882a593Smuzhiyun return -1;
240*4882a593Smuzhiyun } else if (eh->nexthdr == IPV6_EXTHDR_FRAGMENT) {
241*4882a593Smuzhiyun hlen = 8U;
242*4882a593Smuzhiyun } else if (eh->nexthdr == IPV6_EXTHDR_AUTH) {
243*4882a593Smuzhiyun hlen = (uint16)((eh->hdrlen + 2U) << 2U);
244*4882a593Smuzhiyun } else {
245*4882a593Smuzhiyun hlen = (uint16)IPV6_EXTHDR_LEN(eh);
246*4882a593Smuzhiyun }
247*4882a593Smuzhiyun
248*4882a593Smuzhiyun /* check exthdr length */
249*4882a593Smuzhiyun if (plen < len + hlen) {
250*4882a593Smuzhiyun /* invalid exthdr */
251*4882a593Smuzhiyun return -1;
252*4882a593Smuzhiyun }
253*4882a593Smuzhiyun len += hlen;
254*4882a593Smuzhiyun eh = (struct ipv6_exthdr *)(h + len);
255*4882a593Smuzhiyun }
256*4882a593Smuzhiyun
257*4882a593Smuzhiyun /* length check before accessing next exthdr */
258*4882a593Smuzhiyun if (plen >= len + sizeof(struct ipv6_exthdr)) {
259*4882a593Smuzhiyun *proto = eh->nexthdr;
260*4882a593Smuzhiyun } else {
261*4882a593Smuzhiyun *proto = 0;
262*4882a593Smuzhiyun }
263*4882a593Smuzhiyun return len;
264*4882a593Smuzhiyun }
265*4882a593Smuzhiyun #define IPV4_ISMULTI(a) (((a) & 0xf0000000) == 0xe0000000)
266*4882a593Smuzhiyun
267*4882a593Smuzhiyun #define IPV4_MCAST_TO_ETHER_MCAST(ipv4, ether) \
268*4882a593Smuzhiyun { \
269*4882a593Smuzhiyun ether[0] = 0x01; \
270*4882a593Smuzhiyun ether[1] = 0x00; \
271*4882a593Smuzhiyun ether[2] = 0x5E; \
272*4882a593Smuzhiyun ether[3] = (ipv4 & 0x7f0000) >> 16; \
273*4882a593Smuzhiyun ether[4] = (ipv4 & 0xff00) >> 8; \
274*4882a593Smuzhiyun ether[5] = (ipv4 & 0xff); \
275*4882a593Smuzhiyun }
276*4882a593Smuzhiyun
277*4882a593Smuzhiyun /* This marks the end of a packed structure section. */
278*4882a593Smuzhiyun #include <packed_section_end.h>
279*4882a593Smuzhiyun
280*4882a593Smuzhiyun #define IPV4_ADDR_STR "%d.%d.%d.%d"
281*4882a593Smuzhiyun #define IPV4_ADDR_TO_STR(addr) ((uint32)addr & 0xff000000) >> 24, \
282*4882a593Smuzhiyun ((uint32)addr & 0x00ff0000) >> 16, \
283*4882a593Smuzhiyun ((uint32)addr & 0x0000ff00) >> 8, \
284*4882a593Smuzhiyun ((uint32)addr & 0x000000ff)
285*4882a593Smuzhiyun
286*4882a593Smuzhiyun #endif /* _bcmip_h_ */
287