src/vnet/mfib/mfib_itf.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_ITF_H__
  17 #define __MFIB_ITF_H__
  18
  19 #include <vlib/vlib.h>
  20 #include <vnet/mfib/mfib_types.h>
  21
  22 /**
  23  * @brief An interface associated with a particular MFIB entry
  24  */
  25 typedef struct mfib_itf_t_
  26 {
  27     /**
  28      * @brief Forwarding Flags on the entry - checked in the data-path
  29      */
  30     mfib_itf_flags_t mfi_flags;
  31
  32     /**
  33      * The SW IF index that this MFIB interface represents
  34      */
  35     u32 mfi_sw_if_index;
  36
  37     /**
  38      * The index of the signal in the pending list
  39      */
  40     u32 mfi_si;
  41
  42     /**
  43      * A hash table of path-inidices that are contributing flags to this interface.
  44      * Since paths with next-hops can be on the same interface and each of those
  45      * paths can contribute different flags, we need to maintain the flag
  46      * contribution from each path, and use a combination for forwarding.
  47      */
  48     uword *mfi_hash;
  49 } mfib_itf_t;
  50
  51 /**
  52  * update an interface from a path.
  53  * returns 1 if the entry is removed, i.e. has no flags left, as a result
  54  * of the update.
  55  */
  56 extern int mfib_itf_update(mfib_itf_t *itf,
  57                            fib_node_index_t path_index,
  58                            mfib_itf_flags_t mfi_flags);
  59
  60 extern index_t mfib_itf_create(fib_node_index_t path_index,
  61                                mfib_itf_flags_t mfi_flags);
  62
  63 extern void mfib_itf_delete(mfib_itf_t *itf);
  64
  65 extern u8 *format_mfib_itf(u8 * s, va_list * args);
  66
  67 extern mfib_itf_t *mfib_itf_pool;
  68
  69 /**
  70  * Get the MFIB interface representation
  71  */
  72 static inline mfib_itf_t *
  73 mfib_itf_get (index_t mi)
  74 {
  75     return (pool_elt_at_index(mfib_itf_pool, mi));
  76 }
  77
  78 static inline index_t
  79 mfib_itf_get_index (const mfib_itf_t *mfi)
  80 {
  81     return (mfi - mfib_itf_pool);
  82 }
  83
  84 #endif