FD.io VPP  v18.10-32-g1161dda
Vector Packet Processing
fib_path_list.c File Reference
+ Include dependency graph for fib_path_list.c:

Go to the source code of this file.

Data Structures

struct  fib_path_list_t_
 FIB path-list A representation of the list/set of path trough which a prefix is reachable. More...
 

Macros

#define FIB_PATH_LIST_POPULAR   64
 The magic number of child entries that make a path-list popular. More...
 
#define FIB_PATH_LIST_DBG(_pl, _fmt, _args...)
 

Typedefs

typedef struct fib_path_list_t_ fib_path_list_t
 FIB path-list A representation of the list/set of path trough which a prefix is reachable. More...
 

Functions

static fib_path_list_tfib_path_list_get (fib_node_index_t index)
 
static fib_node_tfib_path_list_get_node (fib_node_index_t index)
 
static fib_path_list_tfib_path_list_from_fib_node (fib_node_t *node)
 
static fib_node_index_t fib_path_list_get_index (fib_path_list_t *path_list)
 
u8format_fib_path_list (u8 *s, va_list *args)
 
u8fib_path_list_format (fib_node_index_t path_list_index, u8 *s)
 
static uword fib_path_list_hash (fib_path_list_t *path_list)
 
static uword fib_path_list_db_hash_key_from_index (uword index)
 
static uword fib_path_list_db_hash_key_is_index (uword key)
 
static uword fib_path_list_db_hash_key_2_index (uword key)
 
static fib_path_list_tfib_path_list_db_get_from_hash_key (uword key)
 
static uword fib_path_list_db_hash_key_sum (hash_t *h, uword key)
 
static uword fib_path_list_db_hash_key_equal (hash_t *h, uword key1, uword key2)
 
static fib_node_index_t fib_path_list_db_find (fib_path_list_t *path_list)
 
static void fib_path_list_db_insert (fib_node_index_t path_list_index)
 
static void fib_path_list_db_remove (fib_node_index_t path_list_index)
 
static void fib_path_list_destroy (fib_path_list_t *path_list)
 
static void fib_path_list_last_lock_gone (fib_node_t *node)
 
static void fib_path_list_mk_lb (fib_path_list_t *path_list, fib_forward_chain_type_t fct, dpo_id_t *dpo)
 
static void fib_path_list_mk_urpf (fib_path_list_t *path_list)
 [re]build the path list's uRPF list More...
 
void fib_path_list_contribute_urpf (fib_node_index_t path_list_index, index_t urpf)
 Contribute (add) this path list's uRPF list. More...
 
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. More...
 
void fib_path_list_back_walk (fib_node_index_t path_list_index, fib_node_back_walk_ctx_t *ctx)
 
static fib_node_back_walk_rc_t fib_path_list_back_walk_notify (fib_node_t *node, fib_node_back_walk_ctx_t *ctx)
 
static void fib_path_list_memory_show (void)
 
static fib_path_list_tfib_path_list_alloc (fib_node_index_t *path_list_index)
 
static fib_path_list_tfib_path_list_resolve (fib_path_list_t *path_list)
 
u32 fib_path_list_get_n_paths (fib_node_index_t path_list_index)
 
u32 fib_path_list_get_resolving_interface (fib_node_index_t path_list_index)
 
dpo_proto_t fib_path_list_get_proto (fib_node_index_t path_list_index)
 
int fib_path_list_is_looped (fib_node_index_t path_list_index)
 
int fib_path_list_is_popular (fib_node_index_t path_list_index)
 
static fib_path_list_flags_t fib_path_list_flags_fixup (fib_path_list_flags_t flags)
 
fib_node_index_t fib_path_list_create (fib_path_list_flags_t flags, const fib_route_path_t *rpaths)
 
static fib_path_cfg_flags_t fib_path_list_flags_2_path_flags (fib_path_list_flags_t plf)
 
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)
 
u32 fib_path_list_find_rpath (fib_node_index_t path_list_index, const fib_route_path_t *rpath)
 
