src/vnet/adj/adj_mcast.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 /**
  17  * @brief Mcast Adjacency
  18  *
  19  * The multicast adjacency forwards IP traffic on an interface toward a multicast
  20  * group address. This is a different type of adjacency to a unicast adjacency
  21  * since the application of the MAC header is different, and so the VLIB node
  22  * visited is also different. DPO types have different VLIB nodes.
  23  */
  24
  25 #ifndef __ADJ_MCAST_H__
  26 #define __ADJ_MCAST_H__
  27
  28 #include <vnet/adj/adj_types.h>
  29 #include <vnet/adj/adj_midchain.h>
  30
  31 /**
  32  * @brief
  33  *  Add (and lock) a new or lock an existing mcast adjacency
  34  *
  35  * @param proto
  36  *  The protocol for the neighbours that we wish to mcast
  37  *
  38  * @param link_type
  39  *  A description of the protocol of the packets that will forward
  40  *  through this adj. On an ethernet interface this is the MAC header's
  41  *  ether-type
  42  *
  43  * @param sw_if_index
  44  *  The interface on which to mcast
  45  */
  46 extern adj_index_t adj_mcast_add_or_lock(fib_protocol_t proto,
  47                                          vnet_link_t link_type,
  48                                          u32 sw_if_index);
  49
  50 /**
  51  * @brief
  52  *  Update the rewrite string for an existing adjacecny.
  53  *
  54  * @param
  55  *  The index of the adj to update
  56  *
  57  * @param
  58  *  The new rewrite
  59  *
  60  * @param
  61  *  The offset in the rewrite a which to write in packet's
  62  *  IP Address
  63  *
  64  * @param
  65  *  The mask to apply to the packet berfore the rewrite.
  66  */
  67 extern void adj_mcast_update_rewrite(adj_index_t adj_index,
  68                                      u8 *rewrite,
  69                                      u8 offset,
  70                                      u32 mask);
  71
  72 /**
  73  * @brief
  74  *  Update the rewrite string for an existing adjacecny and
  75  *  Convert the adjacency into a midchain
  76  *
  77  * @param
  78  *  The index of the adj to update
  79  *
  80  * @param
  81  *  The new rewrite
  82  */
  83 extern void adj_mcast_midchain_update_rewrite(adj_index_t adj_index,
  84                                               adj_midchain_fixup_t fixup,
  85                                               adj_flags_t flags,
  86                                               u8 *rewrite,
  87                                               u8 offset,
  88                                               u32 mask);
  89 /**
  90  * @brief Walk the multicast Adjacencies on a given interface
  91  */
  92 extern void adj_mcast_walk (u32 sw_if_index,
  93                             fib_protocol_t adj_nh_proto,
  94                             adj_walk_cb_t cb,
  95                             void *ctx);
  96
  97 /**
  98  * @brief Format/display a mcast adjacency.
  99  */
 100 extern u8* format_adj_mcast(u8* s, va_list *ap);
 101 extern u8* format_adj_mcast_midchain(u8* s, va_list *ap);
 102
 103 /**
 104  * @brief Get the sze of the mcast adj DB. Test purposes only.
 105  */
 106 extern u32 adj_mcast_db_size(void);
 107
 108 /**
 109  * @brief
 110  *  Module initialisation
 111  */
 112 extern void adj_mcast_module_init(void);
 113
 114 #endif