2 * l2_output.h : layer 2 output packet processing
4 * Copyright (c) 2013 Cisco and/or its affiliates.
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at:
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
18 #ifndef included_vnet_l2_output_h
19 #define included_vnet_l2_output_h
21 #include <vlib/vlib.h>
22 #include <vnet/vnet.h>
23 #include <vnet/l2/feat_bitmap.h>
24 #include <vnet/l2/l2_vtr.h>
27 /* The L2 output feature configuration, a per-interface struct */
34 * vlan tag rewrite for ingress and egress
35 * ingress vtr is located here because the same config data is used for
36 * the egress EFP filter check
38 vtr_config_t input_vtr;
39 vtr_config_t output_vtr;
41 /* some of these flags may get integrated into the feature bitmap */
45 /* split horizon group */
52 * The set of next nodes for features and interface output.
53 * Each output feature node should include this.
58 * vector of output next node index, indexed by sw_if_index.
59 * used when all output features have been executed and the
60 * next nodes are the interface output nodes.
62 u32 *output_node_index_vec;
65 * array of next node index for each output feature, indexed
66 * by l2output_feat_t. Used to determine next feature node.
68 u32 feat_next_node_index[32];
70 } l2_output_next_nodes_st;
75 /* Next nodes for features and output interfaces */
76 l2_output_next_nodes_st next_nodes;
78 /* config vector indexed by sw_if_index */
79 l2_output_config_t *configs;
81 /* Convenience variables */
82 vlib_main_t *vlib_main;
83 vnet_main_t *vnet_main;
86 l2output_main_t l2output_main;
88 /* L2 output features */
90 /* Mappings from feature ID to graph node name */
91 #define foreach_l2output_feat \
92 _(SPAN, "feature-bitmap-drop") \
93 _(CFM, "feature-bitmap-drop") \
94 _(QOS, "feature-bitmap-drop") \
95 _(ACL, "l2-output-acl") \
96 _(L2PT, "feature-bitmap-drop") \
97 _(EFP_FILTER, "l2-efp-filter") \
98 _(IPIW, "feature-bitmap-drop") \
99 _(STP_BLOCKED, "feature-bitmap-drop") \
100 _(LINESTATUS_DOWN, "feature-bitmap-drop") \
103 /* Feature bitmap positions */
106 #define _(sym,str) L2OUTPUT_FEAT_##sym##_BIT,
107 foreach_l2output_feat
112 /* Feature bit masks */
115 #define _(sym,str) L2OUTPUT_FEAT_##sym = (1<<L2OUTPUT_FEAT_##sym##_BIT),
116 foreach_l2output_feat
118 } l2output_feat_masks_t;
120 #define foreach_l2output_error \
121 _(L2OUTPUT, "L2 output packets") \
122 _(EFP_DROP, "L2 EFP filter pre-rewrite drops") \
123 _(VTR_DROP, "L2 output tag rewrite drops") \
124 _(SHG_DROP, "L2 split horizon drops") \
125 _(DROP, "L2 output drops")
130 L2OUTPUT_NEXT_DEL_TUNNEL,
136 #define _(sym,str) L2OUTPUT_ERROR_##sym,
137 foreach_l2output_error
142 /* Return an array of strings containing graph node names of each feature */
143 char **l2output_get_feat_names (void);
147 * The next set of functions is for use by output feature graph nodes.
148 * When the last bit has been cleared from the output feature bitmap,
149 * the next node is the output graph node for the TX sw_if_index.
150 * These functions help the feature nodes get that node index.
153 /* Create a mapping to the output graph node for the given sw_if_index */
154 u32 l2output_create_output_node_mapping (vlib_main_t * vlib_main, vnet_main_t * vnet_main, u32 node_index, /* index of current node */
155 u32 * output_node_index_vec,
158 /* Initialize the next node mapping table */
160 l2output_init_output_node_vec (u32 ** output_node_index_vec)
164 * Size it at 100 sw_if_indexes initially
165 * Uninitialized mappings are set to ~0
167 vec_validate_init_empty (*output_node_index_vec, 100, ~0);
172 * Get a mapping from the output node mapping table,
173 * creating the entry if necessary.
176 l2output_get_output_node (vlib_main_t * vlib_main, vnet_main_t * vnet_main, u32 node_index, /* index of current node */
177 u32 sw_if_index, u32 ** output_node_index_vec) /* may be updated */
179 u32 next; /* index of next graph node */
181 /* Insure the vector is big enough */
182 vec_validate_init_empty (*output_node_index_vec, sw_if_index, ~0);
184 /* Get the mapping for the sw_if_index */
185 next = vec_elt (*output_node_index_vec, sw_if_index);
189 /* Mapping doesn't exist so create it */
190 next = l2output_create_output_node_mapping (vlib_main,
193 *output_node_index_vec,
201 /** Determine the next L2 node based on the output feature bitmap */
203 l2_output_dispatch (vlib_main_t * vlib_main,
204 vnet_main_t * vnet_main,
205 vlib_node_runtime_t * node,
207 u32 * cached_sw_if_index,
208 u32 * cached_next_index,
209 l2_output_next_nodes_st * next_nodes,
211 u32 sw_if_index, u32 feature_bitmap, u32 * next0)
215 /* There are some features to execute */
217 /* Save bitmap for the next feature graph nodes */
218 vnet_buffer (b0)->l2.feature_bitmap = feature_bitmap;
220 /* Determine the next node */
222 feat_bitmap_get_next_node_index (next_nodes->feat_next_node_index,
228 * There are no features. Send packet to TX node for sw_if_index0
229 * This is a little tricky in that the output interface next node indexes
230 * are not precomputed at init time.
233 if (sw_if_index == *cached_sw_if_index)
235 /* We hit in the one-entry cache. Use it. */
236 *next0 = *cached_next_index;
240 /* Look up the output TX node */
241 *next0 = l2output_get_output_node (vlib_main,
245 &next_nodes->output_node_index_vec);
247 /* Update the one-entry cache */
248 *cached_sw_if_index = sw_if_index;
249 *cached_next_index = *next0;
254 /** Get a pointer to the config for the given interface */
255 l2_output_config_t *l2output_intf_config (u32 sw_if_index);
257 /** Enable (or disable) the feature in the bitmap for the given interface */
258 void l2output_intf_bitmap_enable (u32 sw_if_index,
259 u32 feature_bitmap, u32 enable);
264 * fd.io coding-style-patch-verification: ON
267 * eval: (c-set-style "gnu")