Include dependency graph for adj.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	ip_adjacency_t_
	IP unicast adjacency. More...

Macros
#define	IP4_LOOKUP_NEXT_NODES

#define	IP6_LOOKUP_NEXT_NODES

Typedefs
typedef void(*	adj_midchain_fixup_t) (vlib_main_t vm, struct ip_adjacency_t_ adj, vlib_buffer_t b0, const void data)
	A function type for post-rewrite fixups on midchain adjacency. More...

typedef enum ip_adjacency_flags_t_	adj_flags_t
	Flags on an IP adjacency. More...

typedef struct ip_adjacency_t_	ip_adjacency_t
	IP unicast adjacency. More...

Enumerations
enum	ip_lookup_next_t { IP_LOOKUP_NEXT_DROP, IP_LOOKUP_NEXT_PUNT, IP_LOOKUP_NEXT_LOCAL, IP_LOOKUP_NEXT_ARP, IP_LOOKUP_NEXT_GLEAN, IP_LOOKUP_NEXT_REWRITE, IP_LOOKUP_NEXT_MIDCHAIN, IP_LOOKUP_NEXT_ICMP_ERROR, IP_LOOKUP_NEXT_MCAST, IP_LOOKUP_NEXT_MCAST_MIDCHAIN, IP_LOOKUP_N_NEXT }
	An adjacency is a representation of an attached L3 peer. More...

enum	ip4_lookup_next_t { IP4_LOOKUP_N_NEXT = IP_LOOKUP_N_NEXT }

enum	ip6_lookup_next_t { IP6_LOOKUP_NEXT_HOP_BY_HOP = IP_LOOKUP_N_NEXT, IP6_LOOKUP_NEXT_ADD_HOP_BY_HOP, IP6_LOOKUP_NEXT_POP_HOP_BY_HOP, IP6_LOOKUP_N_NEXT }

enum	ip_adjacency_flags_t_ { ADJ_FLAG_NONE = 0, ADJ_FLAG_SYNC_WALK_ACTIVE = (1 << 0), ADJ_FLAG_MIDCHAIN_NO_COUNT = (1 << 1) }
	Flags on an IP adjacency. More...

Functions
	STATIC_ASSERT ((STRUCT_OFFSET_OF(ip_adjacency_t, cacheline0)==0),"IP adjacency cachline 0 is not offset")

	STATIC_ASSERT ((STRUCT_OFFSET_OF(ip_adjacency_t, cacheline1)==CLIB_CACHE_LINE_BYTES),"IP adjacency cachline 1 is more than one cachline size offset")

void	adj_lock (adj_index_t adj_index)
	Take a reference counting lock on the adjacency. More...

void	adj_unlock (adj_index_t adj_index)
	Release a reference counting lock on the adjacency. More...

u32	adj_child_add (adj_index_t adj_index, fib_node_type_t type, fib_node_index_t child_index)
	Add a child dependent to an adjacency. More...

void	adj_child_remove (adj_index_t adj_index, u32 sibling_index)
	Remove a child dependent. More...

void	adj_walk (u32 sw_if_index, adj_walk_cb_t cb, void *ctx)
	Walk the Adjacencies on a given interface. More...

vnet_link_t	adj_get_link_type (adj_index_t ai)
	Return the link type of the adjacency. More...

u32	adj_get_sw_if_index (adj_index_t ai)
	Return the sw interface index of the adjacency. More...

int	adj_is_up (adj_index_t ai)
	Return true if the adjacency is 'UP', i.e. More...

const u8 *	adj_get_rewrite (adj_index_t ai)
	Return the link type of the adjacency. More...

void	adj_feature_update (u32 sw_if_index, u8 arc_index, u8 is_enable)
	Notify the adjacency subsystem that the features settings for an interface have changed. More...

void	adj_mtu_update (u32 hw_if_index)
	Notify the adjacency subsystem that the MTU settings for an HW interface have changed. More...

static ip_adjacency_t *	adj_get (adj_index_t adj_index)
	Get a pointer to an adjacency object from its index. More...

static int	adj_are_counters_enabled (void)
	Get the global configuration option for enabling per-adj counters. More...

Variables
ip_adjacency_t *	adj_pool
	The global adjacnecy pool. More...

vlib_combined_counter_main_t	adjacency_counters
	Adjacency packet counters. More...

int	adj_per_adj_counters
	Global Config for enabling per-adjacency counters This is configurable because it comes with a non-negligible performance cost. More...

Macro Definition Documentation

#define IP4_LOOKUP_NEXT_NODES

Value:

{                                       \
    [IP_LOOKUP_NEXT_DROP] = "ip4-drop",                         \
    [IP_LOOKUP_NEXT_PUNT] = "ip4-punt",                         \
    [IP_LOOKUP_NEXT_LOCAL] = "ip4-local",                       \
    [IP_LOOKUP_NEXT_ARP] = "ip4-arp",                           \
    [IP_LOOKUP_NEXT_GLEAN] = "ip4-glean",                       \
    [IP_LOOKUP_NEXT_REWRITE] = "ip4-rewrite",                   \
    [IP_LOOKUP_NEXT_MCAST] = "ip4-rewrite-mcast",               \
    [IP_LOOKUP_NEXT_MIDCHAIN] = "ip4-midchain",                 \
    [IP_LOOKUP_NEXT_MCAST_MIDCHAIN] = "ip4-mcast-midchain",     \
    [IP_LOOKUP_NEXT_ICMP_ERROR] = "ip4-icmp-error",             \
}

Definition at line 105 of file adj.h.

#define IP6_LOOKUP_NEXT_NODES

Value:

{                                       \
    [IP_LOOKUP_NEXT_DROP] = "ip6-drop",                         \
    [IP_LOOKUP_NEXT_PUNT] = "ip6-punt",                         \
    [IP_LOOKUP_NEXT_LOCAL] = "ip6-local",                       \
    [IP_LOOKUP_NEXT_ARP] = "ip6-discover-neighbor",             \
    [IP_LOOKUP_NEXT_GLEAN] = "ip6-glean",                       \
    [IP_LOOKUP_NEXT_REWRITE] = "ip6-rewrite",                   \
    [IP_LOOKUP_NEXT_MCAST] = "ip6-rewrite-mcast",               \
    [IP_LOOKUP_NEXT_MIDCHAIN] = "ip6-midchain",                 \
    [IP_LOOKUP_NEXT_MCAST_MIDCHAIN] = "ip6-mcast-midchain",     \
    [IP_LOOKUP_NEXT_ICMP_ERROR] = "ip6-icmp-error",             \
    [IP6_LOOKUP_NEXT_HOP_BY_HOP] = "ip6-hop-by-hop",            \
    [IP6_LOOKUP_NEXT_ADD_HOP_BY_HOP] = "ip6-add-hop-by-hop",    \
    [IP6_LOOKUP_NEXT_POP_HOP_BY_HOP] = "ip6-pop-hop-by-hop",    \
}

Definition at line 118 of file adj.h.

Typedef Documentation

typedef enum ip_adjacency_flags_t_ adj_flags_t

Flags on an IP adjacency.

typedef void(* adj_midchain_fixup_t) (vlib_main_t *vm, struct ip_adjacency_t_ *adj, vlib_buffer_t *b0, const void *data)

A function type for post-rewrite fixups on midchain adjacency.

Definition at line 142 of file adj.h.

typedef struct ip_adjacency_t_ ip_adjacency_t

IP unicast adjacency.

Note: cache aligned.

An adjacency is a represenation of a peer on a particular link.

Enumeration Type Documentation

enum ip4_lookup_next_t

Enumerator
IP4_LOOKUP_N_NEXT

Definition at line 91 of file adj.h.

enum ip6_lookup_next_t

Enumerator
IP6_LOOKUP_NEXT_HOP_BY_HOP
IP6_LOOKUP_NEXT_ADD_HOP_BY_HOP
IP6_LOOKUP_NEXT_POP_HOP_BY_HOP
IP6_LOOKUP_N_NEXT

Definition at line 96 of file adj.h.

enum ip_adjacency_flags_t_

Flags on an IP adjacency.

Enumerator

ADJ_FLAG_NONE

ADJ_FLAG_SYNC_WALK_ACTIVE

Currently a sync walk is active.

Used to prevent re-entrant walking

ADJ_FLAG_MIDCHAIN_NO_COUNT

Packets TX through the midchain do not increment the interface counters.

This should be used when the adj is associated with an L2 interface and that L2 interface is in a bridege domain. In that case the packet will have traversed the interface's TX node, and hence have been counted, before it traverses ths midchain

Definition at line 150 of file adj.h.

enum ip_lookup_next_t

An adjacency is a representation of an attached L3 peer.

Adjacency Sub-types:

neighbour: a representation of an attached L3 peer. Key:{addr,interface,link/ether-type} SHARED
glean: used to drive ARP/ND for packets destined to a local sub-net. 'glean' mean use the packet's destination address as the target address in the ARP packet. UNSHARED. Only one per-interface.
midchain: a nighbour adj on a virtual/tunnel interface.

The API to create and update the adjacency is very sub-type specific. This is intentional as it encourages the user to carefully consider which adjacency sub-type they are really using, and hence assign it data in the appropriate sub-type space in the union of sub-types. This prevents the adj becoming a disorganised dumping group for 'my features needs a u16 somewhere' data. It is important to enforce this approach as space in the adjacency is a premium, as we need it to fit in 1 cache line.