fib_node_index_t fib_path_list_path_add (fib_node_index_t path_list_index, const fib_route_path_t *rpaths)
 
fib_node_index_t fib_path_list_copy_and_path_add (fib_node_index_t orig_path_list_index, fib_path_list_flags_t flags, const fib_route_path_t *rpaths)
 
fib_node_index_t fib_path_list_path_remove (fib_node_index_t path_list_index, const fib_route_path_t *rpaths)
 
fib_node_index_t fib_path_list_copy_and_path_remove (fib_node_index_t orig_path_list_index, fib_path_list_flags_t flags, const fib_route_path_t *rpath)
 
void fib_path_list_contribute_forwarding (fib_node_index_t path_list_index, fib_forward_chain_type_t fct, fib_path_list_fwd_flags_t flags, dpo_id_t *dpo)
 
adj_index_t fib_path_list_get_adj (fib_node_index_t path_list_index, fib_forward_chain_type_t type)
 
int fib_path_list_recursive_loop_detect (fib_node_index_t path_list_index, fib_node_index_t **entry_indicies)
 
u32 fib_path_list_child_add (fib_node_index_t path_list_index, fib_node_type_t child_type, fib_node_index_t child_index)
 
void fib_path_list_child_remove (fib_node_index_t path_list_index, u32 si)
 
void fib_path_list_lock (fib_node_index_t path_list_index)
 
void fib_path_list_unlock (fib_node_index_t path_list_index)
 
u32 fib_path_list_pool_size (void)
 
u32 fib_path_list_db_size (void)
 
void fib_path_list_walk (fib_node_index_t path_list_index, fib_path_list_walk_fn_t func, void *ctx)
 
void fib_path_list_module_init (void)
 
static clib_error_tshow_fib_path_list_command (vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
 

Variables

static const char * fib_path_list_attr_names [] = FIB_PATH_LIST_ATTRIBUTES
 
static fib_path_list_tfib_path_list_pool
 
static uwordfib_path_list_db
 
static const fib_node_vft_t fib_path_list_vft
 
static vlib_cli_command_t show_fib_path_list
 (constructor) VLIB_CLI_COMMAND (show_fib_path_list) More...
 

Macro Definition Documentation

#define FIB_PATH_LIST_DBG (   _pl,
  _fmt,
  _args... 
)

Definition at line 101 of file fib_path_list.c.

#define FIB_PATH_LIST_POPULAR   64

The magic number of child entries that make a path-list popular.

There's a trade-off here between convergnece and forwarding speed. Popular path-lists generate load-balance maps for the entires that use them. If the map is present there is a switch path cost to indirect through the map - this indirection provides the fast convergence - so without the map convergence is slower.

Definition at line 36 of file fib_path_list.c.

Typedef Documentation

FIB path-list A representation of the list/set of path trough which a prefix is reachable.

Function Documentation

static fib_path_list_t* fib_path_list_alloc ( fib_node_index_t path_list_index)
inlinestatic

Definition at line 521 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void fib_path_list_back_walk ( fib_node_index_t  path_list_index,
fib_node_back_walk_ctx_t ctx 
)

Definition at line 447 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static fib_node_back_walk_rc_t fib_path_list_back_walk_notify ( fib_node_t node,
fib_node_back_walk_ctx_t ctx 
)
static

Definition at line 484 of file fib_path_list.c.

u32 fib_path_list_child_add ( fib_node_index_t  path_list_index,
fib_node_type_t  child_type,
fib_node_index_t  child_index 
)

Definition at line 1223 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void fib_path_list_child_remove ( fib_node_index_t  path_list_index,
u32  si 
)

Definition at line 1262 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void fib_path_list_contribute_forwarding ( fib_node_index_t  path_list_index,
fib_forward_chain_type_t  fct,
fib_path_list_fwd_flags_t  flags,
dpo_id_t dpo 
)

Definition at line 1138 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void fib_path_list_contribute_urpf ( fib_node_index_t  path_list_index,
index_t  urpf 
)

