blob: 8988eb0e8aaef66cd364d5b0d0b6b6b6f71718a6 [file] [log] [blame]
Ed Warnickecb9cada2015-12-08 15:45:58 -07001/*
2 * Copyright (c) 2015 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
6 *
7 * http://www.apache.org/licenses/LICENSE-2.0
8 *
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15/*
16 * interface.h: VNET interfaces/sub-interfaces
17 *
18 * Copyright (c) 2008 Eliot Dresselhaus
19 *
20 * Permission is hereby granted, free of charge, to any person obtaining
21 * a copy of this software and associated documentation files (the
22 * "Software"), to deal in the Software without restriction, including
23 * without limitation the rights to use, copy, modify, merge, publish,
24 * distribute, sublicense, and/or sell copies of the Software, and to
25 * permit persons to whom the Software is furnished to do so, subject to
26 * the following conditions:
27 *
28 * The above copyright notice and this permission notice shall be
29 * included in all copies or substantial portions of the Software.
30 *
31 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
32 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
33 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
34 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
35 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
36 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
37 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
38 */
39
40#ifndef included_vnet_interface_h
41#define included_vnet_interface_h
42
43#include <vnet/unix/pcap.h>
Neale Rannsb80c5362016-10-08 13:03:40 +010044#include <vnet/l3_types.h>
Ed Warnickecb9cada2015-12-08 15:45:58 -070045
46struct vnet_main_t;
47struct vnet_hw_interface_t;
48struct vnet_sw_interface_t;
Neale Rannsb80c5362016-10-08 13:03:40 +010049struct ip46_address_t;
Ed Warnickecb9cada2015-12-08 15:45:58 -070050
Stevene3a395c2017-05-09 16:19:50 -070051typedef enum
52{
53 VNET_HW_INTERFACE_RX_MODE_UNKNOWN,
54 VNET_HW_INTERFACE_RX_MODE_POLLING,
55 VNET_HW_INTERFACE_RX_MODE_INTERRUPT,
56 VNET_HW_INTERFACE_RX_MODE_ADAPTIVE,
Damjan Marion4e53a0d2017-06-21 14:29:44 +020057 VNET_HW_INTERFACE_RX_MODE_DEFAULT,
Stevene3a395c2017-05-09 16:19:50 -070058 VNET_HW_INTERFACE_NUM_RX_MODES,
59} vnet_hw_interface_rx_mode;
60
Ed Warnickecb9cada2015-12-08 15:45:58 -070061/* Interface up/down callback. */
Dave Barachba868bb2016-08-08 09:51:21 -040062typedef clib_error_t *(vnet_interface_function_t)
Ed Warnickecb9cada2015-12-08 15:45:58 -070063 (struct vnet_main_t * vnm, u32 if_index, u32 flags);
64
65/* Sub-interface add/del callback. */
Dave Barachba868bb2016-08-08 09:51:21 -040066typedef clib_error_t *(vnet_subif_add_del_function_t)
Ed Warnickecb9cada2015-12-08 15:45:58 -070067 (struct vnet_main_t * vnm, u32 if_index,
Dave Barachba868bb2016-08-08 09:51:21 -040068 struct vnet_sw_interface_t * template, int is_add);
Ed Warnickecb9cada2015-12-08 15:45:58 -070069
Pavel Kotucekc631f2d2016-09-26 10:40:02 +020070/* Interface set mac address callback. */
71typedef clib_error_t *(vnet_interface_set_mac_address_function_t)
72 (struct vnet_hw_interface_t * hi, char *address);
73
Stevene3a395c2017-05-09 16:19:50 -070074/* Interface set rx mode callback. */
75typedef clib_error_t *(vnet_interface_set_rx_mode_function_t)
76 (struct vnet_main_t * vnm, u32 if_index, u32 queue_id,
77 vnet_hw_interface_rx_mode mode);
78
Neale Ranns8b37b872016-11-21 12:25:22 +000079typedef enum vnet_interface_function_priority_t_
80{
81 VNET_ITF_FUNC_PRIORITY_LOW,
82 VNET_ITF_FUNC_PRIORITY_HIGH,
83} vnet_interface_function_priority_t;
84#define VNET_ITF_FUNC_N_PRIO ((vnet_interface_function_priority_t)VNET_ITF_FUNC_PRIORITY_HIGH+1)
85
Dave Barachba868bb2016-08-08 09:51:21 -040086typedef struct _vnet_interface_function_list_elt
87{
88 struct _vnet_interface_function_list_elt *next_interface_function;
89 clib_error_t *(*fp) (struct vnet_main_t * vnm, u32 if_index, u32 flags);
Ed Warnickecb9cada2015-12-08 15:45:58 -070090} _vnet_interface_function_list_elt_t;
91
Neale Ranns8b37b872016-11-21 12:25:22 +000092#define _VNET_INTERFACE_FUNCTION_DECL_PRIO(f,tag,p) \
93 \
94static void __vnet_interface_function_init_##tag##_##f (void) \
95 __attribute__((__constructor__)) ; \
96 \
97static void __vnet_interface_function_init_##tag##_##f (void) \
98{ \
99 vnet_main_t * vnm = vnet_get_main(); \
100 static _vnet_interface_function_list_elt_t init_function; \
101 init_function.next_interface_function = vnm->tag##_functions[p]; \
102 vnm->tag##_functions[p] = &init_function; \
Ed Warnickecb9cada2015-12-08 15:45:58 -0700103 init_function.fp = (void *) &f; \
Dave Barachba868bb2016-08-08 09:51:21 -0400104}
Ed Warnickecb9cada2015-12-08 15:45:58 -0700105
Eyal Barif9cda7d2018-02-13 11:50:58 +0200106#define _VNET_INTERFACE_FUNCTION_DECL(f,tag) \
107 _VNET_INTERFACE_FUNCTION_DECL_PRIO(f,tag,VNET_ITF_FUNC_PRIORITY_LOW)
108
Ed Warnickecb9cada2015-12-08 15:45:58 -0700109#define VNET_HW_INTERFACE_ADD_DEL_FUNCTION(f) \
110 _VNET_INTERFACE_FUNCTION_DECL(f,hw_interface_add_del)
111#define VNET_HW_INTERFACE_LINK_UP_DOWN_FUNCTION(f) \
112 _VNET_INTERFACE_FUNCTION_DECL(f,hw_interface_link_up_down)
Neale Ranns8b37b872016-11-21 12:25:22 +0000113#define VNET_HW_INTERFACE_LINK_UP_DOWN_FUNCTION_PRIO(f,p) \
114 _VNET_INTERFACE_FUNCTION_DECL_PRIO(f,hw_interface_link_up_down,p)
Ed Warnickecb9cada2015-12-08 15:45:58 -0700115#define VNET_SW_INTERFACE_ADD_DEL_FUNCTION(f) \
116 _VNET_INTERFACE_FUNCTION_DECL(f,sw_interface_add_del)
117#define VNET_SW_INTERFACE_ADMIN_UP_DOWN_FUNCTION(f) \
118 _VNET_INTERFACE_FUNCTION_DECL(f,sw_interface_admin_up_down)
Neale Ranns8b37b872016-11-21 12:25:22 +0000119#define VNET_SW_INTERFACE_ADMIN_UP_DOWN_FUNCTION_PRIO(f,p) \
120 _VNET_INTERFACE_FUNCTION_DECL_PRIO(f,sw_interface_admin_up_down, p)
Ed Warnickecb9cada2015-12-08 15:45:58 -0700121
122/* A class of hardware interface devices. */
Dave Barachba868bb2016-08-08 09:51:21 -0400123typedef struct _vnet_device_class
124{
Ed Warnickecb9cada2015-12-08 15:45:58 -0700125 /* Index into main vector. */
126 u32 index;
127
128 /* Device name (e.g. "FOOBAR 1234a"). */
Dave Barachba868bb2016-08-08 09:51:21 -0400129 char *name;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700130
131 /* Function to call when hardware interface is added/deleted. */
Dave Barachba868bb2016-08-08 09:51:21 -0400132 vnet_interface_function_t *interface_add_del_function;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700133
134 /* Function to bring device administratively up/down. */
Dave Barachba868bb2016-08-08 09:51:21 -0400135 vnet_interface_function_t *admin_up_down_function;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700136
137 /* Function to call when sub-interface is added/deleted */
Dave Barachba868bb2016-08-08 09:51:21 -0400138 vnet_subif_add_del_function_t *subif_add_del_function;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700139
Stevene3a395c2017-05-09 16:19:50 -0700140 /* Function to call interface rx mode is changed */
141 vnet_interface_set_rx_mode_function_t *rx_mode_change_function;
142
Ed Warnickecb9cada2015-12-08 15:45:58 -0700143 /* Redistribute flag changes/existence of this interface class. */
144 u32 redistribute;
145
146 /* Transmit function. */
Dave Barachba868bb2016-08-08 09:51:21 -0400147 vlib_node_function_t *tx_function;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700148
149 /* Error strings indexed by error code for this node. */
Dave Barachba868bb2016-08-08 09:51:21 -0400150 char **tx_function_error_strings;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700151
152 /* Number of error codes used by this node. */
153 u32 tx_function_n_errors;
154
155 /* Renumber device name [only!] support, a control-plane kludge */
Dave Barachba868bb2016-08-08 09:51:21 -0400156 int (*name_renumber) (struct vnet_hw_interface_t * hi,
157 u32 new_dev_instance);
Ed Warnickecb9cada2015-12-08 15:45:58 -0700158
159 /* Format device instance as name. */
Dave Barachba868bb2016-08-08 09:51:21 -0400160 format_function_t *format_device_name;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700161
162 /* Parse function for device name. */
Dave Barachba868bb2016-08-08 09:51:21 -0400163 unformat_function_t *unformat_device_name;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700164
165 /* Format device verbosely for this class. */
Dave Barachba868bb2016-08-08 09:51:21 -0400166 format_function_t *format_device;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700167
168 /* Trace buffer format for TX function. */
Dave Barachba868bb2016-08-08 09:51:21 -0400169 format_function_t *format_tx_trace;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700170
171 /* Function to clear hardware counters for device. */
Dave Barachba868bb2016-08-08 09:51:21 -0400172 void (*clear_counters) (u32 dev_class_instance);
Ed Warnickecb9cada2015-12-08 15:45:58 -0700173
Dave Barachba868bb2016-08-08 09:51:21 -0400174 uword (*is_valid_class_for_interface) (struct vnet_main_t * vnm,
175 u32 hw_if_index,
176 u32 hw_class_index);
Ed Warnickecb9cada2015-12-08 15:45:58 -0700177
178 /* Called when hardware class of an interface changes. */
Dave Barachba868bb2016-08-08 09:51:21 -0400179 void (*hw_class_change) (struct vnet_main_t * vnm,
180 u32 hw_if_index, u32 new_hw_class_index);
Ed Warnickecb9cada2015-12-08 15:45:58 -0700181
182 /* Called to redirect traffic from a specific interface instance */
Dave Barachba868bb2016-08-08 09:51:21 -0400183 void (*rx_redirect_to_node) (struct vnet_main_t * vnm,
184 u32 hw_if_index, u32 node_index);
Ed Warnickecb9cada2015-12-08 15:45:58 -0700185
186 /* Link-list of all device classes set up by constructors created below */
Dave Barachba868bb2016-08-08 09:51:21 -0400187 struct _vnet_device_class *next_class_registration;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700188
Pavel Kotucekc631f2d2016-09-26 10:40:02 +0200189 /* Function to set mac address. */
190 vnet_interface_set_mac_address_function_t *mac_addr_change_function;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700191} vnet_device_class_t;
192
193#define VNET_DEVICE_CLASS(x,...) \
194 __VA_ARGS__ vnet_device_class_t x; \
195static void __vnet_add_device_class_registration_##x (void) \
196 __attribute__((__constructor__)) ; \
197static void __vnet_add_device_class_registration_##x (void) \
198{ \
199 vnet_main_t * vnm = vnet_get_main(); \
200 x.next_class_registration = vnm->device_class_registrations; \
201 vnm->device_class_registrations = &x; \
202} \
Dave Barachba868bb2016-08-08 09:51:21 -0400203__VA_ARGS__ vnet_device_class_t x
Ed Warnickecb9cada2015-12-08 15:45:58 -0700204
Damjan Marion1c80e832016-05-11 23:07:18 +0200205#define VLIB_DEVICE_TX_FUNCTION_CLONE_TEMPLATE(arch, fn, tgt) \
206 uword \
207 __attribute__ ((flatten)) \
208 __attribute__ ((target (tgt))) \
209 CLIB_CPU_OPTIMIZED \
210 fn ## _ ## arch ( vlib_main_t * vm, \
211 vlib_node_runtime_t * node, \
212 vlib_frame_t * frame) \
213 { return fn (vm, node, frame); }
214
215#define VLIB_DEVICE_TX_FUNCTION_MULTIARCH_CLONE(fn) \
216 foreach_march_variant(VLIB_DEVICE_TX_FUNCTION_CLONE_TEMPLATE, fn)
217
218#if CLIB_DEBUG > 0
219#define VLIB_MULTIARCH_CLONE_AND_SELECT_FN(fn,...)
220#define VLIB_DEVICE_TX_FUNCTION_MULTIARCH(dev, fn)
221#else
222#define VLIB_DEVICE_TX_FUNCTION_MULTIARCH(dev, fn) \
223 VLIB_DEVICE_TX_FUNCTION_MULTIARCH_CLONE(fn) \
224 CLIB_MULTIARCH_SELECT_FN(fn, static inline) \
225 static void __attribute__((__constructor__)) \
226 __vlib_device_tx_function_multiarch_select_##dev (void) \
227 { dev.tx_function = fn ## _multiarch_select(); }
228#endif
229
Neale Rannsb80c5362016-10-08 13:03:40 +0100230/**
231 * Link Type: A description of the protocol of packets on the link.
232 * On an ethernet link this maps directly into the ethertype. On a GRE tunnel
233 * it maps to the GRE-proto, etc for other lnk types.
234 */
235typedef enum vnet_link_t_
236{
237#if CLIB_DEBUG > 0
238 VNET_LINK_IP4 = 1,
239#else
240 VNET_LINK_IP4 = 0,
241#endif
242 VNET_LINK_IP6,
243 VNET_LINK_MPLS,
244 VNET_LINK_ETHERNET,
245 VNET_LINK_ARP,
Florin Corasce1b4c72017-01-26 14:25:34 -0800246 VNET_LINK_NSH,
Neale Rannsb80c5362016-10-08 13:03:40 +0100247} __attribute__ ((packed)) vnet_link_t;
248
Neale Ranns924d03a2016-10-19 08:25:46 +0100249#define VNET_LINKS { \
250 [VNET_LINK_ETHERNET] = "ethernet", \
251 [VNET_LINK_IP4] = "ipv4", \
252 [VNET_LINK_IP6] = "ipv6", \
253 [VNET_LINK_MPLS] = "mpls", \
254 [VNET_LINK_ARP] = "arp", \
Florin Corasce1b4c72017-01-26 14:25:34 -0800255 [VNET_LINK_NSH] = "nsh", \
Neale Ranns924d03a2016-10-19 08:25:46 +0100256}
257
258/**
259 * @brief Number of link types. Not part of the enum so it does not have to be included in
260 * switch statements
261 */
Florin Corasce1b4c72017-01-26 14:25:34 -0800262#define VNET_LINK_NUM (VNET_LINK_NSH+1)
Neale Ranns924d03a2016-10-19 08:25:46 +0100263
Neale Rannsb80c5362016-10-08 13:03:40 +0100264/**
265 * @brief Convert a link to to an Ethertype
266 */
267extern vnet_l3_packet_type_t vnet_link_to_l3_proto (vnet_link_t link);
268
269/**
270 * @brief Attributes assignable to a HW interface Class.
271 */
272typedef enum vnet_hw_interface_class_flags_t_
273{
274 /**
275 * @brief a point 2 point interface
276 */
277 VNET_HW_INTERFACE_CLASS_FLAG_P2P = (1 << 0),
278} vnet_hw_interface_class_flags_t;
Damjan Marion1c80e832016-05-11 23:07:18 +0200279
Ed Warnickecb9cada2015-12-08 15:45:58 -0700280/* Layer-2 (e.g. Ethernet) interface class. */
Dave Barachba868bb2016-08-08 09:51:21 -0400281typedef struct _vnet_hw_interface_class
282{
Ed Warnickecb9cada2015-12-08 15:45:58 -0700283 /* Index into main vector. */
284 u32 index;
285
286 /* Class name (e.g. "Ethernet"). */
Dave Barachba868bb2016-08-08 09:51:21 -0400287 char *name;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700288
Neale Rannsb80c5362016-10-08 13:03:40 +0100289 /* Flags */
290 vnet_hw_interface_class_flags_t flags;
291
Ed Warnickecb9cada2015-12-08 15:45:58 -0700292 /* Function to call when hardware interface is added/deleted. */
Dave Barachba868bb2016-08-08 09:51:21 -0400293 vnet_interface_function_t *interface_add_del_function;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700294
295 /* Function to bring interface administratively up/down. */
Dave Barachba868bb2016-08-08 09:51:21 -0400296 vnet_interface_function_t *admin_up_down_function;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700297
298 /* Function to call when link state changes. */
Dave Barachba868bb2016-08-08 09:51:21 -0400299 vnet_interface_function_t *link_up_down_function;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700300
Neale Ranns3be6b282016-12-20 14:24:01 +0000301 /* Function to call when link MAC changes. */
302 vnet_interface_set_mac_address_function_t *mac_addr_change_function;
303
Ed Warnickecb9cada2015-12-08 15:45:58 -0700304 /* Format function to display interface name. */
Dave Barachba868bb2016-08-08 09:51:21 -0400305 format_function_t *format_interface_name;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700306
307 /* Format function to display interface address. */
Dave Barachba868bb2016-08-08 09:51:21 -0400308 format_function_t *format_address;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700309
310 /* Format packet header for this interface class. */
Dave Barachba868bb2016-08-08 09:51:21 -0400311 format_function_t *format_header;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700312
313 /* Format device verbosely for this class. */
Dave Barachba868bb2016-08-08 09:51:21 -0400314 format_function_t *format_device;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700315
316 /* Parser for hardware (e.g. ethernet) address. */
Dave Barachba868bb2016-08-08 09:51:21 -0400317 unformat_function_t *unformat_hw_address;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700318
319 /* Parser for packet header for e.g. rewrite string. */
Dave Barachba868bb2016-08-08 09:51:21 -0400320 unformat_function_t *unformat_header;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700321
Neale Rannsb80c5362016-10-08 13:03:40 +0100322 /* Builds a rewrite string for the interface to the destination
323 * for the payload/link type. */
324 u8 *(*build_rewrite) (struct vnet_main_t * vnm,
325 u32 sw_if_index,
326 vnet_link_t link_type, const void *dst_hw_address);
327
328 /* Update an adjacecny added by FIB (as opposed to via the
329 * neighbour resolution protocol). */
330 void (*update_adjacency) (struct vnet_main_t * vnm,
331 u32 sw_if_index, u32 adj_index);
Ed Warnickecb9cada2015-12-08 15:45:58 -0700332
Dave Barachba868bb2016-08-08 09:51:21 -0400333 uword (*is_valid_class_for_interface) (struct vnet_main_t * vnm,
334 u32 hw_if_index,
335 u32 hw_class_index);
Ed Warnickecb9cada2015-12-08 15:45:58 -0700336
337 /* Called when hw interface class is changed and old hardware instance
338 may want to be deleted. */
Dave Barachba868bb2016-08-08 09:51:21 -0400339 void (*hw_class_change) (struct vnet_main_t * vnm, u32 hw_if_index,
340 u32 old_class_index, u32 new_class_index);
Ed Warnickecb9cada2015-12-08 15:45:58 -0700341
342 /* List of hw interface classes, built by constructors */
Dave Barachba868bb2016-08-08 09:51:21 -0400343 struct _vnet_hw_interface_class *next_class_registration;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700344
345} vnet_hw_interface_class_t;
346
Neale Rannsb80c5362016-10-08 13:03:40 +0100347/**
348 * @brief Return a complete, zero-length (aka dummy) rewrite
349 */
350extern u8 *default_build_rewrite (struct vnet_main_t *vnm,
351 u32 sw_if_index,
352 vnet_link_t link_type,
353 const void *dst_hw_address);
354
355/**
356 * @brief Default adjacency update function
357 */
358extern void default_update_adjacency (struct vnet_main_t *vnm,
359 u32 sw_if_index, u32 adj_index);
360
Ed Warnickecb9cada2015-12-08 15:45:58 -0700361#define VNET_HW_INTERFACE_CLASS(x,...) \
362 __VA_ARGS__ vnet_hw_interface_class_t x; \
363static void __vnet_add_hw_interface_class_registration_##x (void) \
364 __attribute__((__constructor__)) ; \
365static void __vnet_add_hw_interface_class_registration_##x (void) \
366{ \
367 vnet_main_t * vnm = vnet_get_main(); \
368 x.next_class_registration = vnm->hw_interface_class_registrations; \
369 vnm->hw_interface_class_registrations = &x; \
370} \
371__VA_ARGS__ vnet_hw_interface_class_t x
372
373/* Hardware-interface. This corresponds to a physical wire
374 that packets flow over. */
Dave Barachba868bb2016-08-08 09:51:21 -0400375typedef struct vnet_hw_interface_t
376{
Ed Warnickecb9cada2015-12-08 15:45:58 -0700377 /* Interface name. */
Dave Barachba868bb2016-08-08 09:51:21 -0400378 u8 *name;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700379
380 u32 flags;
381 /* Hardware link state is up. */
382#define VNET_HW_INTERFACE_FLAG_LINK_UP (1 << 0)
383 /* Hardware duplex state */
384#define VNET_HW_INTERFACE_FLAG_DUPLEX_SHIFT 1
385#define VNET_HW_INTERFACE_FLAG_HALF_DUPLEX (1 << 1)
386#define VNET_HW_INTERFACE_FLAG_FULL_DUPLEX (1 << 2)
387#define VNET_HW_INTERFACE_FLAG_DUPLEX_MASK \
388 (VNET_HW_INTERFACE_FLAG_HALF_DUPLEX | \
389 VNET_HW_INTERFACE_FLAG_FULL_DUPLEX)
390
391 /* Hardware link speed */
392#define VNET_HW_INTERFACE_FLAG_SPEED_SHIFT 3
393#define VNET_HW_INTERFACE_FLAG_SPEED_10M (1 << 3)
394#define VNET_HW_INTERFACE_FLAG_SPEED_100M (1 << 4)
395#define VNET_HW_INTERFACE_FLAG_SPEED_1G (1 << 5)
Lee Roberts03f47f12018-03-07 20:18:48 -0700396#define VNET_HW_INTERFACE_FLAG_SPEED_2_5G (1 << 6)
397#define VNET_HW_INTERFACE_FLAG_SPEED_5G (1 << 7)
398#define VNET_HW_INTERFACE_FLAG_SPEED_10G (1 << 8)
399#define VNET_HW_INTERFACE_FLAG_SPEED_20G (1 << 9)
400#define VNET_HW_INTERFACE_FLAG_SPEED_25G (1 << 10)
401#define VNET_HW_INTERFACE_FLAG_SPEED_40G (1 << 11)
402#define VNET_HW_INTERFACE_FLAG_SPEED_50G (1 << 12)
403#define VNET_HW_INTERFACE_FLAG_SPEED_56G (1 << 13)
404#define VNET_HW_INTERFACE_FLAG_SPEED_100G (1 << 14)
Ed Warnickecb9cada2015-12-08 15:45:58 -0700405#define VNET_HW_INTERFACE_FLAG_SPEED_MASK \
406 (VNET_HW_INTERFACE_FLAG_SPEED_10M | \
407 VNET_HW_INTERFACE_FLAG_SPEED_100M | \
408 VNET_HW_INTERFACE_FLAG_SPEED_1G | \
Lee Roberts03f47f12018-03-07 20:18:48 -0700409 VNET_HW_INTERFACE_FLAG_SPEED_2_5G | \
410 VNET_HW_INTERFACE_FLAG_SPEED_5G | \
Ed Warnickecb9cada2015-12-08 15:45:58 -0700411 VNET_HW_INTERFACE_FLAG_SPEED_10G | \
Lee Roberts03f47f12018-03-07 20:18:48 -0700412 VNET_HW_INTERFACE_FLAG_SPEED_20G | \
Damjan Marion7c748bb2018-02-25 22:55:03 +0100413 VNET_HW_INTERFACE_FLAG_SPEED_25G | \
Ed Warnickecb9cada2015-12-08 15:45:58 -0700414 VNET_HW_INTERFACE_FLAG_SPEED_40G | \
Lee Roberts03f47f12018-03-07 20:18:48 -0700415 VNET_HW_INTERFACE_FLAG_SPEED_50G | \
416 VNET_HW_INTERFACE_FLAG_SPEED_56G | \
Ed Warnickecb9cada2015-12-08 15:45:58 -0700417 VNET_HW_INTERFACE_FLAG_SPEED_100G)
418
Damjan Marion44036902017-04-28 12:29:15 +0200419 /* rx mode flags */
Lee Roberts03f47f12018-03-07 20:18:48 -0700420#define VNET_HW_INTERFACE_FLAG_SUPPORTS_INT_MODE (1 << 16)
Damjan Marion44036902017-04-28 12:29:15 +0200421
Dave Barach2c0a4f42017-06-29 09:30:15 -0400422 /* tx checksum offload */
Lee Roberts03f47f12018-03-07 20:18:48 -0700423#define VNET_HW_INTERFACE_FLAG_SUPPORTS_TX_L4_CKSUM_OFFLOAD (1 << 17)
Dave Barach2c0a4f42017-06-29 09:30:15 -0400424
Ed Warnickecb9cada2015-12-08 15:45:58 -0700425 /* Hardware address as vector. Zero (e.g. zero-length vector) if no
426 address for this class (e.g. PPP). */
Dave Barachba868bb2016-08-08 09:51:21 -0400427 u8 *hw_address;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700428
429 /* Interface is up as far as software is concerned. */
430 /* NAME.{output,tx} nodes for this interface. */
431 u32 output_node_index, tx_node_index;
432
433 /* (dev_class, dev_instance) uniquely identifies hw interface. */
434 u32 dev_class_index;
435 u32 dev_instance;
436
437 /* (hw_class, hw_instance) uniquely identifies hw interface. */
438 u32 hw_class_index;
439 u32 hw_instance;
440
441 /* Hardware index for this hardware interface. */
442 u32 hw_if_index;
443
444 /* Software index for this hardware interface. */
445 u32 sw_if_index;
446
John Loe5453d02018-01-23 19:21:34 -0500447 /* Next index in interface-output node for this interface
448 used by node function vnet_per_buffer_interface_output() */
449 u32 output_node_next_index;
450
Ed Warnickecb9cada2015-12-08 15:45:58 -0700451 /* Maximum transmit rate for this interface in bits/sec. */
452 f64 max_rate_bits_per_sec;
453
Mohsin Kazmif2ba9aa2016-04-24 18:53:42 +0200454 /* Smallest packet size supported by this interface. */
455 u32 min_supported_packet_bytes;
456
457 /* Largest packet size supported by this interface. */
458 u32 max_supported_packet_bytes;
459
Ed Warnickecb9cada2015-12-08 15:45:58 -0700460 /* Smallest packet size for this interface. */
461 u32 min_packet_bytes;
462
463 /* Largest packet size for this interface. */
464 u32 max_packet_bytes;
465
466 /* Number of extra bytes that go on the wire.
467 Packet length on wire
468 = max (length + per_packet_overhead_bytes, min_packet_bytes). */
469 u32 per_packet_overhead_bytes;
470
471 /* Receive and transmit layer 3 packet size limits (MRU/MTU). */
472 u32 max_l3_packet_bytes[VLIB_N_RX_TX];
473
474 /* Hash table mapping sub interface id to sw_if_index. */
Dave Barachba868bb2016-08-08 09:51:21 -0400475 uword *sub_interface_sw_if_index_by_id;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700476
477 /* Count of number of L2 subinterfaces */
478 u32 l2_if_count;
John Lobcebbb92016-04-05 15:47:43 -0400479
480 /* Bonded interface info -
481 0 - not a bonded interface nor a slave
482 ~0 - slave to a bonded interface
483 others - A bonded interface with a pointer to bitmap for all slaves */
484 uword *bond_info;
485#define VNET_HW_INTERFACE_BOND_INFO_NONE ((uword *) 0)
486#define VNET_HW_INTERFACE_BOND_INFO_SLAVE ((uword *) ~0)
487
Damjan Marioneb743fa2017-03-20 16:34:15 +0100488 /* Input node */
489 u32 input_node_index;
490
491 /* input node cpu index by queue */
Damjan Marion586afd72017-04-05 19:18:20 +0200492 u32 *input_node_thread_index_by_queue;
Damjan Marioneb743fa2017-03-20 16:34:15 +0100493
Damjan Marion44036902017-04-28 12:29:15 +0200494 /* vnet_hw_interface_rx_mode by queue */
495 u8 *rx_mode_by_queue;
Damjan Marion4e53a0d2017-06-21 14:29:44 +0200496 vnet_hw_interface_rx_mode default_rx_mode;
Damjan Marion44036902017-04-28 12:29:15 +0200497
Damjan Marion153646e2017-04-05 18:15:45 +0200498 /* device input device_and_queue runtime index */
499 uword *dq_runtime_index_by_queue;
500
Ed Warnickecb9cada2015-12-08 15:45:58 -0700501} vnet_hw_interface_t;
502
Damjan Marion3d9c86e2016-07-04 21:04:40 +0200503extern vnet_device_class_t vnet_local_interface_device_class;
504
Dave Barachba868bb2016-08-08 09:51:21 -0400505typedef enum
506{
Ed Warnickecb9cada2015-12-08 15:45:58 -0700507 /* A hw interface. */
508 VNET_SW_INTERFACE_TYPE_HARDWARE,
509
510 /* A sub-interface. */
511 VNET_SW_INTERFACE_TYPE_SUB,
Pavel Kotucek15ac81c2017-06-20 14:00:26 +0200512 VNET_SW_INTERFACE_TYPE_P2P,
Ed Warnickecb9cada2015-12-08 15:45:58 -0700513} vnet_sw_interface_type_t;
514
Dave Barachba868bb2016-08-08 09:51:21 -0400515typedef struct
516{
517 /*
518 * Subinterface ID. A number 0-N to uniquely identify
519 * this subinterface under the main (parent?) interface
520 */
521 u32 id;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700522
Dave Barachba868bb2016-08-08 09:51:21 -0400523 /* Classification data. Used to associate packet header with subinterface. */
524 struct
525 {
Ed Warnickecb9cada2015-12-08 15:45:58 -0700526 u16 outer_vlan_id;
527 u16 inner_vlan_id;
Dave Barachba868bb2016-08-08 09:51:21 -0400528 union
529 {
Ed Warnickecb9cada2015-12-08 15:45:58 -0700530 u16 raw_flags;
Dave Barachba868bb2016-08-08 09:51:21 -0400531 struct
532 {
533 u16 no_tags:1;
534 u16 one_tag:1;
535 u16 two_tags:1;
536 u16 dot1ad:1; /* 0 = dot1q, 1=dot1ad */
537 u16 exact_match:1;
538 u16 default_sub:1;
539 u16 outer_vlan_id_any:1;
540 u16 inner_vlan_id_any:1;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700541 } flags;
542 };
543 } eth;
544} vnet_sub_interface_t;
545
Pavel Kotucek15ac81c2017-06-20 14:00:26 +0200546typedef struct
547{
548 /*
549 * Subinterface ID. A number 0-N to uniquely identify
550 * this subinterface under the main interface
551 */
552 u32 id;
553 u32 pool_index;
554 u8 client_mac[6];
555} vnet_p2p_sub_interface_t;
556
Eyal Baric5b13602016-11-24 19:42:43 +0200557typedef enum
558{
559 /* Always flood */
560 VNET_FLOOD_CLASS_NORMAL,
561 VNET_FLOOD_CLASS_TUNNEL_MASTER,
562 /* Does not flood when tunnel master is in the same L2 BD */
563 VNET_FLOOD_CLASS_TUNNEL_NORMAL
564} vnet_flood_class_t;
565
Ed Warnickecb9cada2015-12-08 15:45:58 -0700566/* Software-interface. This corresponds to a Ethernet VLAN, ATM vc, a
567 tunnel, etc. Configuration (e.g. IP address) gets attached to
568 software interface. */
Dave Barachba868bb2016-08-08 09:51:21 -0400569typedef struct
570{
571 vnet_sw_interface_type_t type:16;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700572
573 u16 flags;
574 /* Interface is "up" meaning adminstratively up.
575 Up in the sense of link state being up is maintained by hardware interface. */
576#define VNET_SW_INTERFACE_FLAG_ADMIN_UP (1 << 0)
577
578 /* Interface is disabled for forwarding: punt all traffic to slow-path. */
579#define VNET_SW_INTERFACE_FLAG_PUNT (1 << 1)
580
581#define VNET_SW_INTERFACE_FLAG_PROXY_ARP (1 << 2)
582
583#define VNET_SW_INTERFACE_FLAG_UNNUMBERED (1 << 3)
584
John Lobcebbb92016-04-05 15:47:43 -0400585#define VNET_SW_INTERFACE_FLAG_BOND_SLAVE (1 << 4)
586
John Lob2fd6cb2017-07-12 19:56:45 -0400587 /* Interface does not appear in CLI/API */
Eyal Bari3212c572017-03-06 11:47:50 +0200588#define VNET_SW_INTERFACE_FLAG_HIDDEN (1 << 5)
589
John Lob2fd6cb2017-07-12 19:56:45 -0400590 /* Interface in ERROR state */
Damjan Marionabce5092017-05-10 20:09:31 +0200591#define VNET_SW_INTERFACE_FLAG_ERROR (1 << 6)
592
Ed Warnickecb9cada2015-12-08 15:45:58 -0700593 /* Index for this interface. */
594 u32 sw_if_index;
595
596 /* Software interface index of super-interface;
597 equal to sw_if_index if this interface is not a
598 sub-interface. */
599 u32 sup_sw_if_index;
600
601 /* this swif is unnumbered, use addresses on unnumbered_sw_if_index... */
602 u32 unnumbered_sw_if_index;
603
604 u32 link_speed;
605
Dave Barachba868bb2016-08-08 09:51:21 -0400606 union
607 {
Ed Warnickecb9cada2015-12-08 15:45:58 -0700608 /* VNET_SW_INTERFACE_TYPE_HARDWARE. */
609 u32 hw_if_index;
610
611 /* VNET_SW_INTERFACE_TYPE_SUB. */
612 vnet_sub_interface_t sub;
Pavel Kotucek15ac81c2017-06-20 14:00:26 +0200613
614 /* VNET_SW_INTERFACE_TYPE_P2P. */
615 vnet_p2p_sub_interface_t p2p;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700616 };
Eyal Baric5b13602016-11-24 19:42:43 +0200617
618 vnet_flood_class_t flood_class;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700619} vnet_sw_interface_t;
620
Dave Barachba868bb2016-08-08 09:51:21 -0400621typedef enum
622{
Ed Warnickecb9cada2015-12-08 15:45:58 -0700623 /* Simple counters. */
624 VNET_INTERFACE_COUNTER_DROP = 0,
625 VNET_INTERFACE_COUNTER_PUNT = 1,
626 VNET_INTERFACE_COUNTER_IP4 = 2,
627 VNET_INTERFACE_COUNTER_IP6 = 3,
628 VNET_INTERFACE_COUNTER_RX_NO_BUF = 4,
629 VNET_INTERFACE_COUNTER_RX_MISS = 5,
630 VNET_INTERFACE_COUNTER_RX_ERROR = 6,
631 VNET_INTERFACE_COUNTER_TX_ERROR = 7,
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100632 VNET_INTERFACE_COUNTER_MPLS = 8,
633 VNET_N_SIMPLE_INTERFACE_COUNTER = 9,
Ed Warnickecb9cada2015-12-08 15:45:58 -0700634 /* Combined counters. */
635 VNET_INTERFACE_COUNTER_RX = 0,
636 VNET_INTERFACE_COUNTER_TX = 1,
637 VNET_N_COMBINED_INTERFACE_COUNTER = 2,
638} vnet_interface_counter_type_t;
639
Dave Barachba868bb2016-08-08 09:51:21 -0400640typedef struct
641{
Ed Warnickecb9cada2015-12-08 15:45:58 -0700642 u32 output_node_index;
643 u32 tx_node_index;
644} vnet_hw_interface_nodes_t;
645
Dave Barachba868bb2016-08-08 09:51:21 -0400646typedef struct
647{
Ed Warnickecb9cada2015-12-08 15:45:58 -0700648 /* Hardware interfaces. */
Dave Barachba868bb2016-08-08 09:51:21 -0400649 vnet_hw_interface_t *hw_interfaces;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700650
651 /* Hash table mapping HW interface name to index. */
Dave Barachba868bb2016-08-08 09:51:21 -0400652 uword *hw_interface_by_name;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700653
654 /* Vectors if hardware interface classes and device classes. */
Dave Barachba868bb2016-08-08 09:51:21 -0400655 vnet_hw_interface_class_t *hw_interface_classes;
656 vnet_device_class_t *device_classes;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700657
658 /* Hash table mapping name to hw interface/device class. */
Dave Barachba868bb2016-08-08 09:51:21 -0400659 uword *hw_interface_class_by_name;
660 uword *device_class_by_name;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700661
662 /* Software interfaces. */
Dave Barachba868bb2016-08-08 09:51:21 -0400663 vnet_sw_interface_t *sw_interfaces;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700664
665 /* Hash table mapping sub intfc sw_if_index by sup sw_if_index and sub id */
Dave Barachba868bb2016-08-08 09:51:21 -0400666 uword *sw_if_index_by_sup_and_sub;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700667
668 /* Software interface counters both simple and combined
669 packet and byte counters. */
670 volatile u32 *sw_if_counter_lock;
Dave Barachba868bb2016-08-08 09:51:21 -0400671 vlib_simple_counter_main_t *sw_if_counters;
672 vlib_combined_counter_main_t *combined_sw_if_counters;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700673
Dave Barachba868bb2016-08-08 09:51:21 -0400674 vnet_hw_interface_nodes_t *deleted_hw_interface_nodes;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700675
676 /* pcap drop tracing */
677 int drop_pcap_enable;
678 pcap_main_t pcap_main;
Dave Barachba868bb2016-08-08 09:51:21 -0400679 u8 *pcap_filename;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700680 u32 pcap_sw_if_index;
681 u32 pcap_pkts_to_capture;
Dave Barachba868bb2016-08-08 09:51:21 -0400682 uword *pcap_drop_filter_hash;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700683
Damjan Marion152e21d2016-11-29 14:55:43 +0100684 /* feature_arc_index */
685 u8 output_feature_arc_index;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700686} vnet_interface_main_t;
687
Dave Barachba868bb2016-08-08 09:51:21 -0400688static inline void
689vnet_interface_counter_lock (vnet_interface_main_t * im)
Ed Warnickecb9cada2015-12-08 15:45:58 -0700690{
691 if (im->sw_if_counter_lock)
692 while (__sync_lock_test_and_set (im->sw_if_counter_lock, 1))
693 /* zzzz */ ;
694}
Dave Barachba868bb2016-08-08 09:51:21 -0400695
696static inline void
697vnet_interface_counter_unlock (vnet_interface_main_t * im)
Ed Warnickecb9cada2015-12-08 15:45:58 -0700698{
699 if (im->sw_if_counter_lock)
700 *im->sw_if_counter_lock = 0;
701}
702
703void vnet_pcap_drop_trace_filter_add_del (u32 error_index, int is_add);
704
705int vnet_interface_name_renumber (u32 sw_if_index, u32 new_show_dev_instance);
706
Ed Warnickecb9cada2015-12-08 15:45:58 -0700707#endif /* included_vnet_interface_h */
Dave Barachba868bb2016-08-08 09:51:21 -0400708
709/*
710 * fd.io coding-style-patch-verification: ON
711 *
712 * Local Variables:
713 * eval: (c-set-style "gnu")
714 * End:
715 */