the API is also based around an index to an ajdacency not a raw pointer. This is so the user doesn't suffer the same limp inducing firearm injuries that the author suffered as the adjacenices can realloc.Common (IP4/IP6) next index stored in adjacency.

Enumerator
IP_LOOKUP_NEXT_DROP	Adjacency to drop this packet.
IP_LOOKUP_NEXT_PUNT	Adjacency to punt this packet.
IP_LOOKUP_NEXT_LOCAL	This packet is for one of our own IP addresses.
IP_LOOKUP_NEXT_ARP	This packet matches an "incomplete adjacency" and packets need to be passed to ARP to find rewrite string for this destination.
IP_LOOKUP_NEXT_GLEAN	This packet matches an "interface route" and packets need to be passed to ARP to find rewrite string for this destination.
IP_LOOKUP_NEXT_REWRITE	This packet is to be rewritten and forwarded to the next processing node. This is typically the output interface but might be another node for further output processing.
IP_LOOKUP_NEXT_MIDCHAIN	This packets follow a mid-chain adjacency.
IP_LOOKUP_NEXT_ICMP_ERROR	This packets needs to go to ICMP error.
IP_LOOKUP_NEXT_MCAST	Multicast Adjacency.
IP_LOOKUP_NEXT_MCAST_MIDCHAIN	Multicast Midchain Adjacency. An Adjacency for sending macst packets on a tunnel/virtual interface
IP_LOOKUP_N_NEXT

Definition at line 50 of file adj.h.

Function Documentation

static int adj_are_counters_enabled ( void )

inlinestatic

Get the global configuration option for enabling per-adj counters.

Definition at line 385 of file adj.h.

Here is the caller graph for this function:

u32 adj_child_add	(	adj_index_t	adj_index,
		fib_node_type_t	type,
		fib_node_index_t	child_index
	)

Add a child dependent to an adjacency.

The child will thus be informed via its registerd back-walk function when the adjacency state changes.

Definition at line 259 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void adj_child_remove	(	adj_index_t	adj_index,
		u32	sibling_index
	)

Remove a child dependent.

Definition at line 276 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void adj_feature_update	(	u32	sw_if_index,
		u8	arc_index,
		u8	is_enable
	)

Notify the adjacency subsystem that the features settings for an interface have changed.

Definition at line 327 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static ip_adjacency_t* adj_get ( adj_index_t adj_index )

inlinestatic

Get a pointer to an adjacency object from its index.

Definition at line 376 of file adj.h.

vnet_link_t adj_get_link_type ( adj_index_t ai )

Return the link type of the adjacency.

Definition at line 403 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

const u8* adj_get_rewrite ( adj_index_t ai )

Return the link type of the adjacency.

Definition at line 439 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u32 adj_get_sw_if_index ( adj_index_t ai )

Return the sw interface index of the adjacency.

Definition at line 416 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

int adj_is_up ( adj_index_t ai )

Return true if the adjacency is 'UP', i.e.

can be used for forwarding. 0 is down, !0 is up.

can be used for forwarding 0 is down, !0 is up.

Definition at line 430 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void adj_lock ( adj_index_t adj_index )

Take a reference counting lock on the adjacency.

Definition at line 223 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void adj_mtu_update ( u32 hw_if_index )

Notify the adjacency subsystem that the MTU settings for an HW interface have changed.

Definition at line 368 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void adj_unlock ( adj_index_t adj_index )

Release a reference counting lock on the adjacency.

Definition at line 240 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void adj_walk	(	u32	sw_if_index,
		adj_walk_cb_t	cb,
		void *	ctx
	)

Walk the Adjacencies on a given interface.

Definition at line 383 of file adj.c.

Here is the call graph for this function:

Here is the caller graph for this function:

STATIC_ASSERT	(	(STRUCT_OFFSET_OF(ip_adjacency_t, cacheline0)==0)	,
		"IP adjacency cachline 0 is not offset"
	)

STATIC_ASSERT	(	(STRUCT_OFFSET_OF(ip_adjacency_t, cacheline1)==CLIB_CACHE_LINE_BYTES)	,
		"IP adjacency cachline 1 is more than one cachline size offset"
	)

Variable Documentation

int adj_per_adj_counters

Global Config for enabling per-adjacency counters This is configurable because it comes with a non-negligible performance cost.

By default these are disabled.

Definition at line 36 of file adj.c.

ip_adjacency_t* adj_pool

The global adjacnecy pool.

Exposed for fast/inline data-plane access

Definition at line 30 of file adj.c.

vlib_combined_counter_main_t adjacency_counters

Adjacency packet counters.

Definition at line 25 of file adj.c.

Data Structures

Macros

Typedefs

Enumerations

Functions

Variables

Macro Definition Documentation

Typedef Documentation

Enumeration Type Documentation

Function Documentation

Variable Documentation