Ethernet MAC Address FIB Table Management. More...

Include dependency graph for l2_fib.c:

Data Structures
struct	l2fib_dump_walk_ctx_t_

struct	l2fib_show_walk_ctx_t_

Macros
#define	vl_endianfun

Typedefs
typedef struct l2fib_dump_walk_ctx_t_	l2fib_dump_walk_ctx_t

typedef struct l2fib_show_walk_ctx_t_	l2fib_show_walk_ctx_t

Functions
u8 *	format_l2fib_entry_result_flags (u8 s, va_list args)

static void	incr_mac_address (u8 *mac)

u8 *	format_vnet_sw_if_index_name_with_NA (u8 s, va_list args)
	Format sw_if_index. More...

static int	l2fib_dump_walk_cb (BVT(clib_bihash_kv) kvp, void arg)

void	l2fib_table_dump (u32 bd_index, l2fib_entry_key_t l2fe_key, l2fib_entry_result_t l2fe_res)

void	l2_fib_extract_seq_num (l2fib_seq_num_t sn, u8 bd_sn, u8 if_sn)

u8 *	format_l2_fib_seq_num (u8 s, va_list a)

static int	l2fib_show_walk_cb (BVT(clib_bihash_kv) kvp, void arg)

static clib_error_t *	show_l2fib (vlib_main_t vm, unformat_input_t input, vlib_cli_command_t *cmd)
	Display the contents of the l2fib. More...

void	l2fib_table_init (void)

void	l2fib_clear_table (void)

static clib_error_t *	clear_l2fib (vlib_main_t vm, unformat_input_t input, vlib_cli_command_t *cmd)
	Clear all entries in L2FIB. More...

static l2fib_seq_num_t	l2fib_cur_seq_num (u32 bd_index, u32 sw_if_index)

void	l2fib_add_entry (const u8 *mac, u32 bd_index, u32 sw_if_index, l2fib_entry_result_flags_t flags)
	Add an entry to the l2fib. More...

static clib_error_t *	l2fib_add (vlib_main_t vm, unformat_input_t input, vlib_cli_command_t *cmd)
	Add an entry to the L2FIB. More...

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

u32	l2fib_del_entry (const u8 *mac, u32 bd_index, u32 sw_if_index)
	Delete an entry from the l2fib. More...

static clib_error_t *	l2fib_del (vlib_main_t vm, unformat_input_t input, vlib_cli_command_t *cmd)
	Delete an entry from the L2FIB. More...

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

void	l2fib_start_ager_scan (vlib_main_t *vm)
	Kick off ager to scan MACs to age/delete MAC entries. More...

void	l2fib_flush_int_mac (vlib_main_t *vm, u32 sw_if_index)
	Flush all non static MACs from an interface. More...

void	l2fib_flush_bd_mac (vlib_main_t *vm, u32 bd_index)
	Flush all non static MACs in a bridge domain. More...

void	l2fib_flush_all_mac (vlib_main_t *vm)
	Flush all non static MACs - flushes all valid BDs. More...

static clib_error_t *	l2fib_flush_mac_int (vlib_main_t vm, unformat_input_t input, vlib_cli_command_t *cmd)
	Flush MACs, except static ones, associated with an interface The CLI format is: l2fib flush-mac interface <if-name> More...

static clib_error_t *	l2fib_flush_mac_all (vlib_main_t vm, unformat_input_t input, vlib_cli_command_t *cmd)
	Flush all MACs, except static ones The CLI format is: l2fib flush-mac all. More...

static clib_error_t *	l2fib_flush_mac_bd (vlib_main_t vm, unformat_input_t input, vlib_cli_command_t *cmd)
	Flush bridge-domain MACs except static ones. More...

clib_error_t *	l2fib_sw_interface_up_down (vnet_main_t *vnm, u32 sw_if_index, u32 flags)

	VNET_SW_INTERFACE_ADMIN_UP_DOWN_FUNCTION (l2fib_sw_interface_up_down)

	BVT (clib_bihash)
	The table of adjacencies indexed by the rewrite string. More...

