FD.io VPP  v18.07.1-19-g511ce25
Vector Packet Processing
fib_path_list.h
Go to the documentation of this file.
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 __FIB_PATH_LIST_H__
17 #define __FIB_PATH_LIST_H__
18 
19 #include <vlib/vlib.h>
20 #include <vnet/adj/adj.h>
21 
22 #include <vnet/fib/fib_node.h>
23 #include <vnet/fib/fib_path.h>
24 
25 /**
26  * Enumeration of path-list flags.
27  */
29  /**
30  * Marker. Add new flags after this one.
31  */
33  /**
34  * This path list is shareable. Shareable path-lists
35  * are inserted into the path-list data-base.
36  * All path-list are inherently shareable, the reason we share some and
37  * not others is to limit the size of the path-list database. This DB must
38  * be searched for each route update.
39  */
41  /**
42  * explicit drop path-list. Used when the entry source needs to
43  * force a drop, despite the fact the path info is present.
44  */
46  /**
47  * explicit local path-list.
48  */
50  /**
51  * exclusive path-list. Exclusive means the path will resolve via the
52  * exclusive (user provided) adj.
53  */
55  /**
56  * resolved path-list
57  */
59  /**
60  * looped path-list. one path looped implies the whole list is
61  */
63  /**
64  * a popular path-ist is one that is shared amongst many entries.
65  * Path list become popular as they gain more children, but they
66  * don't become unpopular as they lose them.
67  */
69  /**
70  * no uRPF - do not generate unicast RPF list for this path-list
71  */
73  /**
74  * Marher. Add new flags before this one, and then update it.
75  */
78 
79 typedef enum fib_path_list_flags_t_ {
90 
91 #define FIB_PATH_LIST_ATTRIBUTES { \
92  [FIB_PATH_LIST_ATTRIBUTE_SHARED] = "shared", \
93  [FIB_PATH_LIST_ATTRIBUTE_RESOLVED] = "resolved", \
94  [FIB_PATH_LIST_ATTRIBUTE_DROP] = "drop", \
95  [FIB_PATH_LIST_ATTRIBUTE_EXCLUSIVE] = "exclusive", \
96  [FIB_PATH_LIST_ATTRIBUTE_LOCAL] = "local", \
97  [FIB_PATH_LIST_ATTRIBUTE_LOOPED] = "looped", \
98  [FIB_PATH_LIST_ATTRIBUTE_POPULAR] = "popular", \
99  [FIB_PATH_LIST_ATTRIBUTE_NO_URPF] = "no-uRPF", \
100 }
101 
102 #define FOR_EACH_PATH_LIST_ATTRIBUTE(_item) \
103  for (_item = FIB_PATH_LIST_ATTRIBUTE_FIRST; \
104  _item <= FIB_PATH_LIST_ATTRIBUTE_LAST; \
105  _item++)
106 
108  const fib_route_path_t *paths);
111  const dpo_id_t *dpo);
112 
114  fib_node_index_t pl_index,
116  const fib_route_path_t *path);
118  fib_node_index_t pl_index,
120  const fib_route_path_t *path);
122  fib_node_index_t path_list_index,
123  const fib_route_path_t *rpaths);
125  fib_node_index_t path_list_index,
126  const fib_route_path_t *rpaths);
127 
129 
130 /**
131  * Flags to control how the path-list returns forwarding information
132  */
134 {
138 
139 extern void fib_path_list_contribute_forwarding(fib_node_index_t path_list_index,
142  dpo_id_t *dpo);
143 extern void fib_path_list_contribute_urpf(fib_node_index_t path_index,
144  index_t urpf);
145 extern index_t fib_path_list_get_urpf(fib_node_index_t path_list_index);
146 extern index_t fib_path_list_get_adj(fib_node_index_t path_list_index,
148 
150  fib_node_type_t type,
151  fib_node_index_t child_index);
152 extern void fib_path_list_child_remove(fib_node_index_t pl_index,
153  fib_node_index_t sibling_index);
154 extern void fib_path_list_back_walk(fib_node_index_t pl_index,
156 extern void fib_path_list_lock(fib_node_index_t pl_index);
157 extern void fib_path_list_unlock(fib_node_index_t pl_index);
158 extern int fib_path_list_recursive_loop_detect(fib_node_index_t path_list_index,
159  fib_node_index_t **entry_indicies);
161 extern int fib_path_list_is_looped(fib_node_index_t path_list_index);
162 extern int fib_path_list_is_popular(fib_node_index_t path_list_index);
164 extern u8 * fib_path_list_format(fib_node_index_t pl_index,
165  u8 * s);
166 extern u8 * format_fib_path_list(u8 * s, va_list *args);
167 
169  const fib_node_index_t *pis);
170 extern u32 fib_path_list_find_rpath (fib_node_index_t path_list_index,
171  const fib_route_path_t *rpath);
172 
173 /**
174  * A callback function type for walking a path-list's paths
175  */
177  fib_node_index_t pl_index,
178  fib_node_index_t path_index,
179  void *ctx);
180 
181 extern void fib_path_list_walk(fib_node_index_t pl_index,
183  void *ctx);
184 
185 extern void fib_path_list_module_init(void);
186 
187 extern void fib_path_list_module_init(void);
188 
189 /*
190  * functions for testing.
191  */
194 
195 #endif
void fib_path_list_back_walk(fib_node_index_t pl_index, fib_node_back_walk_ctx_t *ctx)
int fib_path_list_recursive_loop_detect(fib_node_index_t path_list_index, fib_node_index_t **entry_indicies)
int fib_path_list_is_looped(fib_node_index_t path_list_index)
A representation of a path as described by a route producer.
Definition: fib_types.h:460
fib_node_index_t fib_path_list_path_add(fib_node_index_t path_list_index, const fib_route_path_t *rpaths)
explicit drop path-list.
Definition: fib_path_list.h:45
int fib_path_list_is_popular(fib_node_index_t path_list_index)
u32 index_t
A Data-Path Object is an object that represents actions that are applied to packets are they are swit...
Definition: dpo.h:41
u32 fib_path_list_get_n_paths(fib_node_index_t pl_index)
void fib_path_list_contribute_forwarding(fib_node_index_t path_list_index, fib_forward_chain_type_t type, fib_path_list_fwd_flags_t flags, dpo_id_t *dpo)
fib_path_list_attribute_t_
Enumeration of path-list flags.
Definition: fib_path_list.h:28
unsigned char u8
Definition: types.h:56
dpo_proto_t fib_path_list_get_proto(fib_node_index_t path_list_index)
u32 fib_path_list_get_resolving_interface(fib_node_index_t path_list_index)
unsigned int u32
Definition: types.h:88
fib_node_index_t fib_path_list_create(fib_path_list_flags_t flags, const fib_route_path_t *paths)
enum dpo_proto_t_ dpo_proto_t
Data path protocol.
enum fib_path_list_attribute_t_ fib_path_list_attribute_t
Enumeration of path-list flags.
fib_node_index_t fib_path_list_path_remove(fib_node_index_t path_list_index, const fib_route_path_t *rpaths)
void fib_path_list_walk(fib_node_index_t pl_index, fib_path_list_walk_fn_t func, void *ctx)
The identity of a DPO is a combination of its type and its instance number/index of objects of that t...
Definition: dpo.h:168
void fib_path_list_lock(fib_node_index_t pl_index)
index_t fib_path_list_get_adj(fib_node_index_t path_list_index, fib_forward_chain_type_t type)
fib_node_index_t fib_path_list_copy_and_path_remove(fib_node_index_t pl_index, fib_path_list_flags_t flags, const fib_route_path_t *path)
a popular path-ist is one that is shared amongst many entries.
Definition: fib_path_list.h:68
fib_path_list_flags_t_
Definition: fib_path_list.h:79
This path list is shareable.
Definition: fib_path_list.h:40
u32 flags
Definition: vhost_user.h:110
explicit local path-list.
Definition: fib_path_list.h:49
fib_node_index_t fib_path_list_create_special(dpo_proto_t nh_proto, fib_path_list_flags_t flags, const dpo_id_t *dpo)
u8 * fib_path_list_format(fib_node_index_t pl_index, u8 *s)
void fib_path_list_unlock(fib_node_index_t pl_index)
u32 fib_node_index_t
A typedef of a node index.
Definition: fib_types.h:30
u32 fib_path_list_find_rpath(fib_node_index_t path_list_index, const fib_route_path_t *rpath)
index_t fib_path_list_lb_map_add_or_lock(fib_node_index_t pl_index, const fib_node_index_t *pis)
index_t fib_path_list_get_urpf(fib_node_index_t path_list_index)
Return the the child the RPF list pre-built for this path list.
enum fib_path_list_fwd_flags_t_ fib_path_list_fwd_flags_t
Flags to control how the path-list returns forwarding information.
Context passed between object during a back walk.
Definition: fib_node.h:200
u32 fib_path_list_pool_size(void)
u32 fib_path_list_child_add(fib_node_index_t pl_index, fib_node_type_t type, fib_node_index_t child_index)
long ctx[MAX_CONNS]
Definition: main.c:126
u8 * format_fib_path_list(u8 *s, va_list *args)
void fib_path_list_child_remove(fib_node_index_t pl_index, fib_node_index_t sibling_index)
enum fib_forward_chain_type_t_ fib_forward_chain_type_t
FIB output chain type.
fib_path_list_fwd_flags_t_
Flags to control how the path-list returns forwarding information.
enum fib_path_list_walk_rc_t_ fib_path_list_walk_rc_t
return code to control pat-hlist walk
void fib_path_list_contribute_urpf(fib_node_index_t path_index, index_t urpf)
Contribute (add) this path list&#39;s uRPF list.
void fib_path_list_module_init(void)
u32 fib_path_list_db_size(void)
fib_node_index_t fib_path_list_copy_and_path_add(fib_node_index_t pl_index, fib_path_list_flags_t flags, const fib_route_path_t *path)
enum fib_node_type_t_ fib_node_type_t
The types of nodes in a FIB graph.
fib_path_list_walk_rc_t(* fib_path_list_walk_fn_t)(fib_node_index_t pl_index, fib_node_index_t path_index, void *ctx)
A callback function type for walking a path-list&#39;s paths.
no uRPF - do not generate unicast RPF list for this path-list
Definition: fib_path_list.h:72
enum fib_path_list_flags_t_ fib_path_list_flags_t