arp.c File Reference

IPv4 ARP. More...

Include dependency graph for arp.c:

Go to the source code of this file.

Data Structures
struct	ethernet_arp_ip4_entry_t
struct	ethernet_arp_interface_t_
	Per-interface ARP configuration and state. More...
struct	ethernet_proxy_arp_t
struct	pending_resolution_t
struct	ethernet_arp_main_t
struct	vnet_arp_set_ip4_over_ethernet_rpc_args_t
struct	ethernet_arp_input_trace_t
struct	pg_ethernet_arp_header_t

Macros
#define	ETHERNET_ARP_IP4_ENTRY_FLAG_STATIC   (1 << 0)
#define	ETHERNET_ARP_IP4_ENTRY_FLAG_DYNAMIC   (1 << 1)
#define	ETHERNET_ARP_ARGS_REMOVE   (1<<0)
#define	ETHERNET_ARP_ARGS_FLUSH   (1<<1)
#define	ETHERNET_ARP_ARGS_POPULATE   (1<<2)
#define	foreach_ethernet_arp_error

Typedefs
typedef struct ethernet_arp_interface_t_	ethernet_arp_interface_t
	Per-interface ARP configuration and state. More...

Enumerations
enum	arp_input_next_t { ARP_INPUT_NEXT_DROP, ARP_INPUT_NEXT_REPLY_TX, ARP_INPUT_N_NEXT }
enum	ethernet_arp_input_error_t { ETHERNET_ARP_N_ERROR }
enum	arp_term_next_t { ARP_TERM_NEXT_L2_OUTPUT, ARP_TERM_NEXT_DROP, ARP_TERM_N_NEXT }