static_always_inline void *	allocate_mac_evt_buf (u32 client, u32 client_index)

static_always_inline f64	l2fib_scan (vlib_main_t *vm, f64 start_time, u8 event_only)

static uword	l2fib_mac_age_scanner_process (vlib_main_t vm, vlib_node_runtime_t rt, vlib_frame_t *f)

clib_error_t *	l2fib_init (vlib_main_t *vm)

static clib_error_t *	lfib_config (vlib_main_t vm, unformat_input_t input)

Variables
l2fib_main_t	l2fib_main

static vlib_cli_command_t	show_l2fib_cli
	(constructor) VLIB_CLI_COMMAND (show_l2fib_cli) More...

static vlib_cli_command_t	clear_l2fib_cli
	(constructor) VLIB_CLI_COMMAND (clear_l2fib_cli) More...

static vlib_cli_command_t	l2fib_add_cli
	(constructor) VLIB_CLI_COMMAND (l2fib_add_cli) More...

static vlib_cli_command_t	l2fib_test_command
	(constructor) VLIB_CLI_COMMAND (l2fib_test_command) More...

static vlib_cli_command_t	l2fib_del_cli
	(constructor) VLIB_CLI_COMMAND (l2fib_del_cli) More...

static vlib_cli_command_t	l2fib_set_scan_delay_cli
	(constructor) VLIB_CLI_COMMAND (l2fib_set_scan_delay_cli) More...

static vlib_cli_command_t	l2fib_flush_mac_all_cli
	(constructor) VLIB_CLI_COMMAND (l2fib_flush_mac_all_cli) More...

static vlib_cli_command_t	l2fib_flush_mac_int_cli
	(constructor) VLIB_CLI_COMMAND (l2fib_flush_mac_int_cli) More...

static vlib_cli_command_t	l2fib_flush_mac_bd_cli
	(constructor) VLIB_CLI_COMMAND (l2fib_flush_mac_bd_cli) More...

vlib_node_registration_t	l2fib_mac_age_scanner_process_node
	(constructor) VLIB_REGISTER_NODE (l2fib_mac_age_scanner_process_node) More...

Detailed Description

Ethernet MAC Address FIB Table Management.

The MAC Address forwarding table for bridge-domains is called the l2fib. Entries are added automatically as part of mac learning, but MAC Addresses entries can also be added manually.

Definition in file l2_fib.c.

Macro Definition Documentation

◆ vl_endianfun

#define vl_endianfun

Definition at line 36 of file l2_fib.c.

Typedef Documentation

◆ l2fib_dump_walk_ctx_t

typedef struct l2fib_dump_walk_ctx_t_ l2fib_dump_walk_ctx_t

◆ l2fib_show_walk_ctx_t

typedef struct l2fib_show_walk_ctx_t_ l2fib_show_walk_ctx_t

Function Documentation

◆ allocate_mac_evt_buf()

static_always_inline void* allocate_mac_evt_buf	(	u32	client,
		u32	client_index
	)

Definition at line 1072 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ BVT()

BVT ( clib_bihash )

The table of adjacencies indexed by the rewrite string.

Definition at line 1065 of file l2_fib.c.

Here is the caller graph for this function:

◆ clear_l2fib()

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

static

Clear all entries in L2FIB.

@TODO: Later we may want a way to remove only the non-static entries

Definition at line 401 of file l2_fib.c.

Here is the call graph for this function:

◆ format_l2_fib_seq_num()

u8* format_l2_fib_seq_num	(	u8 *	s,
		va_list *	a
	)

Definition at line 153 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ format_l2fib_entry_result_flags()

u8* format_l2fib_entry_result_flags	(	u8 *	s,
		va_list *	args
	)

Definition at line 53 of file l2_fib.c.

Here is the caller graph for this function:

◆ format_vnet_sw_if_index_name_with_NA()

u8* format_vnet_sw_if_index_name_with_NA	(	u8 *	s,
		va_list *	args
	)

Format sw_if_index.

If the value is ~0, use the text "N/A"

