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