Contribute (add) this path list's uRPF list.

This allows the child to construct an aggregate list.

Definition at line 417 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

fib_node_index_t fib_path_list_copy_and_path_add ( fib_node_index_t  orig_path_list_index,
fib_path_list_flags_t  flags,
const fib_route_path_t rpaths 
)

Definition at line 859 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

fib_node_index_t fib_path_list_copy_and_path_remove ( fib_node_index_t  orig_path_list_index,
fib_path_list_flags_t  flags,
const fib_route_path_t rpath 
)

Definition at line 1012 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

fib_node_index_t fib_path_list_create ( fib_path_list_flags_t  flags,
const fib_route_path_t rpaths 
)

Definition at line 661 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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 
)

Definition at line 753 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static fib_node_index_t fib_path_list_db_find ( fib_path_list_t path_list)
static

Definition at line 263 of file fib_path_list.c.

+ Here is the caller graph for this function:

static fib_path_list_t* fib_path_list_db_get_from_hash_key ( uword  key)
static

Definition at line 218 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static uword fib_path_list_db_hash_key_2_index ( uword  key)
inlinestatic

Definition at line 211 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static uword fib_path_list_db_hash_key_equal ( hash_t h,
uword  key1,
uword  key2 
)
static

Definition at line 249 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static uword fib_path_list_db_hash_key_from_index ( uword  index)
inlinestatic

Definition at line 199 of file fib_path_list.c.

+ Here is the caller graph for this function:

static uword fib_path_list_db_hash_key_is_index ( uword  key)
inlinestatic

Definition at line 205 of file fib_path_list.c.

+ Here is the caller graph for this function:

static uword fib_path_list_db_hash_key_sum ( hash_t h,
uword  key 
)
static

Definition at line 238 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static void fib_path_list_db_insert ( fib_node_index_t  path_list_index)
static

Definition at line 278 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static void fib_path_list_db_remove ( fib_node_index_t  path_list_index)
static

Definition at line 294 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

u32 fib_path_list_db_size ( void  )

Definition at line 1305 of file fib_path_list.c.

+ Here is the call graph for this function:

static void fib_path_list_destroy ( fib_path_list_t path_list)
static

Definition at line 309 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

u32 fib_path_list_find_rpath ( fib_node_index_t  path_list_index,
const fib_route_path_t rpath 
)

Definition at line 783 of file fib_path_list.c.

+ Here is the call graph for this function:

static fib_path_cfg_flags_t fib_path_list_flags_2_path_flags ( fib_path_list_flags_t  plf)
static

Definition at line 732 of file fib_path_list.c.

+ Here is the caller graph for this function:

static fib_path_list_flags_t fib_path_list_flags_fixup ( fib_path_list_flags_t  flags)
static

Definition at line 646 of file fib_path_list.c.

+ Here is the caller graph for this function:

u8* fib_path_list_format ( fib_node_index_t  path_list_index,
u8 s 
)

Definition at line 169 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static fib_path_list_t* fib_path_list_from_fib_node ( fib_node_t node)
static

Definition at line 117 of file fib_path_list.c.

+ Here is the caller graph for this function:

static fib_path_list_t* fib_path_list_get ( fib_node_index_t  index)
static

Definition at line 105 of file fib_path_list.c.

+ Here is the caller graph for this function:

adj_index_t fib_path_list_get_adj ( fib_node_index_t  path_list_index,
fib_forward_chain_type_t  type 
)

Definition at line 1169 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static fib_node_index_t fib_path_list_get_index ( fib_path_list_t path_list)
static

Definition at line 124 of file fib_path_list.c.

+ Here is the caller graph for this function:

u32 fib_path_list_get_n_paths ( fib_node_index_t  path_list_index)

Definition at line 574 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static fib_node_t* fib_path_list_get_node ( fib_node_index_t  index)
static

Definition at line 111 of file fib_path_list.c.

+ Here is the call graph for this function:

dpo_proto_t fib_path_list_get_proto ( fib_node_index_t  path_list_index)