Definition at line 86 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ incr_mac_address()

static void incr_mac_address ( u8 * mac )

static

Definition at line 74 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2_fib_extract_seq_num()

void l2_fib_extract_seq_num	(	l2fib_seq_num_t	sn,
		u8 *	bd_sn,
		u8 *	if_sn
	)

Definition at line 146 of file l2_fib.c.

Here is the caller graph for this function:

◆ l2fib_add()

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

static

Add an entry to the L2FIB.

The CLI format is: l2fib add <mac> <bd> <intf> [static] [bvi] l2fib add <mac> <bd> filter Note that filter and bvi entries are always static

Definition at line 501 of file l2_fib.c.

Here is the call graph for this function:

◆ l2fib_add_entry()

void l2fib_add_entry	(	const u8 *	mac,
		u32	bd_index,
		u32	sw_if_index,
		l2fib_entry_result_flags_t	flags
	)

Add an entry to the l2fib.

If the entry already exists then overwrite it

Definition at line 441 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_clear_table()

void l2fib_clear_table ( void )

Definition at line 379 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_cur_seq_num()

static l2fib_seq_num_t l2fib_cur_seq_num	(	u32	bd_index,
		u32	sw_if_index
	)

static

Definition at line 428 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_del()

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

static

Delete an entry from the L2FIB.

The CLI format is: l2fib del <mac> <bd-id>

Definition at line 785 of file l2_fib.c.

Here is the call graph for this function:

◆ l2fib_del_entry()

u32 l2fib_del_entry	(	const u8 *	mac,
		u32	bd_index,
		u32	sw_if_index
	)

Delete an entry from the l2fib.

Return 0 if the entry was deleted, or 1 it was not found or if sw_if_index is non-zero and does not match that in the entry.

Definition at line 742 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_dump_walk_cb()

static int l2fib_dump_walk_cb	(	BVT(clib_bihash_kv) *	kvp,
		void *	arg
	)

static

Definition at line 110 of file l2_fib.c.

Here is the caller graph for this function:

◆ l2fib_flush_all_mac()

void l2fib_flush_all_mac ( vlib_main_t * vm )

Flush all non static MACs - flushes all valid BDs.

Definition at line 922 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_flush_bd_mac()

void l2fib_flush_bd_mac	(	vlib_main_t *	vm,
		u32	bd_index
	)

Flush all non static MACs in a bridge domain.

Definition at line 911 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_flush_int_mac()

void l2fib_flush_int_mac	(	vlib_main_t *	vm,
		u32	sw_if_index
	)

Flush all non static MACs from an interface.

Definition at line 901 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_flush_mac_all()

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

static

Flush all MACs, except static ones The CLI format is: l2fib flush-mac all.

Definition at line 965 of file l2_fib.c.

Here is the call graph for this function:

◆ l2fib_flush_mac_bd()

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

static

Flush bridge-domain MACs except static ones.

The CLI format is: l2fib flush-mac bridge-domain <bd-id>

Definition at line 1010 of file l2_fib.c.

Here is the call graph for this function:

◆ l2fib_flush_mac_int()

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

static

Flush MACs, except static ones, associated with an interface The CLI format is: l2fib flush-mac interface <if-name>

Definition at line 939 of file l2_fib.c.

Here is the call graph for this function:

◆ l2fib_init()

clib_error_t* l2fib_init ( vlib_main_t * vm )

Definition at line 1378 of file l2_fib.c.

Here is the call graph for this function:

◆ l2fib_mac_age_scanner_process()

static uword l2fib_mac_age_scanner_process	(	vlib_main_t *	vm,
		vlib_node_runtime_t *	rt,
		vlib_frame_t *	f
	)

static

Definition at line 1297 of file l2_fib.c.

Here is the call graph for this function:

◆ l2fib_scan()

static_always_inline f64 l2fib_scan	(	vlib_main_t *	vm,
		f64	start_time,
		u8	event_only
	)

Definition at line 1084 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_set_scan_delay()

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

static

Definition at line 845 of file l2_fib.c.

