aboutsummaryrefslogtreecommitdiffstats
path: root/hicn-plugin/src/route.h
blob: a1ba86b3ddb516c7487a8b2aab49fbf95299f69e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
/*
 * Copyright (c) 2017-2020 Cisco and/or its affiliates.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at:
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef __HICN_ROUTE__
#define __HICN_ROUTE__

#include <vlib/vlib.h>
#include <vppinfra/error.h>
#include "hicn.h"
#include "faces/face.h"

/**
 * @file route.h
 *
 * hICN uses a specific vrf to install the routes for a prefix has been enabled to
 * be hicn. It considers the vrf 0 (the default vrf) as the dominating vrf on
 * which every route is stored. Enabling a prefix to be hICN will copy all the routes
 * in the vrf 0 for the given prefi, in the vrf HICN. Every modification made on the
 * vrf 0 on an hICN enabled prefix is reflected in the vrf hICN (through the use of
 * the fib entry tracking functionality). Moreover, we use the lookup in the vrf hICN
 * as a way for punting packet that must be processed as hICN. The implementation will
 * install a special dpo as a single next hop for the vpp load balancer for each entry
 * in the vrf hICN that we enabled. Such dpo will have two purposes: 1) to punt packets
 * to the hICN forwarding pipeline, 2) to point to the righe strategy (the dpoi_index will
 * be an index to the strategy context while the dpoi_type will be an index to the strategy vft).
 *
 * Additionally, hICN assign each interface to the vrf hICN; this is required for
 * the interest lookup. Vpp performs a lookup in the vrf assigned to the interface,
 * therefore if an interface is not assigned to the hICN vrf, the lookup will be done
 * on the vrf 0 and the packet won't be processed through the hicn forwarding pipeline.
 */

/*
 * Adding each interface to the vrf hICN has the side effect that to ping you need to
 * specify the vrf hICN in the command.
 */

extern fib_source_t hicn_fib_src;

extern dpo_type_t udp_encap_dpo_types[FIB_PROTOCOL_MAX];

/**
 * @Brief Return the hicn_dpo corresponding to the prefix in teh vrf HICN
 *
 * @param prefix Prefix for which we want to retrieve the hICN dpo
 * @param hicn_dpo return value with the hicn_dpo
 * @param fib_index return value with the fib index corresponding to the prefix
 */
int
hicn_route_get_dpo (const fib_prefix_t * prefix,
		    const dpo_id_t ** hicn_dpo, u32 * fib_index);


/**
 * @Brief Set the strategy for a given prefix
 *
 * @param prefix Prefix for which we set the strategy
 * @param stretegy_id Index of the strategy to set
 */
int
hicn_route_set_strategy (fib_prefix_t * prefix, u32 strategy_id);

/**
 * @Brief Helper to add a nex hop in the vrf 0. If there are no entries in the
 * vrf 0 that matches with the prefix (epm), a new one is created.
 *
 * @param fib_proto FIB_PROTOCOL_IP6 or FIB_PROTOCOL_IP4 (mpls not supported)
 * @param pfx Prefix for which to add a next hop
 * @param nh Next hop to add
 * @param sw_if Software interface index to add in the next hop
 */
int
ip_nh_add_helper (fib_protocol_t fib_proto, const fib_prefix_t * pfx, ip46_address_t * nh, u32 sw_if);

/**
 * @Brief Helper to remove a nex hop in the vrf 0. If there are no entries in the
 * vrf 0 nothing happens.
 *
 * @param fib_proto FIB_PROTOCOL_IP6 or FIB_PROTOCOL_IP4 (mpls not supported)
 * @param pfx Prefix for which to remove a next hop
 * @param nh Next hop to remove
 * @param sw_if Software interface index in the next hop definition
 */
int
ip_nh_del_helper (fib_protocol_t fib_proto, const fib_prefix_t * rpfx, ip46_address_t * nh, u32 sw_if);

/**
 * @Brief Enable an hICN for an ip prefix
 *
 * @param prefix Prefix for which we enable hICN
 * @return HICN_ERROR_NONE if hICN was enabled on the prefix
 * HICN_ERROR_ROUTE_NO_LD if the first dpo for the fib entry corresponding to the prefix is not a load_balancer
 * HICN_ERROR_ROUTE_DPO_NO_HICN if the loadbalancer in the vrf HICN already contains a dpo which is not an hICN one
 * HICN_ERROR_ROUTE_MLT_LD if there are more than a dpo in the vpp loadbalancer
 */
int
hicn_route_enable (fib_prefix_t *prefix);

/**
 * @Brief Disable an hICN for an ip prefix. If hICN wasn't enable on the prefix
 * nothing happens and it returns HICN_ERROR_ROUTE_NOT_FOUND
 *
 * @param prefix Prefix for which we disable hICN
 */
int
hicn_route_disable (fib_prefix_t *prefix);


/* Init route internal strustures */
void
hicn_route_init();
#endif /* //__HICN_ROUTE__ */

/*
 * fd.io coding-style-patch-verification: ON
 *
 * Local Variables: eval: (c-set-style "gnu") End:
 */