Definition at line 612 of file fib_path_list.c.

+ Here is the call graph for this function:

u32 fib_path_list_get_resolving_interface ( fib_node_index_t  path_list_index)

Definition at line 590 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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.

Definition at line 431 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static uword fib_path_list_hash ( fib_path_list_t path_list)
static

Definition at line 176 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int fib_path_list_is_looped ( fib_node_index_t  path_list_index)

Definition at line 626 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int fib_path_list_is_popular ( fib_node_index_t  path_list_index)

Definition at line 636 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static void fib_path_list_last_lock_gone ( fib_node_t node)
static

Definition at line 328 of file fib_path_list.c.

+ Here is the call graph for this function:

void fib_path_list_lock ( fib_node_index_t  path_list_index)

Definition at line 1271 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static void fib_path_list_memory_show ( void  )
static

Definition at line 501 of file fib_path_list.c.

+ Here is the call graph for this function:

static void fib_path_list_mk_lb ( fib_path_list_t path_list,
fib_forward_chain_type_t  fct,
dpo_id_t dpo 
)
static

Definition at line 350 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static void fib_path_list_mk_urpf ( fib_path_list_t path_list)
static

[re]build the path list's uRPF list

Definition at line 390 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void fib_path_list_module_init ( void  )

Definition at line 1331 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

fib_node_index_t fib_path_list_path_add ( fib_node_index_t  path_list_index,
const fib_route_path_t rpaths 
)

Definition at line 810 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

fib_node_index_t fib_path_list_path_remove ( fib_node_index_t  path_list_index,
const fib_route_path_t rpaths 
)

Definition at line 960 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

u32 fib_path_list_pool_size ( void  )

Definition at line 1299 of file fib_path_list.c.

+ Here is the call graph for this function:

int fib_path_list_recursive_loop_detect ( fib_node_index_t  path_list_index,
fib_node_index_t **  entry_indicies 
)

Definition at line 1179 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static fib_path_list_t* fib_path_list_resolve ( fib_path_list_t path_list)
static

Definition at line 541 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void fib_path_list_unlock ( fib_node_index_t  path_list_index)

Definition at line 1285 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void fib_path_list_walk ( fib_node_index_t  path_list_index,
fib_path_list_walk_fn_t  func,
void *  ctx 
)

Definition at line 1311 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

u8* format_fib_path_list ( u8 s,
va_list *  args 
)

Definition at line 130 of file fib_path_list.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static clib_error_t* show_fib_path_list_command ( vlib_main_t vm,
unformat_input_t input,
vlib_cli_command_t cmd 
)
static

Definition at line 1345 of file fib_path_list.c.

+ Here is the call graph for this function:

Variable Documentation

const char* fib_path_list_attr_names[] = FIB_PATH_LIST_ATTRIBUTES
static

Definition at line 73 of file fib_path_list.c.

uword* fib_path_list_db
static

Definition at line 83 of file fib_path_list.c.

fib_path_list_t* fib_path_list_pool
static

Definition at line 78 of file fib_path_list.c.

const fib_node_vft_t fib_path_list_vft
static
Initial value:
= {
.fnv_last_lock = fib_path_list_last_lock_gone,
.fnv_mem_show = fib_path_list_memory_show,
}
static fib_node_back_walk_rc_t fib_path_list_back_walk_notify(fib_node_t *node, fib_node_back_walk_ctx_t *ctx)
static void fib_path_list_last_lock_gone(fib_node_t *node)
static void fib_path_list_memory_show(void)
static fib_node_t * fib_path_list_get_node(fib_node_index_t index)

Definition at line 513 of file fib_path_list.c.

vlib_cli_command_t show_fib_path_list
static
Initial value:
= {
.path = "show fib path-lists",
.short_help = "show fib path-lists",
}
static clib_error_t * show_fib_path_list_command(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)

(constructor) VLIB_CLI_COMMAND (show_fib_path_list)

Definition at line 1385 of file fib_path_list.c.