Here is the call graph for this function:

◆ l2fib_show_walk_cb()

static int l2fib_show_walk_cb	(	BVT(clib_bihash_kv) *	kvp,
		void *	arg
	)

static

Definition at line 179 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_start_ager_scan()

void l2fib_start_ager_scan ( vlib_main_t * vm )

Kick off ager to scan MACs to age/delete MAC entries.

Definition at line 878 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_sw_interface_up_down()

clib_error_t* l2fib_sw_interface_up_down	(	vnet_main_t *	vnm,
		u32	sw_if_index,
		u32	flags
	)

Definition at line 1054 of file l2_fib.c.

Here is the call graph for this function:

◆ l2fib_table_dump()

void l2fib_table_dump	(	u32	bd_index,
		l2fib_entry_key_t **	l2fe_key,
		l2fib_entry_result_t **	l2fe_res
	)

Definition at line 129 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_table_init()

void l2fib_table_init ( void )

Definition at line 365 of file l2_fib.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ l2fib_test_command_fn()

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

static

Definition at line 606 of file l2_fib.c.

Here is the call graph for this function:

◆ lfib_config()

static clib_error_t* lfib_config	(	vlib_main_t *	vm,
		unformat_input_t *	input
	)

static

Definition at line 1406 of file l2_fib.c.

Here is the call graph for this function:

◆ show_l2fib()

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

static

Display the contents of the l2fib.

Definition at line 244 of file l2_fib.c.

Here is the call graph for this function:

◆ VNET_SW_INTERFACE_ADMIN_UP_DOWN_FUNCTION()

VNET_SW_INTERFACE_ADMIN_UP_DOWN_FUNCTION ( l2fib_sw_interface_up_down )

Variable Documentation

◆ clear_l2fib_cli

vlib_cli_command_t clear_l2fib_cli

static

Initial value:

= {
  .path = "clear l2fib",
  .short_help = "clear l2fib",
  .function = clear_l2fib,
}

(constructor) VLIB_CLI_COMMAND (clear_l2fib_cli)

Definition at line 420 of file l2_fib.c.

◆ l2fib_add_cli

vlib_cli_command_t l2fib_add_cli

static

Initial value:

= {
  .path = "l2fib add",
  .short_help = "l2fib add <mac> <bridge-domain-id> filter | <intf> [static | bvi]",
  .function = l2fib_add,
}

(constructor) VLIB_CLI_COMMAND (l2fib_add_cli)

Definition at line 597 of file l2_fib.c.

◆ l2fib_del_cli

vlib_cli_command_t l2fib_del_cli

static

Initial value:

= {
  .path = "l2fib del",
  .short_help = "l2fib del <mac> <bridge-domain-id> []",
  .function = l2fib_del,
}

(constructor) VLIB_CLI_COMMAND (l2fib_del_cli)

Definition at line 837 of file l2_fib.c.

◆ l2fib_flush_mac_all_cli

vlib_cli_command_t l2fib_flush_mac_all_cli

static

Initial value:

= {
  .path = "l2fib flush-mac all",
  .short_help = "l2fib flush-mac all",
  .function = l2fib_flush_mac_all,
}

(constructor) VLIB_CLI_COMMAND (l2fib_flush_mac_all_cli)

Definition at line 981 of file l2_fib.c.

◆ l2fib_flush_mac_bd_cli

vlib_cli_command_t l2fib_flush_mac_bd_cli

static

Initial value:

= {
  .path = "l2fib flush-mac bridge-domain",
  .short_help = "l2fib flush-mac bridge-domain <bd-id>",
  .function = l2fib_flush_mac_bd,
}

(constructor) VLIB_CLI_COMMAND (l2fib_flush_mac_bd_cli)

Definition at line 1046 of file l2_fib.c.

◆ l2fib_flush_mac_int_cli

vlib_cli_command_t l2fib_flush_mac_int_cli

static

Initial value:

= {
  .path = "l2fib flush-mac interface",
  .short_help = "l2fib flush-mac interface <if-name>",
  .function = l2fib_flush_mac_int,
}

