2 * Copyright (c) 2016 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:
7 * http://www.apache.org/licenses/LICENSE-2.0
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.
16 #include <vnet/feature/feature.h>
19 vnet_feature_main_t feature_main;
21 typedef struct vnet_feature_upd_registration_t_
23 vnet_feature_update_cb_t cb;
25 } vnet_feature_upd_registration_t;
27 static vnet_feature_upd_registration_t *regs;
30 vnet_feature_register (vnet_feature_update_cb_t cb, void *data)
32 vnet_feature_upd_registration_t *reg;
34 vec_add2 (regs, reg, 1);
41 vent_feature_reg_invoke (u32 sw_if_index, u8 arc_index, u8 is_enable)
43 vnet_feature_upd_registration_t *reg;
45 vec_foreach (reg, regs)
46 reg->cb (sw_if_index, arc_index, is_enable, reg->data);
51 vnet_feature_init (vlib_main_t * vm)
53 vnet_feature_main_t *fm = &feature_main;
54 vnet_feature_registration_t *freg;
55 vnet_feature_arc_registration_t *areg;
56 vnet_feature_constraint_registration_t *creg;
59 fm->arc_index_by_name = hash_create_string (0, sizeof (uword));
62 /* process feature arc registrations */
67 areg->feature_arc_index = arc_index;
68 if (areg->arc_index_ptr)
69 *areg->arc_index_ptr = arc_index;
70 hash_set_mem (fm->arc_index_by_name, areg->arc_name,
71 pointer_to_uword (areg));
73 /* process start nodes */
74 while ((s = areg->start_nodes[i]))
78 areg->n_start_nodes = i;
85 vec_validate (fm->next_feature_by_arc, arc_index - 1);
86 vec_validate (fm->feature_nodes, arc_index - 1);
87 vec_validate (fm->feature_config_mains, arc_index - 1);
88 vec_validate (fm->next_feature_by_name, arc_index - 1);
89 vec_validate (fm->sw_if_index_has_features, arc_index - 1);
90 vec_validate (fm->feature_count_by_sw_if_index, arc_index - 1);
91 vec_validate (fm->next_constraint_by_arc, arc_index - 1);
93 freg = fm->next_feature;
96 vnet_feature_registration_t *next;
97 uword *p = hash_get_mem (fm->arc_index_by_name, freg->arc_name);
100 /* Don't start vpp with broken features arcs */
101 clib_warning ("Unknown feature arc '%s'", freg->arc_name);
105 areg = uword_to_pointer (p[0], vnet_feature_arc_registration_t *);
106 arc_index = areg->feature_arc_index;
109 freg->next_in_arc = fm->next_feature_by_arc[arc_index];
110 fm->next_feature_by_arc[arc_index] = freg;
116 /* Move bulk constraints to the constraint by arc lists */
117 creg = fm->next_constraint;
120 vnet_feature_constraint_registration_t *next;
121 uword *p = hash_get_mem (fm->arc_index_by_name, creg->arc_name);
124 /* Don't start vpp with broken features arcs */
125 clib_warning ("Unknown feature arc '%s'", creg->arc_name);
129 areg = uword_to_pointer (p[0], vnet_feature_arc_registration_t *);
130 arc_index = areg->feature_arc_index;
133 creg->next_in_arc = fm->next_constraint_by_arc[arc_index];
134 fm->next_constraint_by_arc[arc_index] = creg;
145 vnet_feature_config_main_t *cm;
146 vnet_config_main_t *vcm;
147 char **features_in_order, *last_feature;
149 arc_index = areg->feature_arc_index;
150 cm = &fm->feature_config_mains[arc_index];
151 vcm = &cm->config_main;
152 if ((error = vnet_feature_arc_init
153 (vm, vcm, areg->start_nodes, areg->n_start_nodes,
155 fm->next_feature_by_arc[arc_index],
156 fm->next_constraint_by_arc[arc_index],
157 &fm->feature_nodes[arc_index])))
159 clib_error_report (error);
163 features_in_order = fm->feature_nodes[arc_index];
165 /* If specified, verify that the last node in the arc is actually last */
166 if (areg->last_in_arc && vec_len (features_in_order) > 0)
168 last_feature = features_in_order[vec_len (features_in_order) - 1];
169 if (strncmp (areg->last_in_arc, last_feature,
170 strlen (areg->last_in_arc)))
172 ("WARNING: %s arc: last node is %s, but expected %s!",
173 areg->arc_name, last_feature, areg->last_in_arc);
176 fm->next_feature_by_name[arc_index] =
177 hash_create_string (0, sizeof (uword));
178 freg = fm->next_feature_by_arc[arc_index];
182 hash_set_mem (fm->next_feature_by_name[arc_index],
183 freg->node_name, pointer_to_uword (freg));
184 freg = freg->next_in_arc;
195 VLIB_INIT_FUNCTION (vnet_feature_init);
198 vnet_get_feature_arc_index (const char *s)
200 vnet_feature_main_t *fm = &feature_main;
201 vnet_feature_arc_registration_t *reg;
204 p = hash_get_mem (fm->arc_index_by_name, s);
208 reg = uword_to_pointer (p[0], vnet_feature_arc_registration_t *);
209 return reg->feature_arc_index;
212 vnet_feature_registration_t *
213 vnet_get_feature_reg (const char *arc_name, const char *node_name)
217 arc_index = vnet_get_feature_arc_index (arc_name);
218 if (arc_index == (u8) ~ 0)
221 vnet_feature_main_t *fm = &feature_main;
222 vnet_feature_registration_t *reg;
225 p = hash_get_mem (fm->next_feature_by_name[arc_index], node_name);
229 reg = uword_to_pointer (p[0], vnet_feature_registration_t *);
234 vnet_get_feature_index (u8 arc, const char *s)
236 vnet_feature_main_t *fm = &feature_main;
237 vnet_feature_registration_t *reg;
243 p = hash_get_mem (fm->next_feature_by_name[arc], s);
247 reg = uword_to_pointer (p[0], vnet_feature_registration_t *);
248 return reg->feature_index;
252 vnet_feature_enable_disable_with_index (u8 arc_index, u32 feature_index,
253 u32 sw_if_index, int enable_disable,
254 void *feature_config,
255 u32 n_feature_config_bytes)
257 vnet_feature_main_t *fm = &feature_main;
258 vnet_feature_config_main_t *cm;
262 if (arc_index == (u8) ~ 0)
263 return VNET_API_ERROR_INVALID_VALUE;
265 if (feature_index == ~0)
266 return VNET_API_ERROR_INVALID_VALUE_2;
268 cm = &fm->feature_config_mains[arc_index];
269 vec_validate_init_empty (cm->config_index_by_sw_if_index, sw_if_index, ~0);
270 ci = cm->config_index_by_sw_if_index[sw_if_index];
272 vec_validate (fm->feature_count_by_sw_if_index[arc_index], sw_if_index);
273 feature_count = fm->feature_count_by_sw_if_index[arc_index][sw_if_index];
275 if (!enable_disable && feature_count < 1)
279 ? vnet_config_add_feature
280 : vnet_config_del_feature)
281 (vlib_get_main (), &cm->config_main, ci, feature_index, feature_config,
282 n_feature_config_bytes);
287 cm->config_index_by_sw_if_index[sw_if_index] = ci;
289 /* update feature count */
290 enable_disable = (enable_disable > 0);
291 feature_count += enable_disable ? 1 : -1;
292 ASSERT (feature_count >= 0);
294 fm->sw_if_index_has_features[arc_index] =
295 clib_bitmap_set (fm->sw_if_index_has_features[arc_index], sw_if_index,
296 (feature_count > 0));
297 vent_feature_reg_invoke (sw_if_index, arc_index, (feature_count > 0));
299 fm->feature_count_by_sw_if_index[arc_index][sw_if_index] = feature_count;
304 vnet_feature_enable_disable (const char *arc_name, const char *node_name,
305 u32 sw_if_index, int enable_disable,
306 void *feature_config, u32 n_feature_config_bytes)
311 arc_index = vnet_get_feature_arc_index (arc_name);
313 if (arc_index == (u8) ~ 0)
314 return VNET_API_ERROR_INVALID_VALUE;
316 feature_index = vnet_get_feature_index (arc_index, node_name);
318 return vnet_feature_enable_disable_with_index (arc_index, feature_index,
319 sw_if_index, enable_disable,
321 n_feature_config_bytes);
325 feature_cmp (void *a1, void *a2)
327 vnet_feature_registration_t *reg1 = a1;
328 vnet_feature_registration_t *reg2 = a2;
330 return (int) reg1->feature_index - reg2->feature_index;
333 /** Display the set of available driver features.
334 Useful for verifying that expected features are present
337 static clib_error_t *
338 show_features_command_fn (vlib_main_t * vm,
339 unformat_input_t * input, vlib_cli_command_t * cmd)
341 vnet_feature_main_t *fm = &feature_main;
342 vnet_feature_arc_registration_t *areg;
343 vnet_feature_registration_t *freg;
344 vnet_feature_registration_t *feature_regs = 0;
347 if (unformat (input, "verbose"))
350 vlib_cli_output (vm, "Available feature paths");
356 vlib_cli_output (vm, "[%2d] %s:", areg->feature_arc_index,
359 vlib_cli_output (vm, "%s:", areg->arc_name);
361 freg = fm->next_feature_by_arc[areg->feature_arc_index];
364 vec_add1 (feature_regs, freg[0]);
365 freg = freg->next_in_arc;
368 vec_sort_with_function (feature_regs, feature_cmp);
370 vec_foreach (freg, feature_regs)
373 vlib_cli_output (vm, " [%2d]: %s\n", freg->feature_index,
376 vlib_cli_output (vm, " %s\n", freg->node_name);
378 vec_reset_length (feature_regs);
382 vec_free (feature_regs);
388 * Display the set of available driver features
392 * @cliexcmd{show features [verbose]}
397 VLIB_CLI_COMMAND (show_features_command, static) = {
398 .path = "show features",
399 .short_help = "show features [verbose]",
400 .function = show_features_command_fn,
404 /** Display the set of driver features configured on a specific interface
405 * Called by "show interface" handler
409 vnet_interface_features_show (vlib_main_t * vm, u32 sw_if_index, int verbose)
411 vnet_feature_main_t *fm = &feature_main;
412 u32 node_index, current_config_index;
414 vnet_feature_config_main_t *cm = fm->feature_config_mains;
415 vnet_feature_arc_registration_t *areg;
416 vnet_config_main_t *vcm;
419 vnet_config_feature_t *feat;
423 vlib_cli_output (vm, "Feature paths configured on %U...",
424 format_vnet_sw_if_index_name,
425 vnet_get_main (), sw_if_index);
430 feature_arc = areg->feature_arc_index;
431 vcm = &(cm[feature_arc].config_main);
433 vlib_cli_output (vm, "\n%s:", areg->arc_name);
436 if (NULL == cm[feature_arc].config_index_by_sw_if_index ||
437 vec_len (cm[feature_arc].config_index_by_sw_if_index) <=
440 vlib_cli_output (vm, " none configured");
444 current_config_index =
445 vec_elt (cm[feature_arc].config_index_by_sw_if_index, sw_if_index);
447 if (current_config_index == ~0)
449 vlib_cli_output (vm, " none configured");
453 ASSERT (current_config_index
454 < vec_len (vcm->config_pool_index_by_user_index));
456 cfg_index = vcm->config_pool_index_by_user_index[current_config_index];
457 cfg = pool_elt_at_index (vcm->config_pool, cfg_index);
459 for (i = 0; i < vec_len (cfg->features); i++)
461 feat = cfg->features + i;
462 node_index = feat->node_index;
463 n = vlib_get_node (vm, node_index);
465 vlib_cli_output (vm, " [%2d] %v", feat->feature_index, n->name);
467 vlib_cli_output (vm, " %v", n->name);
472 static clib_error_t *
473 set_interface_features_command_fn (vlib_main_t * vm,
474 unformat_input_t * input,
475 vlib_cli_command_t * cmd)
477 vnet_main_t *vnm = vnet_get_main ();
478 unformat_input_t _line_input, *line_input = &_line_input;
479 clib_error_t *error = 0;
482 u8 *feature_name = 0;
483 u32 sw_if_index = ~0;
486 /* Get a line of input. */
487 if (!unformat_user (input, unformat_line_input, line_input))
490 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
493 (line_input, "%U %s arc %s", unformat_vnet_sw_interface, vnm,
494 &sw_if_index, &feature_name, &arc_name))
496 else if (unformat (line_input, "disable"))
500 error = unformat_parse_error (line_input);
504 if (!feature_name || !arc_name)
506 error = clib_error_return (0, "Both feature name and arc required...");
510 if (sw_if_index == ~0)
512 error = clib_error_return (0, "Interface not specified...");
516 vec_add1 (arc_name, 0);
517 vec_add1 (feature_name, 0);
521 arc_index = vnet_get_feature_arc_index ((const char *) arc_name);
523 if (arc_index == (u8) ~ 0)
526 clib_error_return (0, "Unknown arc name (%s)... ",
527 (const char *) arc_name);
531 vnet_feature_registration_t *reg;
533 vnet_get_feature_reg ((const char *) arc_name,
534 (const char *) feature_name);
538 clib_error_return (0,
539 "Feature (%s) not registered to arc (%s)... See 'show features verbose' for valid feature/arc combinations. ",
540 feature_name, arc_name);
543 if (reg->enable_disable_cb)
544 error = reg->enable_disable_cb (sw_if_index, enable);
546 vnet_feature_enable_disable ((const char *) arc_name,
547 (const char *) feature_name, sw_if_index,
551 vec_free (feature_name);
553 unformat_free (line_input);
558 * Set feature for given interface
562 * @cliexcmd{set interface feature GigabitEthernet2/0/0 ip4_flow_classify arc ip4_unicast}
567 VLIB_CLI_COMMAND (set_interface_feature_command, static) = {
568 .path = "set interface feature",
569 .short_help = "set interface feature <intfc> <feature_name> arc <arc_name> "
571 .function = set_interface_features_command_fn,
576 * fd.io coding-style-patch-verification: ON
579 * eval: (c-set-style "gnu")