src/vnet/mfib/mfib_entry.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 __MFIB_ENTRY_H__
  17 #define __MFIB_ENTRY_H__
  18
  19 #include <vnet/fib/fib_node.h>
  20 #include <vnet/mfib/mfib_types.h>
  21 #include <vnet/mfib/mfib_itf.h>
  22 #include <vnet/ip/ip.h>
  23 #include <vnet/dpo/dpo.h>
  24
  25 /**
  26  * An entry in a FIB table.
  27  *
  28  * This entry represents a route added to the FIB that is stored
  29  * in one of the FIB tables.
  30  */
  31 typedef struct mfib_entry_t_ {
  32     CLIB_CACHE_LINE_ALIGN_MARK(cacheline0);
  33     /**
  34      * Base class. The entry's node representation in the graph.
  35      */
  36     fib_node_t mfe_node;
  37     /**
  38      * The prefix of the route
  39      */
  40     mfib_prefix_t mfe_prefix;
  41     /**
  42      * The index of the FIB table this entry is in
  43      */
  44     u32 mfe_fib_index;
  45
  46     /**
  47      * A vector of sources contributing forwarding
  48      */
  49     struct mfib_entry_src_t_ *mfe_srcs;
  50
  51     /**
  52      * 2nd cache line has the members used in the data plane
  53      */
  54     CLIB_CACHE_LINE_ALIGN_MARK(cacheline1);
  55
  56     /**
  57      * The DPO used for forwarding; replicate, drop, etc..
  58      */
  59     dpo_id_t mfe_rep;
  60
  61     /**
  62      * Route flags
  63      */
  64     mfib_entry_flags_t mfe_flags;
  65
  66     /**
  67      * RPF-ID used when the packets ingress not from an interface
  68      */
  69     fib_rpf_id_t mfe_rpf_id;
  70
  71     /**
  72      * A hash table of interfaces
  73      */
  74     mfib_itf_t *mfe_itfs;
  75 } mfib_entry_t;
  76
  77 #define MFIB_ENTRY_FORMAT_BRIEF   (0x0)
  78 #define MFIB_ENTRY_FORMAT_DETAIL  (0x1)
  79 #define MFIB_ENTRY_FORMAT_DETAIL2 (0x2)
  80
  81 extern u8 *format_mfib_entry(u8 * s, va_list * args);
  82
  83
  84 extern fib_node_index_t mfib_entry_create(u32 fib_index,
  85                                           mfib_source_t source,
  86                                           const mfib_prefix_t *prefix,
  87                                           fib_rpf_id_t rpf_id,
  88                                           mfib_entry_flags_t entry_flags);
  89
  90 extern int mfib_entry_update(fib_node_index_t fib_entry_index,
  91                              mfib_source_t source,
  92                              mfib_entry_flags_t entry_flags,
  93                              fib_rpf_id_t rpf_id,
  94                              index_t rep_dpo);
  95
  96 extern void mfib_entry_path_update(fib_node_index_t fib_entry_index,
  97                                    mfib_source_t source,
  98                                    const fib_route_path_t *rpath,
  99                                    mfib_itf_flags_t itf_flags);
 100
 101
 102 extern int mfib_entry_path_remove(fib_node_index_t fib_entry_index,
 103                                   mfib_source_t source,
 104                                   const fib_route_path_t *rpath);
 105
 106 extern int mfib_entry_delete(fib_node_index_t mfib_entry_index,
 107                              mfib_source_t source);
 108
 109 extern int mfib_entry_cmp_for_sort(void *i1, void *i2);
 110
 111 extern u32 mfib_entry_child_add(fib_node_index_t mfib_entry_index,
 112                                 fib_node_type_t type,
 113                                 fib_node_index_t child_index);
 114 extern void mfib_entry_child_remove(fib_node_index_t mfib_entry_index,
 115                                     u32 sibling_index);
 116
 117 extern void mfib_entry_lock(fib_node_index_t fib_entry_index);
 118 extern void mfib_entry_unlock(fib_node_index_t fib_entry_index);
 119
 120 extern void mfib_entry_get_prefix(fib_node_index_t fib_entry_index,
 121                                   mfib_prefix_t *pfx);
 122 extern u32 mfib_entry_get_fib_index(fib_node_index_t fib_entry_index);
 123
 124 extern void mfib_entry_contribute_forwarding(
 125     fib_node_index_t mfib_entry_index,
 126     fib_forward_chain_type_t type,
 127     dpo_id_t *dpo);
 128
 129 extern void mfib_entry_encode(fib_node_index_t fib_entry_index,
 130                               fib_route_path_encode_t **api_rpaths);
 131
 132 extern void mfib_entry_module_init(void);
 133
 134
 135 extern mfib_entry_t *mfib_entry_pool;
 136
 137 static inline mfib_entry_t *
 138 mfib_entry_get (fib_node_index_t index)
 139 {
 140     return (pool_elt_at_index(mfib_entry_pool, index));
 141 }
 142 static inline fib_node_index_t
 143 mfib_entry_get_index (const mfib_entry_t *mfe)
 144 {
 145     return (mfe - mfib_entry_pool);
 146 }
 147
 148
 149 static inline mfib_itf_t *
 150 mfib_entry_itf_find (mfib_itf_t *itfs,
 151                      u32 sw_if_index)
 152 {
 153     uword *p;
 154
 155     p = hash_get(itfs, sw_if_index);
 156
 157     if (NULL != p)
 158     {
 159         return (mfib_itf_get(p[0]));
 160     }
 161
 162     return (NULL);
 163 }
 164
 165 static inline mfib_itf_t *
 166 mfib_entry_get_itf (const mfib_entry_t *mfe,
 167                     u32 sw_if_index)
 168 {
 169     return (mfib_entry_itf_find(mfe->mfe_itfs, sw_if_index));
 170 }
 171
 172 #endif