(constructor) VLIB_CLI_COMMAND (l2fib_flush_mac_int_cli)

Definition at line 997 of file l2_fib.c.

◆ l2fib_mac_age_scanner_process_node

vlib_node_registration_t l2fib_mac_age_scanner_process_node

Initial value:

= {
    .function = l2fib_mac_age_scanner_process,
    .type = VLIB_NODE_TYPE_PROCESS,
    .name = "l2fib-mac-age-scanner-process",
}

(constructor) VLIB_REGISTER_NODE (l2fib_mac_age_scanner_process_node)

Definition at line 1370 of file l2_fib.c.

◆ l2fib_main

l2fib_main_t l2fib_main

Definition at line 50 of file l2_fib.c.

◆ l2fib_set_scan_delay_cli

vlib_cli_command_t l2fib_set_scan_delay_cli

static

Initial value:

= {
  .path = "set l2fib scan-delay",
  .short_help = "set l2fib scan-delay <delay>",
  .function = l2fib_set_scan_delay,
}

(constructor) VLIB_CLI_COMMAND (l2fib_set_scan_delay_cli)

Definition at line 868 of file l2_fib.c.

◆ l2fib_test_command

vlib_cli_command_t l2fib_test_command

static

Initial value:

= {
  .path = "test l2fib",
  .short_help = "test l2fib [add|del|check] mac <base-addr> count <nn>",
  .function = l2fib_test_command_fn,
}

(constructor) VLIB_CLI_COMMAND (l2fib_test_command)

Definition at line 728 of file l2_fib.c.

◆ show_l2fib_cli

vlib_cli_command_t show_l2fib_cli

static

Initial value:

= {
  .path = "show l2fib",
  .short_help = "show l2fib [all] | [bd_id <nn> | bd_index <nn>] [learn | add] | [raw]",
  .function = show_l2fib,
}

(constructor) VLIB_CLI_COMMAND (show_l2fib_cli)

Definition at line 357 of file l2_fib.c.

Data Structures

Macros

Typedefs

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ vl_endianfun

Typedef Documentation

◆ l2fib_dump_walk_ctx_t

◆ l2fib_show_walk_ctx_t

Function Documentation

◆ allocate_mac_evt_buf()

◆ BVT()

◆ clear_l2fib()

◆ format_l2_fib_seq_num()

◆ format_l2fib_entry_result_flags()

◆ format_vnet_sw_if_index_name_with_NA()

◆ incr_mac_address()

◆ l2_fib_extract_seq_num()

◆ l2fib_add()

◆ l2fib_add_entry()

◆ l2fib_clear_table()

◆ l2fib_cur_seq_num()

◆ l2fib_del()

◆ l2fib_del_entry()

◆ l2fib_dump_walk_cb()

◆ l2fib_flush_all_mac()

◆ l2fib_flush_bd_mac()

◆ l2fib_flush_int_mac()

◆ l2fib_flush_mac_all()

◆ l2fib_flush_mac_bd()

◆ l2fib_flush_mac_int()

◆ l2fib_init()

◆ l2fib_mac_age_scanner_process()

◆ l2fib_scan()

◆ l2fib_set_scan_delay()

◆ l2fib_show_walk_cb()

◆ l2fib_start_ager_scan()

◆ l2fib_sw_interface_up_down()

◆ l2fib_table_dump()

◆ l2fib_table_init()

◆ l2fib_test_command_fn()

◆ lfib_config()

◆ show_l2fib()

◆ VNET_SW_INTERFACE_ADMIN_UP_DOWN_FUNCTION()

Variable Documentation

◆ clear_l2fib_cli

◆ l2fib_add_cli

◆ l2fib_del_cli

◆ l2fib_flush_mac_all_cli

◆ l2fib_flush_mac_bd_cli

◆ l2fib_flush_mac_int_cli

◆ l2fib_mac_age_scanner_process_node

◆ l2fib_main

◆ l2fib_set_scan_delay_cli

◆ l2fib_test_command

◆ show_l2fib_cli