Functions
void	vl_api_rpc_call_main_thread (void *fp, u8 *data, u32 data_length)
static void	set_ip4_over_ethernet_rpc_callback (vnet_arp_set_ip4_over_ethernet_rpc_args_t *a)
static u8 *	format_ethernet_arp_hardware_type (u8 *s, va_list *va)
static u8 *	format_ethernet_arp_opcode (u8 *s, va_list *va)
static uword	unformat_ethernet_arp_opcode_host_byte_order (unformat_input_t *input, va_list *args)
static uword	unformat_ethernet_arp_opcode_net_byte_order (unformat_input_t *input, va_list *args)
static u8 *	format_ethernet_arp_header (u8 *s, va_list *va)
static u8 *	format_ethernet_arp_ip4_entry (u8 *s, va_list *va)
static u8 *	format_ethernet_arp_input_trace (u8 *s, va_list *va)
static u8 *	format_arp_term_input_trace (u8 *s, va_list *va)
static void	arp_nbr_probe (ip_adjacency_t *adj)
static void	arp_mk_complete (adj_index_t ai, ethernet_arp_ip4_entry_t *e)
static void	arp_mk_incomplete (adj_index_t ai, ethernet_arp_ip4_entry_t *e)
static ethernet_arp_ip4_entry_t *	arp_entry_find (ethernet_arp_interface_t *eai, const ip4_address_t *addr)
static adj_walk_rc_t	arp_mk_complete_walk (adj_index_t ai, void *ctx)
static adj_walk_rc_t	arp_mk_incomplete_walk (adj_index_t ai, void *ctx)
void	arp_update_adjacency (vnet_main_t *vnm, u32 sw_if_index, u32 ai)
int	vnet_arp_set_ip4_over_ethernet_internal (vnet_main_t *vnm, vnet_arp_set_ip4_over_ethernet_rpc_args_t *args)
void	vnet_register_ip4_arp_resolution_event (vnet_main_t *vnm, void *address_arg, uword node_index, uword type_opaque, uword data)
int	vnet_add_del_ip4_arp_change_event (vnet_main_t *vnm, void *data_callback, u32 pid, void *address_arg, uword node_index, uword type_opaque, uword data, int is_add)
static void	unset_random_arp_entry (void)
static void	arp_unnumbered (vlib_buffer_t *p0, u32 pi0, ethernet_header_t *eth0, u32 sw_if_index)
static uword	arp_input (vlib_main_t *vm, vlib_node_runtime_t *node, vlib_frame_t *frame)
static int	ip4_arp_entry_sort (void *a1, void *a2)
static clib_error_t *	show_ip4_arp (vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
static void	pg_ethernet_arp_header_init (pg_ethernet_arp_header_t *p)
uword	unformat_pg_arp_header (unformat_input_t *input, va_list *args)
clib_error_t *	ip4_set_arp_limit (u32 arp_limit)
int	vnet_arp_unset_ip4_over_ethernet (vnet_main_t *vnm, u32 sw_if_index, void *a_arg)
	Control Plane hook to remove an ARP entry. More...
static int	vnet_arp_flush_ip4_over_ethernet (vnet_main_t *vnm, u32 sw_if_index, void *a_arg)
	Internally generated event to flush the ARP cache on an interface state change event. More...
static int	vnet_arp_populate_ip4_over_ethernet (vnet_main_t *vnm, u32 sw_if_index, void *a_arg)
	Internally generated event to populate the ARP cache on an interface state change event. More...
static void	arp_add_del_interface_address (ip4_main_t *im, uword opaque, u32 sw_if_index, ip4_address_t *address, u32 address_length, u32 if_address_index, u32 is_del)
static clib_error_t *	ethernet_arp_init (vlib_main_t *vm)
static void	arp_entry_free (ethernet_arp_interface_t *eai, ethernet_arp_ip4_entry_t *e)
static int	vnet_arp_unset_ip4_over_ethernet_internal (vnet_main_t *vnm, vnet_arp_set_ip4_over_ethernet_rpc_args_t *args)
static int	vnet_arp_flush_ip4_over_ethernet_internal (vnet_main_t *vnm, vnet_arp_set_ip4_over_ethernet_rpc_args_t *args)
static int	vnet_arp_populate_ip4_over_ethernet_internal (vnet_main_t *vnm, vnet_arp_set_ip4_over_ethernet_rpc_args_t *args)
static clib_error_t *	ethernet_arp_sw_interface_up_down (vnet_main_t *vnm, u32 sw_if_index, u32 flags)
	Invoked when the interface's admin state changes. More...
	VNET_SW_INTERFACE_ADMIN_UP_DOWN_FUNCTION (ethernet_arp_sw_interface_up_down)
static void	increment_ip4_and_mac_address (ethernet_arp_ip4_over_ethernet_address_t *a)
int	vnet_arp_set_ip4_over_ethernet (vnet_main_t *vnm, u32 sw_if_index, void *a_arg, int is_static)
int	vnet_proxy_arp_add_del (ip4_address_t *lo_addr, ip4_address_t *hi_addr, u32 fib_index, int is_del)
int	vnet_proxy_arp_fib_reset (u32 fib_id)
static clib_error_t *	ip_arp_add_del_command_fn (vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
static clib_error_t *	set_int_proxy_arp_command_fn (vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
static uword	arp_term_l2bd (vlib_main_t *vm, vlib_node_runtime_t *node, vlib_frame_t *frame)
clib_error_t *	arp_term_init (vlib_main_t *vm)
void	change_arp_mac (u32 sw_if_index, ethernet_arp_ip4_entry_t *e)
void	ethernet_arp_change_mac (vnet_main_t *vnm, u32 sw_if_index)

Variables
static ethernet_arp_main_t	ethernet_arp_main
static char *	ethernet_arp_error_strings []
static vlib_node_registration_t	arp_input_node
	(constructor) VLIB_REGISTER_NODE (arp_input_node) More...
static vlib_cli_command_t	show_ip4_arp_command
	(constructor) VLIB_CLI_COMMAND (show_ip4_arp_command) More...
static vlib_cli_command_t	ip_arp_add_del_command
	(constructor) VLIB_CLI_COMMAND (ip_arp_add_del_command) More...
static vlib_cli_command_t	set_int_proxy_enable_command
	(constructor) VLIB_CLI_COMMAND (set_int_proxy_enable_command) More...
u32	arp_term_next_node_index [32]
static vlib_node_registration_t	arp_term_l2bd_node
	(constructor) VLIB_REGISTER_NODE (arp_term_l2bd_node) More...

Detailed Description

IPv4 ARP.

This file contains code to manage the IPv4 ARP tables (IP Address to MAC Address lookup).

Definition in file arp.c.

Macro Definition Documentation

#define ETHERNET_ARP_ARGS_FLUSH   (1<<1)

Definition at line 123 of file arp.c.

#define ETHERNET_ARP_ARGS_POPULATE   (1<<2)

Definition at line 124 of file arp.c.

#define ETHERNET_ARP_ARGS_REMOVE   (1<<0)

Definition at line 122 of file arp.c.

#define ETHERNET_ARP_IP4_ENTRY_FLAG_DYNAMIC   (1 << 1)

Definition at line 48 of file arp.c.

#define ETHERNET_ARP_IP4_ENTRY_FLAG_STATIC   (1 << 0)

Definition at line 47 of file arp.c.

#define foreach_ethernet_arp_error

Value:

_ (replies_sent, "ARP replies sent")                                    \
  _ (l2_type_not_ethernet, "L2 type not ethernet")                      \
  _ (l3_type_not_ip4, "L3 type not IP4")                                \
  _ (l3_src_address_not_local, "IP4 source address not local to subnet") \
  _ (l3_dst_address_not_local, "IP4 destination address not local to subnet") \
  _ (l3_src_address_is_local, "IP4 source address matches local interface") \
  _ (l3_src_address_learned, "ARP request IP4 source address learned")  \
  _ (replies_received, "ARP replies received")                          \
  _ (opcode_not_request, "ARP opcode not request")                      \
  _ (proxy_arp_replies_sent, "Proxy ARP replies sent")                  \
  _ (l2_address_mismatch, "ARP hw addr does not match L2 frame src addr") \
  _ (missing_interface_address, "ARP missing interface address") \
  _ (gratuitous_arp, "ARP probe or announcement dropped") \
  _ (interface_no_table, "Interface is not mapped to an IP table") \

Definition at line 759 of file arp.c.

Typedef Documentation

typedef struct ethernet_arp_interface_t_ ethernet_arp_interface_t

Per-interface ARP configuration and state.

Enumeration Type Documentation

enum arp_input_next_t

Enumerator
ARP_INPUT_NEXT_DROP
ARP_INPUT_NEXT_REPLY_TX
ARP_INPUT_N_NEXT

Definition at line 752 of file arp.c.

enum arp_term_next_t

Enumerator
ARP_TERM_NEXT_L2_OUTPUT
ARP_TERM_NEXT_DROP
ARP_TERM_N_NEXT

Definition at line 2070 of file arp.c.

enum ethernet_arp_input_error_t

Enumerator
ETHERNET_ARP_N_ERROR

Definition at line 775 of file arp.c.

Function Documentation

static void arp_add_del_interface_address ( ip4_main_t *  im, uword  opaque, u32  sw_if_index, ip4_address_t *  address, u32  address_length, u32  if_address_index, u32  is_del  )

static

Definition at line 1498 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static ethernet_arp_ip4_entry_t* arp_entry_find ( ethernet_arp_interface_t *  eai, const ip4_address_t *  addr  )

static

Definition at line 408 of file arp.c.

Here is the caller graph for this function:

static void arp_entry_free ( ethernet_arp_interface_t *  eai, ethernet_arp_ip4_entry_t *  e  )

static

Definition at line 1603 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static uword arp_input ( vlib_main_t *  vm, vlib_node_runtime_t *  node, vlib_frame_t *  frame  )

static

Definition at line 960 of file arp.c.

Here is the call graph for this function:

static void arp_mk_complete ( adj_index_t  ai, ethernet_arp_ip4_entry_t *  e  )

static

Definition at line 386 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static adj_walk_rc_t arp_mk_complete_walk ( adj_index_t  ai, void *  ctx  )

static

Definition at line 427 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static void arp_mk_incomplete ( adj_index_t  ai, ethernet_arp_ip4_entry_t *  e  )

static

Definition at line 396 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static adj_walk_rc_t arp_mk_incomplete_walk ( adj_index_t  ai, void *  ctx  )

static

Definition at line 437 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static void arp_nbr_probe ( ip_adjacency_t *  adj )

static

Definition at line 323 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

clib_error_t* arp_term_init

(

vlib_main_t *

vm

)

Definition at line 2315 of file arp.c.

Here is the call graph for this function:

static uword arp_term_l2bd ( vlib_main_t *  vm, vlib_node_runtime_t *  node, vlib_frame_t *  frame  )

static

Definition at line 2080 of file arp.c.

Here is the call graph for this function:

static void arp_unnumbered ( vlib_buffer_t *  p0, u32  pi0, ethernet_header_t *  eth0, u32  sw_if_index  )

static

Definition at line 816 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void arp_update_adjacency	(	vnet_main_t *	vnm,
		u32	sw_if_index,
		u32	ai
	)

Definition at line 447 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void change_arp_mac	(	u32	sw_if_index,
		ethernet_arp_ip4_entry_t *	e
	)

Definition at line 2329 of file arp.c.

Here is the call graph for this function:

void ethernet_arp_change_mac	(	vnet_main_t *	vnm,
		u32	sw_if_index
	)

Definition at line 2339 of file arp.c.

Here is the caller graph for this function:

static clib_error_t* ethernet_arp_init ( vlib_main_t *  vm )

static

Definition at line 1553 of file arp.c.

Here is the call graph for this function:

static clib_error_t* ethernet_arp_sw_interface_up_down ( vnet_main_t *  vnm, u32  sw_if_index, u32  flags  )

static

Invoked when the interface's admin state changes.

Definition at line 1710 of file arp.c.

Here is the call graph for this function:

static u8* format_arp_term_input_trace ( u8 *  s, va_list *  va  )

static

Definition at line 306 of file arp.c.

Here is the call graph for this function:

static u8* format_ethernet_arp_hardware_type ( u8 *  s, va_list *  va  )

static

Definition at line 132 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static u8* format_ethernet_arp_header ( u8 *  s, va_list *  va  )

static

Definition at line 209 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static u8* format_ethernet_arp_input_trace ( u8 *  s, va_list *  va  )

static

Definition at line 292 of file arp.c.

Here is the call graph for this function:

static u8* format_ethernet_arp_ip4_entry ( u8 *  s, va_list *  va  )

static

Definition at line 256 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static u8* format_ethernet_arp_opcode ( u8 *  s, va_list *  va  )

static

Definition at line 150 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static void increment_ip4_and_mac_address ( ethernet_arp_ip4_over_ethernet_address_t *  a )

static

Definition at line 1752 of file arp.c.

Here is the caller graph for this function:

static int ip4_arp_entry_sort ( void *  a1, void *  a2  )

static

Definition at line 1267 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

clib_error_t* ip4_set_arp_limit

(

u32

arp_limit

)

Definition at line 1420 of file arp.c.

Here is the caller graph for this function:

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

static

Definition at line 1867 of file arp.c.

Here is the call graph for this function:

static void pg_ethernet_arp_header_init ( pg_ethernet_arp_header_t *  p )

inlinestatic

Definition at line 1367 of file arp.c.

Here is the caller graph for this function:

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

static

Definition at line 2000 of file arp.c.

Here is the call graph for this function:

static void set_ip4_over_ethernet_rpc_callback ( vnet_arp_set_ip4_over_ethernet_rpc_args_t *  a )

static

Definition at line 1690 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

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

static

Definition at line 1282 of file arp.c.

Here is the call graph for this function:

static uword unformat_ethernet_arp_opcode_host_byte_order ( unformat_input_t *  input, va_list *  args  )

static

Definition at line 168 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static uword unformat_ethernet_arp_opcode_net_byte_order ( unformat_input_t *  input, va_list *  args  )

static

Definition at line 196 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

uword unformat_pg_arp_header	(	unformat_input_t *	input,
		va_list *	args
	)

Definition at line 1384 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static void unset_random_arp_entry ( void  )

static

Definition at line 785 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void vl_api_rpc_call_main_thread	(	void *	fp,
		u8 *	data,
		u32	data_length
	)

Definition at line 1364 of file memory_vlib.c.

Here is the caller graph for this function:

int vnet_add_del_ip4_arp_change_event	(	vnet_main_t *	vnm,
		void *	data_callback,
		u32	pid,
		void *	address_arg,
		uword	node_index,
		uword	type_opaque,
		uword	data,
		int	is_add
	)

Definition at line 670 of file arp.c.

Here is the caller graph for this function:

static int vnet_arp_flush_ip4_over_ethernet ( vnet_main_t *  vnm, u32  sw_if_index, void *  a_arg  )

static

Internally generated event to flush the ARP cache on an interface state change event.

A flush will remove dynamic ARP entries, and for statics remove the MAC address from the corresponding adjacencies.

Definition at line 1454 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static int vnet_arp_flush_ip4_over_ethernet_internal ( vnet_main_t *  vnm, vnet_arp_set_ip4_over_ethernet_rpc_args_t *  args  )

static

Definition at line 1636 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static int vnet_arp_populate_ip4_over_ethernet ( vnet_main_t *  vnm, u32  sw_if_index, void *  a_arg  )

static

Internally generated event to populate the ARP cache on an interface state change event.

For static entries this will re-source the adjacencies.

Parameters

sw_if_index

The interface on which the ARP entires are acted

Definition at line 1477 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static int vnet_arp_populate_ip4_over_ethernet_internal ( vnet_main_t *  vnm, vnet_arp_set_ip4_over_ethernet_rpc_args_t *  args  )

static

Definition at line 1669 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

int vnet_arp_set_ip4_over_ethernet	(	vnet_main_t *	vnm,
		u32	sw_if_index,
		void *	a_arg,
		int	is_static
	)

Definition at line 1775 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

int vnet_arp_set_ip4_over_ethernet_internal	(	vnet_main_t *	vnm,
		vnet_arp_set_ip4_over_ethernet_rpc_args_t *	args
	)

Definition at line 491 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

int vnet_arp_unset_ip4_over_ethernet	(	vnet_main_t *	vnm,
		u32	sw_if_index,
		void *	a_arg
	)

Control Plane hook to remove an ARP entry.

Definition at line 1432 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static int vnet_arp_unset_ip4_over_ethernet_internal ( vnet_main_t *  vnm, vnet_arp_set_ip4_over_ethernet_rpc_args_t *  args  )

inlinestatic

Definition at line 1613 of file arp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

int vnet_proxy_arp_add_del	(	ip4_address_t *	lo_addr,
		ip4_address_t *	hi_addr,
		u32	fib_index,
		int	is_del
	)

Definition at line 1792 of file arp.c.

Here is the caller graph for this function:

int vnet_proxy_arp_fib_reset

(

u32

fib_id

)

Definition at line 1833 of file arp.c.

void vnet_register_ip4_arp_resolution_event	(	vnet_main_t *	vnm,
		void *	address_arg,
		uword	node_index,
		uword	type_opaque,
		uword	data
	)

Definition at line 639 of file arp.c.

Here is the caller graph for this function:

VNET_SW_INTERFACE_ADMIN_UP_DOWN_FUNCTION

(

ethernet_arp_sw_interface_up_down

)

Here is the caller graph for this function:

Variable Documentation

vlib_node_registration_t arp_input_node

static

Initial value:

=
{
  .function = arp_input,
  .name = "arp-input",
  .vector_size = sizeof (u32),
  .n_errors = ETHERNET_ARP_N_ERROR,
  .error_strings = ethernet_arp_error_strings,
  .n_next_nodes = ARP_INPUT_N_NEXT,
  .next_nodes = {
    [ARP_INPUT_NEXT_DROP] = "error-drop",
    [ARP_INPUT_NEXT_REPLY_TX] = "interface-output",
  },
  .format_buffer = format_ethernet_arp_header,
  .format_trace = format_ethernet_arp_input_trace,
}

(constructor) VLIB_REGISTER_NODE (arp_input_node)

Definition at line 1249 of file arp.c.

vlib_node_registration_t arp_term_l2bd_node

static

Initial value:

= {
  .function = arp_term_l2bd,
  .name = "arp-term-l2bd",
  .vector_size = sizeof (u32),
  .n_errors = ETHERNET_ARP_N_ERROR,
  .error_strings = ethernet_arp_error_strings,
  .n_next_nodes = ARP_TERM_N_NEXT,
  .next_nodes = {
    [ARP_TERM_NEXT_L2_OUTPUT] = "l2-output",
    [ARP_TERM_NEXT_DROP] = "error-drop",
  },
  .format_buffer = format_ethernet_arp_header,
  .format_trace = format_arp_term_input_trace,
}

(constructor) VLIB_REGISTER_NODE (arp_term_l2bd_node)

Definition at line 2298 of file arp.c.

u32 arp_term_next_node_index[32]

Definition at line 2077 of file arp.c.

char* ethernet_arp_error_strings[]

static

Initial value:

= {
#define _(sym,string) 
  foreach_ethernet_arp_error

}

Definition at line 1242 of file arp.c.

ethernet_arp_main_t ethernet_arp_main

static

Definition at line 114 of file arp.c.

vlib_cli_command_t ip_arp_add_del_command

static

Initial value:

= {
  .path = "set ip arp",
  .short_help =
  "set ip arp [del] <intfc> <ip-address> <mac-address> [static] [count <count>] [fib-id <fib-id>] [proxy <lo-addr> - <hi-addr>]",
  .function = ip_arp_add_del_command_fn,
}

(constructor) VLIB_CLI_COMMAND (ip_arp_add_del_command)

Definition at line 1991 of file arp.c.

vlib_cli_command_t set_int_proxy_enable_command

static

Initial value:

= {
  .path = "set interface proxy-arp",
  .short_help =
  "set interface proxy-arp <intfc> [enable|disable]",
  .function = set_int_proxy_arp_command_fn,
}

(constructor) VLIB_CLI_COMMAND (set_int_proxy_enable_command)

Definition at line 2057 of file arp.c.

vlib_cli_command_t show_ip4_arp_command

static

Initial value:

= {
  .path = "show ip arp",
  .function = show_ip4_arp,
  .short_help = "show ip arp",
}

(constructor) VLIB_CLI_COMMAND (show_ip4_arp_command)

Definition at line 1347 of file arp.c.