src/vnet/feature/feature.h

   1 /*
   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:
   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 #ifndef included_features_h
  17 #define included_features_h
  18
  19 #include <vnet/vnet.h>
  20 #include <vnet/api_errno.h>
  21 #include <vnet/devices/devices.h>
  22
  23 /** feature registration object */
  24 typedef struct _vnet_feature_arc_registration
  25 {
  26   /** next registration in list of all registrations*/
  27   struct _vnet_feature_arc_registration *next;
  28   /** Feature Arc name */
  29   char *arc_name;
  30   /** Start nodes */
  31   char **start_nodes;
  32   int n_start_nodes;
  33   /** End of the arc (optional, for consistency-checking) */
  34   char *last_in_arc;
  35   /* Feature arc index, assigned by init function */
  36   u8 feature_arc_index;
  37   u8 *arc_index_ptr;
  38 } vnet_feature_arc_registration_t;
  39
  40 /* Enable feature callback. */
  41 typedef clib_error_t *(vnet_feature_enable_disable_function_t)
  42   (u32 sw_if_index, int enable_disable);
  43
  44 /** feature registration object */
  45 typedef struct _vnet_feature_registration
  46 {
  47   /** next registration in list of all registrations*/
  48   struct _vnet_feature_registration *next, *next_in_arc;
  49   /** Feature arc name */
  50   char *arc_name;
  51   /** Graph node name */
  52   char *node_name;
  53   /** Pointer to this feature index, filled in by vnet_feature_arc_init */
  54   u32 *feature_index_ptr;
  55   u32 feature_index;
  56   /** Constraints of the form "this feature runs before X" */
  57   char **runs_before;
  58   /** Constraints of the form "this feature runs after Y" */
  59   char **runs_after;
  60
  61   /** Function to enable/disable feature  **/
  62   vnet_feature_enable_disable_function_t *enable_disable_cb;
  63 } vnet_feature_registration_t;
  64
  65 /** constraint registration object */
  66 typedef struct _vnet_feature_constraint_registration
  67 {
  68   /** next constraint set in list of all registrations*/
  69   struct _vnet_feature_constraint_registration *next, *next_in_arc;
  70   /** Feature arc name */
  71   char *arc_name;
  72
  73   /** Feature arc index, assigned by init function */
  74   u8 feature_arc_index;
  75
  76   /** Node names, to run in the specified order */
  77   char **node_names;
  78 } vnet_feature_constraint_registration_t;
  79
  80 typedef struct vnet_feature_config_main_t_
  81 {
  82   vnet_config_main_t config_main;
  83   u32 *config_index_by_sw_if_index;
  84 } vnet_feature_config_main_t;
  85
  86 typedef struct
  87 {
  88   /** feature arc configuration list */
  89   vnet_feature_arc_registration_t *next_arc;
  90   uword **arc_index_by_name;
  91
  92   /** feature path configuration lists */
  93   vnet_feature_registration_t *next_feature;
  94   vnet_feature_registration_t **next_feature_by_arc;
  95   vnet_feature_constraint_registration_t *next_constraint;
  96   vnet_feature_constraint_registration_t **next_constraint_by_arc;
  97   uword **next_feature_by_name;
  98
  99   /** feature config main objects */
 100   vnet_feature_config_main_t *feature_config_mains;
 101
 102   /** Save partial order results for show command */
 103   char ***feature_nodes;
 104
 105   /** bitmap of interfaces which have driver rx features configured */
 106   uword **sw_if_index_has_features;
 107
 108   /** feature reference counts by interface */
 109   i16 **feature_count_by_sw_if_index;
 110
 111   /** Feature arc index for device-input */
 112   u8 device_input_feature_arc_index;
 113
 114   /** convenience */
 115   vlib_main_t *vlib_main;
 116   vnet_main_t *vnet_main;
 117 } vnet_feature_main_t;
 118
 119 extern vnet_feature_main_t feature_main;
 120
 121 #ifndef CLIB_MARCH_VARIANT
 122 #define VNET_FEATURE_ARC_INIT(x,...)                            \
 123   __VA_ARGS__ vnet_feature_arc_registration_t vnet_feat_arc_##x;\
 124 static void __vnet_add_feature_arc_registration_##x (void)      \
 125   __attribute__((__constructor__)) ;                            \
 126 static void __vnet_add_feature_arc_registration_##x (void)      \
 127 {                                                               \
 128   vnet_feature_main_t * fm = &feature_main;                     \
 129   vnet_feat_arc_##x.next = fm->next_arc;                        \
 130   fm->next_arc = & vnet_feat_arc_##x;                           \
 131 }                                                               \
 132 static void __vnet_rm_feature_arc_registration_##x (void)       \
 133   __attribute__((__destructor__)) ;                             \
 134 static void __vnet_rm_feature_arc_registration_##x (void)       \
 135 {                                                               \
 136   vnet_feature_main_t * fm = &feature_main;                     \
 137   vnet_feature_arc_registration_t *r = &vnet_feat_arc_##x;      \
 138   VLIB_REMOVE_FROM_LINKED_LIST (fm->next_arc, r, next);         \
 139 }                                                               \
 140 __VA_ARGS__ vnet_feature_arc_registration_t vnet_feat_arc_##x
 141
 142 #define VNET_FEATURE_INIT(x,...)                                \
 143   __VA_ARGS__ vnet_feature_registration_t vnet_feat_##x;        \
 144 static void __vnet_add_feature_registration_##x (void)          \
 145   __attribute__((__constructor__)) ;                            \
 146 static void __vnet_add_feature_registration_##x (void)          \
 147 {                                                               \
 148   vnet_feature_main_t * fm = &feature_main;                     \
 149   vnet_feat_##x.next = fm->next_feature;                        \
 150   fm->next_feature = & vnet_feat_##x;                           \
 151 }                                                               \
 152 static void __vnet_rm_feature_registration_##x (void)           \
 153   __attribute__((__destructor__)) ;                             \
 154 static void __vnet_rm_feature_registration_##x (void)           \
 155 {                                                               \
 156   vnet_feature_main_t * fm = &feature_main;                     \
 157   vnet_feature_registration_t *r = &vnet_feat_##x;              \
 158   VLIB_REMOVE_FROM_LINKED_LIST (fm->next_feature, r, next);     \
 159 }                                                               \
 160 __VA_ARGS__ vnet_feature_registration_t vnet_feat_##x
 161
 162 #define VNET_FEATURE_ARC_ORDER(x,...)                                   \
 163   __VA_ARGS__ vnet_feature_constraint_registration_t                    \
 164 vnet_feature_constraint_##x;                                            \
 165 static void __vnet_add_constraint_registration_##x (void)               \
 166   __attribute__((__constructor__)) ;                                    \
 167 static void __vnet_add_constraint_registration_##x (void)               \
 168 {                                                                       \
 169   vnet_feature_main_t * fm = &feature_main;                             \
 170   vnet_feature_constraint_##x.next = fm->next_constraint;               \
 171   fm->next_constraint = & vnet_feature_constraint_##x;                  \
 172 }                                                                       \
 173 static void __vnet_rm_constraint_registration_##x (void)                \
 174   __attribute__((__destructor__)) ;                                     \
 175 static void __vnet_rm_constraint_registration_##x (void)                \
 176 {                                                                       \
 177   vnet_feature_main_t * fm = &feature_main;                             \
 178   vnet_feature_constraint_registration_t *r = &vnet_feature_constraint_##x; \
 179   VLIB_REMOVE_FROM_LINKED_LIST (fm->next_constraint, r, next);          \
 180 }                                                                       \
 181 __VA_ARGS__ vnet_feature_constraint_registration_t vnet_feature_constraint_##x
 182
 183 #else
 184 #define VNET_FEATURE_ARC_INIT(x,...)                            \
 185 extern vnet_feature_arc_registration_t __clib_unused vnet_feat_arc_##x; \
 186 static vnet_feature_arc_registration_t __clib_unused __clib_unused_vnet_feat_arc_##x
 187 #define VNET_FEATURE_INIT(x,...)                                \
 188 extern vnet_feature_registration_t __clib_unused vnet_feat_##x; \
 189 static vnet_feature_registration_t __clib_unused __clib_unused_vnet_feat_##x
 190
 191 #define VNET_FEATURE_ARC_ORDER(x,...)                           \
 192 extern vnet_feature_constraint_registration_t                   \
 193 __clib_unused vnet_feature_constraint_##x;                      \
 194 static vnet_feature_constraint_registration_t __clib_unused     \
 195 __clib_unused_vnet_feature_constraint_##x
 196
 197
 198 #endif
 199
 200 void
 201 vnet_config_update_feature_count (vnet_feature_main_t * fm, u8 arc,
 202                                   u32 sw_if_index, int is_add);
 203
 204 u32 vnet_get_feature_index (u8 arc, const char *s);
 205 u8 vnet_get_feature_arc_index (const char *s);
 206 vnet_feature_registration_t *vnet_get_feature_reg (const char *arc_name,
 207                                                    const char *node_name);
 208
 209
 210 int
 211 vnet_feature_enable_disable_with_index (u8 arc_index, u32 feature_index,
 212                                         u32 sw_if_index, int enable_disable,
 213                                         void *feature_config,
 214                                         u32 n_feature_config_bytes);
 215
 216 int
 217 vnet_feature_enable_disable (const char *arc_name, const char *node_name,
 218                              u32 sw_if_index, int enable_disable,
 219                              void *feature_config,
 220                              u32 n_feature_config_bytes);
 221
 222 static_always_inline u32
 223 vnet_get_feature_count (u8 arc, u32 sw_if_index)
 224 {
 225   vnet_feature_main_t *fm = &feature_main;
 226   return (fm->feature_count_by_sw_if_index[arc][sw_if_index]);
 227 }
 228
 229 static inline vnet_feature_config_main_t *
 230 vnet_get_feature_arc_config_main (u8 arc_index)
 231 {
 232   vnet_feature_main_t *fm = &feature_main;
 233
 234   if (arc_index == (u8) ~ 0)
 235     return 0;
 236
 237   return &fm->feature_config_mains[arc_index];
 238 }
 239
 240 static_always_inline vnet_feature_config_main_t *
 241 vnet_feature_get_config_main (u16 arc)
 242 {
 243   vnet_feature_main_t *fm = &feature_main;
 244   return &fm->feature_config_mains[arc];
 245 }
 246
 247 static_always_inline int
 248 vnet_have_features (u8 arc, u32 sw_if_index)
 249 {
 250   vnet_feature_main_t *fm = &feature_main;
 251   return clib_bitmap_get (fm->sw_if_index_has_features[arc], sw_if_index);
 252 }
 253
 254 static_always_inline u32
 255 vnet_get_feature_config_index (u8 arc, u32 sw_if_index)
 256 {
 257   vnet_feature_main_t *fm = &feature_main;
 258   vnet_feature_config_main_t *cm = &fm->feature_config_mains[arc];
 259   return vec_elt (cm->config_index_by_sw_if_index, sw_if_index);
 260 }
 261
 262 static_always_inline void *
 263 vnet_feature_arc_start_with_data (u8 arc, u32 sw_if_index, u32 * next,
 264                                   vlib_buffer_t * b, u32 n_data_bytes)
 265 {
 266   vnet_feature_main_t *fm = &feature_main;
 267   vnet_feature_config_main_t *cm;
 268   cm = &fm->feature_config_mains[arc];
 269
 270   if (PREDICT_FALSE (vnet_have_features (arc, sw_if_index)))
 271     {
 272       vnet_buffer (b)->feature_arc_index = arc;
 273       b->current_config_index =
 274         vec_elt (cm->config_index_by_sw_if_index, sw_if_index);
 275       return vnet_get_config_data (&cm->config_main, &b->current_config_index,
 276                                    next, n_data_bytes);
 277     }
 278   return 0;
 279 }
 280
 281 static_always_inline void
 282 vnet_feature_arc_start (u8 arc, u32 sw_if_index, u32 * next0,
 283                         vlib_buffer_t * b0)
 284 {
 285   vnet_feature_arc_start_with_data (arc, sw_if_index, next0, b0, 0);
 286 }
 287
 288 static_always_inline void *
 289 vnet_feature_next_with_data (u32 * next0, vlib_buffer_t * b0,
 290                              u32 n_data_bytes)
 291 {
 292   vnet_feature_main_t *fm = &feature_main;
 293   u8 arc = vnet_buffer (b0)->feature_arc_index;
 294   vnet_feature_config_main_t *cm = &fm->feature_config_mains[arc];
 295
 296   return vnet_get_config_data (&cm->config_main,
 297                                &b0->current_config_index, next0,
 298                                n_data_bytes);
 299 }
 300
 301 static_always_inline void
 302 vnet_feature_next (u32 * next0, vlib_buffer_t * b0)
 303 {
 304   vnet_feature_next_with_data (next0, b0, 0);
 305 }
 306
 307 static_always_inline void
 308 vnet_feature_next_u16 (u16 * next0, vlib_buffer_t * b0)
 309 {
 310   u32 next32;
 311   vnet_feature_next_with_data (&next32, b0, 0);
 312   *next0 = next32;
 313 }
 314
 315 static_always_inline int
 316 vnet_device_input_have_features (u32 sw_if_index)
 317 {
 318   vnet_feature_main_t *fm = &feature_main;
 319   return vnet_have_features (fm->device_input_feature_arc_index, sw_if_index);
 320 }
 321
 322 static_always_inline void
 323 vnet_feature_start_device_input_x1 (u32 sw_if_index, u32 * next0,
 324                                     vlib_buffer_t * b0)
 325 {
 326   vnet_feature_main_t *fm = &feature_main;
 327   vnet_feature_config_main_t *cm;
 328   u8 feature_arc_index = fm->device_input_feature_arc_index;
 329   cm = &fm->feature_config_mains[feature_arc_index];
 330
 331   if (PREDICT_FALSE
 332       (clib_bitmap_get
 333        (fm->sw_if_index_has_features[feature_arc_index], sw_if_index)))
 334     {
 335       /*
 336        * Save next0 so that the last feature in the chain
 337        * can skip ethernet-input if indicated...
 338        */
 339       u16 adv;
 340
 341       adv = device_input_next_node_advance[*next0];
 342       vlib_buffer_advance (b0, -adv);
 343
 344       vnet_buffer (b0)->feature_arc_index = feature_arc_index;
 345       b0->current_config_index =
 346         vec_elt (cm->config_index_by_sw_if_index, sw_if_index);
 347       vnet_get_config_data (&cm->config_main, &b0->current_config_index,
 348                             next0, /* # bytes of config data */ 0);
 349     }
 350 }
 351
 352 static_always_inline void
 353 vnet_feature_start_device_input_x2 (u32 sw_if_index,
 354                                     u32 * next0,
 355                                     u32 * next1,
 356                                     vlib_buffer_t * b0, vlib_buffer_t * b1)
 357 {
 358   vnet_feature_main_t *fm = &feature_main;
 359   vnet_feature_config_main_t *cm;
 360   u8 feature_arc_index = fm->device_input_feature_arc_index;
 361   cm = &fm->feature_config_mains[feature_arc_index];
 362
 363   if (PREDICT_FALSE
 364       (clib_bitmap_get
 365        (fm->sw_if_index_has_features[feature_arc_index], sw_if_index)))
 366     {
 367       /*
 368        * Save next0 so that the last feature in the chain
 369        * can skip ethernet-input if indicated...
 370        */
 371       u16 adv;
 372
 373       adv = device_input_next_node_advance[*next0];
 374       vlib_buffer_advance (b0, -adv);
 375
 376       adv = device_input_next_node_advance[*next1];
 377       vlib_buffer_advance (b1, -adv);
 378
 379       vnet_buffer (b0)->feature_arc_index = feature_arc_index;
 380       vnet_buffer (b1)->feature_arc_index = feature_arc_index;
 381       b0->current_config_index =
 382         vec_elt (cm->config_index_by_sw_if_index, sw_if_index);
 383       b1->current_config_index = b0->current_config_index;
 384       vnet_get_config_data (&cm->config_main, &b0->current_config_index,
 385                             next0, /* # bytes of config data */ 0);
 386       vnet_get_config_data (&cm->config_main, &b1->current_config_index,
 387                             next1, /* # bytes of config data */ 0);
 388     }
 389 }
 390
 391 static_always_inline void
 392 vnet_feature_start_device_input_x4 (u32 sw_if_index,
 393                                     u32 * next0,
 394                                     u32 * next1,
 395                                     u32 * next2,
 396                                     u32 * next3,
 397                                     vlib_buffer_t * b0,
 398                                     vlib_buffer_t * b1,
 399                                     vlib_buffer_t * b2, vlib_buffer_t * b3)
 400 {
 401   vnet_feature_main_t *fm = &feature_main;
 402   vnet_feature_config_main_t *cm;
 403   u8 feature_arc_index = fm->device_input_feature_arc_index;
 404   cm = &fm->feature_config_mains[feature_arc_index];
 405
 406   if (PREDICT_FALSE
 407       (clib_bitmap_get
 408        (fm->sw_if_index_has_features[feature_arc_index], sw_if_index)))
 409     {
 410       /*
 411        * Save next0 so that the last feature in the chain
 412        * can skip ethernet-input if indicated...
 413        */
 414       u16 adv;
 415
 416       adv = device_input_next_node_advance[*next0];
 417       vlib_buffer_advance (b0, -adv);
 418
 419       adv = device_input_next_node_advance[*next1];
 420       vlib_buffer_advance (b1, -adv);
 421
 422       adv = device_input_next_node_advance[*next2];
 423       vlib_buffer_advance (b2, -adv);
 424
 425       adv = device_input_next_node_advance[*next3];
 426       vlib_buffer_advance (b3, -adv);
 427
 428       vnet_buffer (b0)->feature_arc_index = feature_arc_index;
 429       vnet_buffer (b1)->feature_arc_index = feature_arc_index;
 430       vnet_buffer (b2)->feature_arc_index = feature_arc_index;
 431       vnet_buffer (b3)->feature_arc_index = feature_arc_index;
 432
 433       b0->current_config_index =
 434         vec_elt (cm->config_index_by_sw_if_index, sw_if_index);
 435       b1->current_config_index = b0->current_config_index;
 436       b2->current_config_index = b0->current_config_index;
 437       b3->current_config_index = b0->current_config_index;
 438
 439       vnet_get_config_data (&cm->config_main, &b0->current_config_index,
 440                             next0, /* # bytes of config data */ 0);
 441       vnet_get_config_data (&cm->config_main, &b1->current_config_index,
 442                             next1, /* # bytes of config data */ 0);
 443       vnet_get_config_data (&cm->config_main, &b2->current_config_index,
 444                             next2, /* # bytes of config data */ 0);
 445       vnet_get_config_data (&cm->config_main, &b3->current_config_index,
 446                             next3, /* # bytes of config data */ 0);
 447     }
 448 }
 449
 450 #define VNET_FEATURES(...)  (char*[]) { __VA_ARGS__, 0}
 451
 452 clib_error_t *vnet_feature_arc_init
 453   (vlib_main_t * vm,
 454    vnet_config_main_t * vcm,
 455    char **feature_start_nodes,
 456    int num_feature_start_nodes,
 457    char *last_in_arc,
 458    vnet_feature_registration_t * first_reg,
 459    vnet_feature_constraint_registration_t * first_const_set,
 460    char ***in_feature_nodes);
 461
 462 void vnet_interface_features_show (vlib_main_t * vm, u32 sw_if_index,
 463                                    int verbose);
 464
 465 typedef void (*vnet_feature_update_cb_t) (u32 sw_if_index,
 466                                           u8 arc_index,
 467                                           u8 is_enable, void *cb);
 468
 469 extern void vnet_feature_register (vnet_feature_update_cb_t cb, void *data);
 470
 471 #endif /* included_feature_h */
 472
 473 /*
 474  * fd.io coding-style-patch-verification: ON
 475  *
 476  * Local Variables:
 477  * eval: (c-set-style "gnu")
 478  * End:
 479  */