xref: /freebsd/sys/dev/ice/ice_protocol_type.h (revision 81ad6265)
1 /* SPDX-License-Identifier: BSD-3-Clause */
2 /*  Copyright (c) 2021, Intel Corporation
3  *  All rights reserved.
4  *
5  *  Redistribution and use in source and binary forms, with or without
6  *  modification, are permitted provided that the following conditions are met:
7  *
8  *   1. Redistributions of source code must retain the above copyright notice,
9  *      this list of conditions and the following disclaimer.
10  *
11  *   2. Redistributions in binary form must reproduce the above copyright
12  *      notice, this list of conditions and the following disclaimer in the
13  *      documentation and/or other materials provided with the distribution.
14  *
15  *   3. Neither the name of the Intel Corporation nor the names of its
16  *      contributors may be used to endorse or promote products derived from
17  *      this software without specific prior written permission.
18  *
19  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20  *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
23  *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  *  POSSIBILITY OF SUCH DAMAGE.
30  */
31 /*$FreeBSD$*/
32 
33 #ifndef _ICE_PROTOCOL_TYPE_H_
34 #define _ICE_PROTOCOL_TYPE_H_
35 #include "ice_flex_type.h"
36 #define ICE_IPV6_ADDR_LENGTH 16
37 
38 /* Each recipe can match up to 5 different fields. Fields to match can be meta-
39  * data, values extracted from packet headers, or results from other recipes.
40  * One of the 5 fields is reserved for matching the switch ID. So, up to 4
41  * recipes can provide intermediate results to another one through chaining,
42  * e.g. recipes 0, 1, 2, and 3 can provide intermediate results to recipe 4.
43  */
44 #define ICE_NUM_WORDS_RECIPE 4
45 
46 /* Max recipes that can be chained */
47 #define ICE_MAX_CHAIN_RECIPE 5
48 
49 /* 1 word reserved for switch ID from allowed 5 words.
50  * So a recipe can have max 4 words. And you can chain 5 such recipes
51  * together. So maximum words that can be programmed for look up is 5 * 4.
52  */
53 #define ICE_MAX_CHAIN_WORDS (ICE_NUM_WORDS_RECIPE * ICE_MAX_CHAIN_RECIPE)
54 
55 /* Field vector index corresponding to chaining */
56 #define ICE_CHAIN_FV_INDEX_START 47
57 
58 enum ice_protocol_type {
59 	ICE_MAC_OFOS = 0,
60 	ICE_MAC_IL,
61 	ICE_ETYPE_OL,
62 	ICE_VLAN_OFOS,
63 	ICE_IPV4_OFOS,
64 	ICE_IPV4_IL,
65 	ICE_IPV6_OFOS,
66 	ICE_IPV6_IL,
67 	ICE_TCP_IL,
68 	ICE_UDP_OF,
69 	ICE_UDP_ILOS,
70 	ICE_SCTP_IL,
71 	ICE_VXLAN,
72 	ICE_GENEVE,
73 	ICE_VXLAN_GPE,
74 	ICE_NVGRE,
75 	ICE_GTP,
76 	ICE_PROTOCOL_LAST
77 };
78 
79 enum ice_sw_tunnel_type {
80 	ICE_NON_TUN = 0,
81 	ICE_SW_TUN_AND_NON_TUN,
82 	ICE_SW_TUN_VXLAN_GPE,
83 	ICE_SW_TUN_GENEVE,      /* GENEVE matches only non-VLAN pkts */
84 	ICE_SW_TUN_GENEVE_VLAN, /* GENEVE matches both VLAN and non-VLAN pkts */
85 	ICE_SW_TUN_VXLAN,	/* VXLAN matches only non-VLAN pkts */
86 	ICE_SW_TUN_VXLAN_VLAN,  /* VXLAN matches both VLAN and non-VLAN pkts */
87 	ICE_SW_TUN_NVGRE,
88 	ICE_SW_TUN_UDP, /* This means all "UDP" tunnel types: VXLAN-GPE, VXLAN
89 			 * and GENEVE
90 			 */
91 	ICE_SW_TUN_IPV4_GTP_IPV4_TCP,
92 	ICE_SW_TUN_IPV4_GTP_IPV4_UDP,
93 	ICE_SW_TUN_IPV4_GTP_IPV6_TCP,
94 	ICE_SW_TUN_IPV4_GTP_IPV6_UDP,
95 	ICE_SW_TUN_IPV6_GTP_IPV4_TCP,
96 	ICE_SW_TUN_IPV6_GTP_IPV4_UDP,
97 	ICE_SW_TUN_IPV6_GTP_IPV6_TCP,
98 	ICE_SW_TUN_IPV6_GTP_IPV6_UDP,
99 
100 	/* following adds support for GTP, just using inner protocols,
101 	 * outer L3 and L4 protocols can be anything
102 	 */
103 	ICE_SW_TUN_GTP_IPV4_TCP,
104 	ICE_SW_TUN_GTP_IPV4_UDP,
105 	ICE_SW_TUN_GTP_IPV6_TCP,
106 	ICE_SW_TUN_GTP_IPV6_UDP,
107 	ICE_SW_TUN_IPV4_GTPU_IPV4,
108 	ICE_SW_TUN_IPV4_GTPU_IPV6,
109 	ICE_SW_TUN_IPV6_GTPU_IPV4,
110 	ICE_SW_TUN_IPV6_GTPU_IPV6,
111 	ICE_SW_TUN_GTP_IPV4,
112 	ICE_SW_TUN_GTP_IPV6,
113 	ICE_ALL_TUNNELS /* All tunnel types including NVGRE */
114 };
115 
116 /* Decoders for ice_prot_id:
117  * - F: First
118  * - I: Inner
119  * - L: Last
120  * - O: Outer
121  * - S: Single
122  */
123 enum ice_prot_id {
124 	ICE_PROT_ID_INVAL	= 0,
125 	ICE_PROT_MAC_OF_OR_S	= 1,
126 	ICE_PROT_MAC_O2		= 2,
127 	ICE_PROT_MAC_IL		= 4,
128 	ICE_PROT_MAC_IN_MAC	= 7,
129 	ICE_PROT_ETYPE_OL	= 9,
130 	ICE_PROT_ETYPE_IL	= 10,
131 	ICE_PROT_PAY		= 15,
132 	ICE_PROT_EVLAN_O	= 16,
133 	ICE_PROT_VLAN_O		= 17,
134 	ICE_PROT_VLAN_IF	= 18,
135 	ICE_PROT_MPLS_OL_MINUS_1 = 27,
136 	ICE_PROT_MPLS_OL_OR_OS	= 28,
137 	ICE_PROT_MPLS_IL	= 29,
138 	ICE_PROT_IPV4_OF_OR_S	= 32,
139 	ICE_PROT_IPV4_IL	= 33,
140 	ICE_PROT_IPV4_IL_IL	= 34,
141 	ICE_PROT_IPV6_OF_OR_S	= 40,
142 	ICE_PROT_IPV6_IL	= 41,
143 	ICE_PROT_IPV6_IL_IL	= 42,
144 	ICE_PROT_IPV6_FRAG	= 47,
145 	ICE_PROT_TCP_IL		= 49,
146 	ICE_PROT_UDP_OF		= 52,
147 	ICE_PROT_UDP_IL_OR_S	= 53,
148 	ICE_PROT_GRE_OF		= 64,
149 	ICE_PROT_NSH_F		= 84,
150 	ICE_PROT_ESP_F		= 88,
151 	ICE_PROT_ESP_2		= 89,
152 	ICE_PROT_SCTP_IL	= 96,
153 	ICE_PROT_ICMP_IL	= 98,
154 	ICE_PROT_ICMPV6_IL	= 100,
155 	ICE_PROT_VRRP_F		= 101,
156 	ICE_PROT_OSPF		= 102,
157 	ICE_PROT_ATAOE_OF	= 114,
158 	ICE_PROT_CTRL_OF	= 116,
159 	ICE_PROT_LLDP_OF	= 117,
160 	ICE_PROT_ARP_OF		= 118,
161 	ICE_PROT_EAPOL_OF	= 120,
162 	ICE_PROT_META_ID	= 255, /* when offset == metaddata */
163 	ICE_PROT_INVALID	= 255  /* when offset == ICE_FV_OFFSET_INVAL */
164 };
165 
166 #define ICE_VNI_OFFSET		12 /* offset of VNI from ICE_PROT_UDP_OF */
167 
168 #define ICE_MAC_OFOS_HW		1
169 #define ICE_MAC_IL_HW		4
170 #define ICE_ETYPE_OL_HW		9
171 #define ICE_VLAN_OF_HW		16
172 #define ICE_VLAN_OL_HW		17
173 #define ICE_IPV4_OFOS_HW	32
174 #define ICE_IPV4_IL_HW		33
175 #define ICE_IPV6_OFOS_HW	40
176 #define ICE_IPV6_IL_HW		41
177 #define ICE_TCP_IL_HW		49
178 #define ICE_UDP_ILOS_HW		53
179 #define ICE_SCTP_IL_HW		96
180 
181 /* ICE_UDP_OF is used to identify all 3 tunnel types
182  * VXLAN, GENEVE and VXLAN_GPE. To differentiate further
183  * need to use flags from the field vector
184  */
185 #define ICE_UDP_OF_HW	52 /* UDP Tunnels */
186 #define ICE_GRE_OF_HW	64 /* NVGRE */
187 #define ICE_META_DATA_ID_HW 255 /* this is used for tunnel type */
188 
189 #define ICE_MDID_SIZE 2
190 #define ICE_TUN_FLAG_MDID 21
191 #define ICE_TUN_FLAG_MDID_OFF (ICE_MDID_SIZE * ICE_TUN_FLAG_MDID)
192 #define ICE_TUN_FLAG_MASK 0xFF
193 #define ICE_TUN_FLAG_VLAN_MASK 0x01
194 #define ICE_TUN_FLAG_FV_IND 2
195 
196 #define ICE_PROTOCOL_MAX_ENTRIES 16
197 
198 /* Mapping of software defined protocol ID to hardware defined protocol ID */
199 struct ice_protocol_entry {
200 	enum ice_protocol_type type;
201 	u8 protocol_id;
202 };
203 
204 struct ice_ether_hdr {
205 	u8 dst_addr[ETH_ALEN];
206 	u8 src_addr[ETH_ALEN];
207 };
208 
209 struct ice_ethtype_hdr {
210 	__be16 ethtype_id;
211 };
212 
213 struct ice_ether_vlan_hdr {
214 	u8 dst_addr[ETH_ALEN];
215 	u8 src_addr[ETH_ALEN];
216 	__be32 vlan_id;
217 };
218 
219 struct ice_vlan_hdr {
220 	__be16 type;
221 	__be16 vlan;
222 };
223 
224 struct ice_ipv4_hdr {
225 	u8 version;
226 	u8 tos;
227 	__be16 total_length;
228 	__be16 id;
229 	__be16 frag_off;
230 	u8 time_to_live;
231 	u8 protocol;
232 	__be16 check;
233 	__be32 src_addr;
234 	__be32 dst_addr;
235 };
236 
237 struct ice_le_ver_tc_flow {
238 	union {
239 		struct {
240 			u32 flow_label : 20;
241 			u32 tc : 8;
242 			u32 version : 4;
243 		} fld;
244 		u32 val;
245 	} u;
246 };
247 
248 struct ice_ipv6_hdr {
249 	__be32 be_ver_tc_flow;
250 	__be16 payload_len;
251 	u8 next_hdr;
252 	u8 hop_limit;
253 	u8 src_addr[ICE_IPV6_ADDR_LENGTH];
254 	u8 dst_addr[ICE_IPV6_ADDR_LENGTH];
255 };
256 
257 struct ice_sctp_hdr {
258 	__be16 src_port;
259 	__be16 dst_port;
260 	__be32 verification_tag;
261 	__be32 check;
262 };
263 
264 struct ice_l4_hdr {
265 	__be16 src_port;
266 	__be16 dst_port;
267 	__be16 len;
268 	__be16 check;
269 };
270 
271 struct ice_udp_tnl_hdr {
272 	__be16 field;
273 	__be16 proto_type;
274 	__be32 vni;	/* only use lower 24-bits */
275 };
276 
277 struct ice_udp_gtp_hdr {
278 	u8 flags;
279 	u8 msg_type;
280 	__be16 rsrvd_len;
281 	__be32 teid;
282 	__be16 rsrvd_seq_nbr;
283 	u8 rsrvd_n_pdu_nbr;
284 	u8 rsrvd_next_ext;
285 	u8 rsvrd_ext_len;
286 	u8 pdu_type;
287 	u8 qfi;
288 	u8 rsvrd;
289 };
290 
291 struct ice_nvgre {
292 	__be16 flags;
293 	__be16 protocol;
294 	__be32 tni_flow;
295 };
296 
297 union ice_prot_hdr {
298 	struct ice_ether_hdr eth_hdr;
299 	struct ice_ethtype_hdr ethertype;
300 	struct ice_vlan_hdr vlan_hdr;
301 	struct ice_ipv4_hdr ipv4_hdr;
302 	struct ice_ipv6_hdr ipv6_hdr;
303 	struct ice_l4_hdr l4_hdr;
304 	struct ice_sctp_hdr sctp_hdr;
305 	struct ice_udp_tnl_hdr tnl_hdr;
306 	struct ice_nvgre nvgre_hdr;
307 	struct ice_udp_gtp_hdr gtp_hdr;
308 };
309 
310 /* This is mapping table entry that maps every word within a given protocol
311  * structure to the real byte offset as per the specification of that
312  * protocol header.
313  * for e.g. dst address is 3 words in ethertype header and corresponding bytes
314  * are 0, 2, 3 in the actual packet header and src address is at 4, 6, 8
315  */
316 struct ice_prot_ext_tbl_entry {
317 	enum ice_protocol_type prot_type;
318 	/* Byte offset into header of given protocol type */
319 	u8 offs[sizeof(union ice_prot_hdr)];
320 };
321 
322 /* Extractions to be looked up for a given recipe */
323 struct ice_prot_lkup_ext {
324 	u16 prot_type;
325 	u8 n_val_words;
326 	/* create a buffer to hold max words per recipe */
327 	u16 field_off[ICE_MAX_CHAIN_WORDS];
328 	u16 field_mask[ICE_MAX_CHAIN_WORDS];
329 
330 	struct ice_fv_word fv_words[ICE_MAX_CHAIN_WORDS];
331 
332 	/* Indicate field offsets that have field vector indices assigned */
333 	ice_declare_bitmap(done, ICE_MAX_CHAIN_WORDS);
334 };
335 
336 struct ice_pref_recipe_group {
337 	u8 n_val_pairs;		/* Number of valid pairs */
338 	struct ice_fv_word pairs[ICE_NUM_WORDS_RECIPE];
339 	u16 mask[ICE_NUM_WORDS_RECIPE];
340 };
341 
342 struct ice_recp_grp_entry {
343 	struct LIST_ENTRY_TYPE l_entry;
344 
345 #define ICE_INVAL_CHAIN_IND 0xFF
346 	u16 rid;
347 	u8 chain_idx;
348 	u16 fv_idx[ICE_NUM_WORDS_RECIPE];
349 	u16 fv_mask[ICE_NUM_WORDS_RECIPE];
350 	struct ice_pref_recipe_group r_group;
351 };
352 #endif /* _ICE_PROTOCOL_TYPE_H_ */
353