summaryrefslogtreecommitdiffstats
path: root/hicn-plugin/src/strategy_dpo_manager.h
blob: b8a0c9e92e6a5ed6f8ce5edb3d19ec255cd13f63 (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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
/*
 * Copyright (c) 2021 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_STRATEGY_DPO_MANAGER_H__
#define __HICN_STRATEGY_DPO_MANAGER_H__

#include "strategy_dpo_ctx.h"
#include "strategy.h"

/**
 * @file strategy_dpo_manager.h
 *
 * This file implements structs and helper functions to manipulate hICN dpo.
 * An hICN DPO is a combination of:
 *   - a hICN DPO ctx (context) that holds the structure containing the
 *     information to choose the next hop,
 *   - a dpo vft that specify how to update the hICN DPO ctx when a next hop is
 *     added, deleted or updated,
 *   - a strategy containing (see strategy.h): (i) the vpp node that processes
 * Interest packets subjected to such strategy, (ii) the definition of the vft
 * that defines the hICN strategy functions An hICN DPO is places as the sole
 * next hop in the vpp loadbalancer, and it containes a list of next hops that
 * will be used by the associated strategy when forwarding interest packets.
 */

/**
 * @brief Definition of the virtual function table for a hICN DPO.
 *
 * The following virtual function table
 * template that glues together the fuction to interact with the context and
 * the creating the dpo
 */
typedef struct hicn_dpo_vft_s
{
  int (*hicn_dpo_is_type) (const dpo_id_t *dpo);
  /**< Check if the type of the
     hICN DPO is the expected */
  dpo_type_t (*hicn_dpo_get_type) (void);
  /**< Return the type of the hICN dpo */
  void (*hicn_dpo_module_init) (void); /**< Initialize the hICN dpo */
  void (*hicn_dpo_create) (
    fib_protocol_t proto, const hicn_face_id_t *nh, int nh_len,
    index_t *dpo_idx); /**< Create the context of the hICN dpo */
  void (*hicn_dpo_update_type) (
    hicn_dpo_ctx_t *hicn_strategy_ctx); /**change dpo type */
  int (*hicn_dpo_add_update_nh) (
    hicn_face_id_t nh,
    index_t dpo_idx); /**< Add a next hop to the hICN dpo context */
  int (*hicn_dpo_del_nh) (hicn_face_id_t face_id, index_t dpo_idx);
  u8 *(*hicn_dpo_format) (u8 *s, int, ...);
  /**< Format an hICN dpo*/
} hicn_dpo_vft_t;

/*
 * Default dpo to be used to create fib entry when a strategy is not
 * specified
 */
extern hicn_dpo_vft_t default_dpo;

/**
 *  @brief Register a new hICN dpo to the manager.
 *
 * Registering a hICN DPO allows the plugin to be aware of the new dpo an be
 * able to apply it to the FIB entries.
 *
 * @param hicn_nodes A list of vpp to which pass an interest that matches with
 * the FIB entry to which the hICN DPO is applied. This list must contain the
 * name of the strategy node (or nodes in case of differentiation between IPv4
 * and IPv6). Unless really needed otherwise (i.e., different implementation of
 * iface input), the list of node to use should be one provided in the
 * strategy.h (hicn_nodes_strategy)
 * @param hicn_dpo_vft The structure holding the virtual function table to
 * interact with the hICN dpo and its context.
 * @param hicn_strategy_vft The structure holding the virtual function table
 * containing the hICN strategy functions.
 * @return the dpo type registered in the VPP Data plane graph.
 */
dpo_type_t hicn_dpo_register_new_type (
  const char *const *const *hicn_nodes, const hicn_dpo_vft_t *hicn_dpo_vft,
  const hicn_strategy_vft_t *hicn_strategy_vft, const dpo_vft_t *dpo_ctx_vft);

/**
 * @brief Check if the type of the dpo is among the list of hicn dpo types
 *
 * Iterate through the list of dpo types registered in the hicn dpo manager.
 *
 * @param dpo The id of the dpo to which check the type
 * @return 1 if there is a match, 0 otherwise.
 */
u32 dpo_is_hicn (const dpo_id_t *dpo);

/**
 * @brief Return the dpo_vtf and strategy_vtf identifier
 *
 * Iterate through the list of dpo types registered in the hicn dpo manager and
 * retrieve the corresponding dpo_vtf/strategy_vtf identifier.
 *
 * @param dpo The id of the dpo to which check the type
 * @return the dpo_vft/strategy_vft id or HICN_ERROR_DPO_NOT_FOUND in case the
 * dpo is not an hICN dpo.
 */
u8 hicn_dpo_get_vft_id (const dpo_id_t *dpo);

/**
 * @brief Get the vft to manage the dpo context.
 *
 * @param The id of the hicn_dpo_vft to retrieve.
 * @return The vft struct that contains the list of callbacks that allows to
 * manage the dpo context.
 */
const hicn_dpo_vft_t *hicn_dpo_get_vft (dpo_type_t vfts_id);

/**
 * @brief Get the vft to manage the dpo context from the strategy id.
 *
 * @param The strategy id of the hicn_dpo_vft to retrieve.
 * @return The vft struct that contains the list of callbacks that allows to
 * manage the dpo context.
 */
const hicn_dpo_vft_t *hicn_dpo_get_vft_from_id (u8 strategy_id);

/**
 * @brief Get the vft with the hICN strategy functions.
 *
 * @param The id of the hicn_strategy_vft to retrieve.
 * @return The vft struct that contains the list hICN strategy functions.
 */
const hicn_strategy_vft_t *hicn_dpo_get_strategy_vft (dpo_type_t vfts_id);

/**
 * @brief Get the vft with the hICN strategy functions from the strategy id.
 *
 * @param The id of the hicn_strategy_vft to retrieve.
 * @return The vft struct that contains the list hICN strategy functions.
 */
const hicn_strategy_vft_t *hicn_dpo_get_strategy_vft_from_id (u8 vfts_id);

/**
 * @brief Initialize all the types hicn dpo registered
 *
 * Call the init functions of all the hicn dpo implemented.
 * This init is called when the plugin bootstrap.
 */
void hicn_dpos_init (void);

/**
 * @brief Print the list of the registered hICN DPO
 *
 * @param s String to which to append the list of hICN DPO (strategies)
 * @param n number of parameters to pass
 *
 * @result The string with the list of hICN DPO (strategies)
 */
u8 *format_hicn_strategy_list (u8 *s, int n, ...);

/**
 * @brief Check if a given id points to a strategy and the corresponding dpo
 * ctx
 *
 * @param The id of the strategy to check.
 *
 * @result HICN_ERROR_NONE is the id is valid, otherwise EINVAL
 */
int hicn_dpo_strategy_id_is_valid (int strategy_id);

/**
 * @brief Return the number of available strategies. This number can be used to
 * as an upperbond for valid vfts_id.
 *
 * @result Return the number of available strategies.
 */
int hicn_strategy_get_all_available (void);

/**
 * @brief Registers a module at compilation time to be initialized as part of
 * the ctor.
 */
void hicn_dpo_register (const hicn_dpo_vft_t *hicn_dpo);

#endif /* // __HICN_STRATEGY_DPO_MANAGER_H__ */

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