src/vnet/interface_funcs.h

   1 /*
   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_funcs.h: VNET interfaces/sub-interfaces exported functions
  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_funcs_h
  41 #define included_vnet_interface_funcs_h
  42
  43 always_inline vnet_hw_interface_t *
  44 vnet_get_hw_interface (vnet_main_t * vnm, u32 hw_if_index)
  45 {
  46   return pool_elt_at_index (vnm->interface_main.hw_interfaces, hw_if_index);
  47 }
  48
  49 always_inline vnet_hw_interface_t *
  50 vnet_get_hw_interface_safe (vnet_main_t * vnm, u32 hw_if_index)
  51 {
  52   if (!pool_is_free_index (vnm->interface_main.hw_interfaces, hw_if_index))
  53     return pool_elt_at_index (vnm->interface_main.hw_interfaces, hw_if_index);
  54   return (NULL);
  55 }
  56
  57 always_inline vnet_sw_interface_t *
  58 vnet_get_sw_interface (vnet_main_t * vnm, u32 sw_if_index)
  59 {
  60   return pool_elt_at_index (vnm->interface_main.sw_interfaces, sw_if_index);
  61 }
  62
  63 always_inline vnet_sw_interface_t *
  64 vnet_get_sw_interface_safe (vnet_main_t * vnm, u32 sw_if_index)
  65 {
  66   if (!pool_is_free_index (vnm->interface_main.sw_interfaces, sw_if_index))
  67     return pool_elt_at_index (vnm->interface_main.sw_interfaces, sw_if_index);
  68   return (NULL);
  69 }
  70
  71 always_inline vnet_sw_interface_t *
  72 vnet_get_hw_sw_interface (vnet_main_t * vnm, u32 hw_if_index)
  73 {
  74   vnet_hw_interface_t *hw = vnet_get_hw_interface (vnm, hw_if_index);
  75   vnet_sw_interface_t *sw = vnet_get_sw_interface (vnm, hw->sw_if_index);
  76   ASSERT (sw->type == VNET_SW_INTERFACE_TYPE_HARDWARE);
  77   return sw;
  78 }
  79
  80 always_inline vnet_sw_interface_t *
  81 vnet_get_sup_sw_interface (vnet_main_t * vnm, u32 sw_if_index)
  82 {
  83   vnet_sw_interface_t *sw = vnet_get_sw_interface (vnm, sw_if_index);
  84   if (sw->type == VNET_SW_INTERFACE_TYPE_SUB ||
  85       sw->type == VNET_SW_INTERFACE_TYPE_PIPE ||
  86       sw->type == VNET_SW_INTERFACE_TYPE_P2P)
  87     sw = vnet_get_sw_interface (vnm, sw->sup_sw_if_index);
  88   return sw;
  89 }
  90
  91 always_inline vnet_hw_interface_t *
  92 vnet_get_sup_hw_interface (vnet_main_t * vnm, u32 sw_if_index)
  93 {
  94   vnet_sw_interface_t *sw = vnet_get_sup_sw_interface (vnm, sw_if_index);
  95   ASSERT ((sw->type == VNET_SW_INTERFACE_TYPE_HARDWARE) ||
  96           (sw->type == VNET_SW_INTERFACE_TYPE_PIPE));
  97   return vnet_get_hw_interface (vnm, sw->hw_if_index);
  98 }
  99
 100 always_inline vnet_hw_interface_class_t *
 101 vnet_get_hw_interface_class (vnet_main_t * vnm, u32 hw_class_index)
 102 {
 103   return vec_elt_at_index (vnm->interface_main.hw_interface_classes,
 104                            hw_class_index);
 105 }
 106
 107 always_inline vnet_device_class_t *
 108 vnet_get_device_class (vnet_main_t * vnm, u32 dev_class_index)
 109 {
 110   return vec_elt_at_index (vnm->interface_main.device_classes,
 111                            dev_class_index);
 112 }
 113
 114 static inline u8 *
 115 vnet_get_sw_interface_tag (vnet_main_t * vnm, u32 sw_if_index)
 116 {
 117   uword *p;
 118   p = hash_get (vnm->interface_tag_by_sw_if_index, sw_if_index);
 119   if (p)
 120     return ((u8 *) p[0]);
 121   return 0;
 122 }
 123
 124 static inline void
 125 vnet_set_sw_interface_tag (vnet_main_t * vnm, u8 * tag, u32 sw_if_index)
 126 {
 127   uword *p;
 128   p = hash_get (vnm->interface_tag_by_sw_if_index, sw_if_index);
 129   if (p)
 130     {
 131       u8 *oldtag = (u8 *) p[0];
 132       hash_unset (vnm->interface_tag_by_sw_if_index, sw_if_index);
 133       vec_free (oldtag);
 134     }
 135
 136   hash_set (vnm->interface_tag_by_sw_if_index, sw_if_index, tag);
 137 }
 138
 139 static inline void
 140 vnet_clear_sw_interface_tag (vnet_main_t * vnm, u32 sw_if_index)
 141 {
 142   uword *p;
 143   p = hash_get (vnm->interface_tag_by_sw_if_index, sw_if_index);
 144   if (p)
 145     {
 146       u8 *oldtag = (u8 *) p[0];
 147       hash_unset (vnm->interface_tag_by_sw_if_index, sw_if_index);
 148       vec_free (oldtag);
 149     }
 150 }
 151
 152 /**
 153  * Walk return code
 154  */
 155 typedef enum walk_rc_t_
 156 {
 157   WALK_STOP,
 158   WALK_CONTINUE,
 159 } walk_rc_t;
 160
 161 /**
 162  * Call back walk type for walking SW indices on a HW interface
 163  */
 164 typedef walk_rc_t (*vnet_hw_sw_interface_walk_t) (vnet_main_t * vnm,
 165                                                   u32 sw_if_index, void *ctx);
 166
 167 /**
 168  * @brief
 169  * Walk the SW interfaces on a HW interface - this is the super
 170  * interface and any sub-interfaces.
 171  */
 172 void vnet_hw_interface_walk_sw (vnet_main_t * vnm,
 173                                 u32 hw_if_index,
 174                                 vnet_hw_sw_interface_walk_t fn, void *ctx);
 175
 176 /**
 177  * Call back walk type for walking SW indices on a HW interface
 178  */
 179 typedef walk_rc_t (*vnet_sw_interface_walk_t) (vnet_main_t * vnm,
 180                                                vnet_sw_interface_t * si,
 181                                                void *ctx);
 182
 183 /**
 184  * @brief
 185  * Walk all the SW interfaces in the system.
 186  */
 187 void vnet_sw_interface_walk (vnet_main_t * vnm,
 188                              vnet_sw_interface_walk_t fn, void *ctx);
 189
 190
 191 /**
 192  * Call back walk type for walking all HW indices
 193  */
 194 typedef walk_rc_t (*vnet_hw_interface_walk_t) (vnet_main_t * vnm,
 195                                                u32 hw_if_index, void *ctx);
 196
 197 /**
 198  * @brief
 199  * Walk all the HW interface
 200  */
 201 void vnet_hw_interface_walk (vnet_main_t * vnm,
 202                              vnet_hw_interface_walk_t fn, void *ctx);
 203
 204 /* Register a hardware interface instance. */
 205 u32 vnet_register_interface (vnet_main_t * vnm,
 206                              u32 dev_class_index,
 207                              u32 dev_instance,
 208                              u32 hw_class_index, u32 hw_instance);
 209
 210 /**
 211  * Set interface output node - for interface registered without its output/tx
 212  * nodes created because its VNET_DEVICE_CLASS did not specify any tx_function.
 213  * This is typically the case for tunnel interfaces.
 214  */
 215 void vnet_set_interface_output_node (vnet_main_t * vnm,
 216                                      u32 hw_if_index, u32 node_index);
 217
 218 /* Creates a software interface given template. */
 219 clib_error_t *vnet_create_sw_interface (vnet_main_t * vnm,
 220                                         vnet_sw_interface_t * template,
 221                                         u32 * sw_if_index);
 222
 223 void vnet_delete_hw_interface (vnet_main_t * vnm, u32 hw_if_index);
 224 void vnet_delete_sw_interface (vnet_main_t * vnm, u32 sw_if_index);
 225 int vnet_sw_interface_is_p2p (vnet_main_t * vnm, u32 sw_if_index);
 226
 227 always_inline vnet_sw_interface_flags_t
 228 vnet_sw_interface_get_flags (vnet_main_t * vnm, u32 sw_if_index)
 229 {
 230   vnet_sw_interface_t *sw = vnet_get_sw_interface (vnm, sw_if_index);
 231   return sw->flags;
 232 }
 233
 234 always_inline uword
 235 vnet_sw_interface_is_valid (vnet_main_t * vnm, u32 sw_if_index)
 236 {
 237   return !pool_is_free_index (vnm->interface_main.sw_interfaces, sw_if_index);
 238 }
 239
 240 always_inline uword
 241 vnet_hw_interface_is_valid (vnet_main_t * vnm, u32 hw_if_index)
 242 {
 243   return !pool_is_free_index (vnm->interface_main.hw_interfaces, hw_if_index);
 244 }
 245
 246
 247 always_inline uword
 248 vnet_sw_interface_is_admin_up (vnet_main_t * vnm, u32 sw_if_index)
 249 {
 250   return (vnet_sw_interface_get_flags (vnm, sw_if_index) &
 251           VNET_SW_INTERFACE_FLAG_ADMIN_UP) != 0;
 252 }
 253
 254 always_inline uword
 255 vnet_swif_is_api_visible (vnet_sw_interface_t * si)
 256 {
 257   return !(si->flags & VNET_SW_INTERFACE_FLAG_HIDDEN);
 258 }
 259
 260 always_inline uword
 261 vnet_sw_interface_is_api_visible (vnet_main_t * vnm, u32 sw_if_index)
 262 {
 263   vnet_sw_interface_t *si = vnet_get_sw_interface (vnm, sw_if_index);
 264   return vnet_swif_is_api_visible (si);
 265 }
 266
 267 always_inline uword
 268 vnet_sw_interface_is_api_valid (vnet_main_t * vnm, u32 sw_if_index)
 269 {
 270   return !pool_is_free_index (vnm->interface_main.sw_interfaces, sw_if_index)
 271     && vnet_sw_interface_is_api_visible (vnm, sw_if_index);
 272 }
 273
 274 always_inline const u8 *
 275 vnet_sw_interface_get_hw_address (vnet_main_t * vnm, u32 sw_if_index)
 276 {
 277   vnet_hw_interface_t *hw = vnet_get_sup_hw_interface (vnm, sw_if_index);
 278   return hw->hw_address;
 279 }
 280
 281 always_inline uword
 282 vnet_hw_interface_get_flags (vnet_main_t * vnm, u32 hw_if_index)
 283 {
 284   vnet_hw_interface_t *hw = vnet_get_hw_interface (vnm, hw_if_index);
 285   return hw->flags;
 286 }
 287
 288 always_inline u32
 289 vnet_hw_interface_get_mtu (vnet_main_t * vnm, u32 hw_if_index)
 290 {
 291   vnet_hw_interface_t *hw = vnet_get_hw_interface (vnm, hw_if_index);
 292   return hw->max_packet_bytes;
 293 }
 294
 295 always_inline u32
 296 vnet_sw_interface_get_mtu (vnet_main_t * vnm, u32 sw_if_index, vnet_mtu_t af)
 297 {
 298   vnet_sw_interface_t *sw = vnet_get_sw_interface (vnm, sw_if_index);
 299   u32 mtu;
 300   mtu = sw->mtu[af] > 0 ? sw->mtu[af] : sw->mtu[VNET_MTU_L3];
 301   if (mtu == 0)
 302     return 9000;                /* $$$ Deal with interface-types not setting MTU */
 303   return mtu;
 304 }
 305
 306 always_inline uword
 307 vnet_hw_interface_is_link_up (vnet_main_t * vnm, u32 hw_if_index)
 308 {
 309   return (vnet_hw_interface_get_flags (vnm, hw_if_index) &
 310           VNET_HW_INTERFACE_FLAG_LINK_UP) != 0;
 311 }
 312
 313 always_inline vlib_frame_t *
 314 vnet_get_frame_to_sw_interface (vnet_main_t * vnm, u32 sw_if_index)
 315 {
 316   vnet_hw_interface_t *hw = vnet_get_sup_hw_interface (vnm, sw_if_index);
 317   return vlib_get_frame_to_node (vlib_get_main (), hw->output_node_index);
 318 }
 319
 320 always_inline void
 321 vnet_put_frame_to_sw_interface (vnet_main_t * vnm, u32 sw_if_index,
 322                                 vlib_frame_t * f)
 323 {
 324   vnet_hw_interface_t *hw = vnet_get_sup_hw_interface (vnm, sw_if_index);
 325   return vlib_put_frame_to_node (vlib_get_main (), hw->output_node_index, f);
 326 }
 327
 328 always_inline void
 329 vnet_hw_interface_set_link_speed (vnet_main_t * vnm, u32 hw_if_index,
 330                                   u32 link_speed)
 331 {
 332   vnet_hw_interface_t *hw = vnet_get_hw_interface (vnm, hw_if_index);
 333   hw->link_speed = link_speed;
 334 }
 335
 336 /* Change interface flags (e.g. up, down, enable, disable). */
 337 clib_error_t *vnet_hw_interface_set_flags (vnet_main_t * vnm, u32 hw_if_index,
 338                                            vnet_hw_interface_flags_t flags);
 339
 340 /* Change interface flags (e.g. up, down, enable, disable). */
 341 clib_error_t *vnet_sw_interface_set_flags (vnet_main_t * vnm, u32 sw_if_index,
 342                                            vnet_sw_interface_flags_t flags);
 343
 344 /* Change interface class. */
 345 clib_error_t *vnet_hw_interface_set_class (vnet_main_t * vnm, u32 hw_if_index,
 346                                            u32 new_hw_class_index);
 347
 348 /* Redirect rx pkts to node */
 349 int vnet_hw_interface_rx_redirect_to_node (vnet_main_t * vnm, u32 hw_if_index,
 350                                            u32 node_index);
 351
 352 void vnet_hw_interface_init_for_class (vnet_main_t * vnm, u32 hw_if_index,
 353                                        u32 hw_class_index, u32 hw_instance);
 354
 355 /* Rename interface */
 356 clib_error_t *vnet_rename_interface (vnet_main_t * vnm, u32 hw_if_index,
 357                                      char *new_name);
 358
 359 /* Change interface mac address*/
 360 clib_error_t *vnet_hw_interface_change_mac_address (vnet_main_t * vnm,
 361                                                     u32 hw_if_index,
 362                                                     const u8 * mac_address);
 363
 364 /* Change rx-mode */
 365 clib_error_t *set_hw_interface_change_rx_mode (vnet_main_t * vnm,
 366                                                u32 hw_if_index,
 367                                                u8 queue_id_valid,
 368                                                u32 queue_id,
 369                                                vnet_hw_interface_rx_mode
 370                                                mode);
 371
 372 /* Set rx-placement on the interface */
 373 clib_error_t *set_hw_interface_rx_placement (u32 hw_if_index, u32 queue_id,
 374                                              u32 thread_index, u8 is_main);
 375
 376 /* Set the MTU on the HW interface */
 377 void vnet_hw_interface_set_mtu (vnet_main_t * vnm, u32 hw_if_index, u32 mtu);
 378
 379 /* Set the MTU on the SW interface */
 380 void vnet_sw_interface_set_mtu (vnet_main_t * vnm, u32 sw_if_index, u32 mtu);
 381 void vnet_sw_interface_set_protocol_mtu (vnet_main_t * vnm, u32 sw_if_index,
 382                                          u32 mtu[]);
 383
 384 /* update the unnumbered state of an interface */
 385 void vnet_sw_interface_update_unnumbered (u32 sw_if_index,
 386                                           u32 ip_sw_if_index, u8 enable);
 387
 388 int vnet_sw_interface_stats_collect_enable_disable (u32 sw_if_index,
 389                                                     u8 enable);
 390 void vnet_sw_interface_ip_directed_broadcast (vnet_main_t * vnm,
 391                                               u32 sw_if_index, u8 enable);
 392
 393 /* Formats sw/hw interface. */
 394 format_function_t format_vnet_hw_interface;
 395 format_function_t format_vnet_hw_interface_rx_mode;
 396 format_function_t format_vnet_hw_if_index_name;
 397 format_function_t format_vnet_sw_interface;
 398 format_function_t format_vnet_sw_interface_name;
 399 format_function_t format_vnet_sw_interface_name_override;
 400 format_function_t format_vnet_sw_if_index_name;
 401 format_function_t format_vnet_sw_interface_flags;
 402
 403 /* Parses sw/hw interface name -> index. */
 404 unformat_function_t unformat_vnet_sw_interface;
 405 unformat_function_t unformat_vnet_hw_interface;
 406
 407 /* Parses interface flags (up, down, enable, disable, etc.) */
 408 unformat_function_t unformat_vnet_hw_interface_flags;
 409 unformat_function_t unformat_vnet_sw_interface_flags;
 410
 411 /* Node runtime for interface output function. */
 412 typedef struct
 413 {
 414   u32 hw_if_index;
 415   u32 sw_if_index;
 416   u32 dev_instance;
 417   u32 is_deleted;
 418 } vnet_interface_output_runtime_t;
 419
 420 /* Interface output function. */
 421 void *vnet_interface_output_node_multiarch_select (void);
 422
 423 word vnet_sw_interface_compare (vnet_main_t * vnm, uword sw_if_index0,
 424                                 uword sw_if_index1);
 425 word vnet_hw_interface_compare (vnet_main_t * vnm, uword hw_if_index0,
 426                                 uword hw_if_index1);
 427
 428 typedef enum
 429 {
 430   VNET_INTERFACE_OUTPUT_NEXT_DROP,
 431   VNET_INTERFACE_OUTPUT_NEXT_TX,
 432 } vnet_interface_output_next_t;
 433
 434 typedef enum
 435 {
 436   VNET_INTERFACE_TX_NEXT_DROP,
 437   VNET_INTERFACE_TX_N_NEXT,
 438 } vnet_interface_tx_next_t;
 439
 440 #define VNET_SIMULATED_ETHERNET_TX_NEXT_ETHERNET_INPUT VNET_INTERFACE_TX_N_NEXT
 441 #define VNET_SIMULATED_ETHERNET_TX_NEXT_L2_INPUT (VNET_SIMULATED_ETHERNET_TX_NEXT_ETHERNET_INPUT + 1)
 442
 443 typedef enum
 444 {
 445   VNET_INTERFACE_OUTPUT_ERROR_INTERFACE_DOWN,
 446   VNET_INTERFACE_OUTPUT_ERROR_INTERFACE_DELETED,
 447 } vnet_interface_output_error_t;
 448
 449 /* Format for interface output traces. */
 450 u8 *format_vnet_interface_output_trace (u8 * s, va_list * va);
 451
 452 serialize_function_t serialize_vnet_interface_state,
 453   unserialize_vnet_interface_state;
 454
 455 #endif /* included_vnet_interface_funcs_h */
 456
 457 /*
 458  * fd.io coding-style-patch-verification: ON
 459  *
 460  * Local Variables:
 461  * eval: (c-set-style "gnu")
 462  * End:
 463  */