blob: 4a03eee844fe93d480e7211d17f29b654241ba60 [file] [log] [blame]
Neale Ranns03ce4622020-02-03 10:55:09 +00001/*
2 * teib.h: next-hop resolution
3 *
4 * Copyright (c) 2016 Cisco and/or its affiliates.
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at:
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18#ifndef __TEIB_H__
19#define __TEIB_H__
20
21#include <vnet/ip/ip.h>
22
23/**
24 * Tunnel Endpoint Information Base.
25 *
26 * A TEIB entry represents the mapping between a peer on an interface in the overlay
27 * and a next-hop address in the underlay.
28 * i.e. there's a multipoint tunnel providing the overlay (henace a peer on
29 * that tunnel) which is reachable via 'tunnel destination' address in the
30 * underlay.
31 *
32 * Such overlay to underlay mappings might be providied by a protocol like NHRP
33 */
34typedef struct teib_entry_t_ teib_entry_t;
35
36/** accessors for the opaque struct */
37extern u32 teib_entry_get_sw_if_index (const teib_entry_t * ne);
38extern u32 teib_entry_get_fib_index (const teib_entry_t * ne);
39extern const ip46_address_t *teib_entry_get_peer (const teib_entry_t * ne);
40extern const fib_prefix_t *teib_entry_get_nh (const teib_entry_t * ne);
41extern u8 *format_teib_entry (u8 * s, va_list * args);
42
43/**
44 * Create a new TEIB entry
45 */
46extern int teib_entry_add (u32 sw_if_index,
47 const ip46_address_t * peer,
48 u32 nh_table_id, const ip46_address_t * nh);
49
50extern int teib_entry_del (u32 sw_if_index, const ip46_address_t * peer);
51
52extern teib_entry_t *teib_entry_find (u32 sw_if_index,
53 const ip46_address_t * peer);
54extern teib_entry_t *teib_entry_get (index_t nei);
55
56extern void teib_entry_adj_stack (const teib_entry_t * ne, adj_index_t ai);
57
58typedef walk_rc_t (*teib_walk_cb_t) (index_t nei, void *ctx);
59
60extern void teib_walk (teib_walk_cb_t fn, void *ctx);
61extern void teib_walk_itf (u32 sw_if_index, teib_walk_cb_t fn, void *ctx);
62
63/**
64 * Notifications for the creation and deletion of TEIB entries
65 */
66typedef void (*teib_entry_added_t) (const teib_entry_t * ne);
67typedef void (*teib_entry_deleted_t) (const teib_entry_t * ne);
68
69typedef struct teib_vft_t_
70{
71 teib_entry_added_t nv_added;
72 teib_entry_deleted_t nv_deleted;
73} teib_vft_t;
74
75extern void teib_register (const teib_vft_t * vft);
76
77#endif
78
79/*
80 * fd.io coding-style-patch-verification: ON
81 *
82 * Local Variables:
83 * eval: (c-set-style "gnu")
84 * End:
85 */