]>
Commit | Line | Data |
---|---|---|
b72ede27 FL |
1 | /* |
2 | * VRF related header. | |
3 | * Copyright (C) 2014 6WIND S.A. | |
4 | * | |
5 | * This file is part of GNU Zebra. | |
6 | * | |
7 | * GNU Zebra is free software; you can redistribute it and/or modify | |
8 | * it under the terms of the GNU General Public License as published | |
9 | * by the Free Software Foundation; either version 2, or (at your | |
10 | * option) any later version. | |
11 | * | |
12 | * GNU Zebra is distributed in the hope that it will be useful, but | |
13 | * WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
15 | * General Public License for more details. | |
16 | * | |
896014f4 DL |
17 | * You should have received a copy of the GNU General Public License along |
18 | * with this program; see the file COPYING; if not, write to the Free Software | |
19 | * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA | |
b72ede27 FL |
20 | */ |
21 | ||
22 | #ifndef _ZEBRA_VRF_H | |
23 | #define _ZEBRA_VRF_H | |
24 | ||
1a1a7065 | 25 | #include "openbsd-tree.h" |
8736158a | 26 | #include "linklist.h" |
e80e7cce | 27 | #include "qobj.h" |
7ddcfca4 | 28 | #include "vty.h" |
e26aedbe | 29 | #include "ns.h" |
8736158a | 30 | |
5e244469 RW |
31 | #ifdef __cplusplus |
32 | extern "C" { | |
33 | #endif | |
34 | ||
b72ede27 | 35 | /* The default VRF ID */ |
a9ff90c4 | 36 | #define VRF_UNKNOWN UINT32_MAX |
b72ede27 | 37 | |
216b18ef DS |
38 | /* Pending: May need to refine this. */ |
39 | #ifndef IFLA_VRF_MAX | |
d62a17ae | 40 | enum { IFLA_VRF_UNSPEC, IFLA_VRF_TABLE, __IFLA_VRF_MAX }; |
216b18ef DS |
41 | |
42 | #define IFLA_VRF_MAX (__IFLA_VRF_MAX - 1) | |
43 | #endif | |
44 | ||
45 | #define VRF_NAMSIZ 36 | |
990374e1 | 46 | #define NS_NAMSIZ 36 |
216b18ef | 47 | |
8736158a FL |
48 | /* |
49 | * The command strings | |
50 | */ | |
216b18ef | 51 | #define VRF_CMD_HELP_STR "Specify the VRF\nThe VRF name\n" |
8736158a | 52 | #define VRF_ALL_CMD_HELP_STR "Specify the VRF\nAll VRFs\n" |
ecffa493 | 53 | #define VRF_FULL_CMD_HELP_STR "Specify the VRF\nThe VRF name\nAll VRFs\n" |
8736158a | 54 | |
09b150ef IR |
55 | #define FRR_VRF_XPATH "/frr-vrf:lib/vrf" |
56 | #define FRR_VRF_KEY_XPATH "/frr-vrf:lib/vrf[name='%s']" | |
57 | ||
1da29456 DS |
58 | /* |
59 | * Pass some OS specific data up through | |
60 | * to the daemons | |
61 | */ | |
d62a17ae | 62 | struct vrf_data { |
63 | union { | |
64 | struct { | |
65 | uint32_t table_id; | |
4691b65a | 66 | char netns_name[NS_NAMSIZ]; |
d62a17ae | 67 | } l; |
68 | }; | |
1da29456 DS |
69 | }; |
70 | ||
d62a17ae | 71 | struct vrf { |
72 | RB_ENTRY(vrf) id_entry, name_entry; | |
1a1a7065 | 73 | |
d62a17ae | 74 | /* Identifier, same as the vector index */ |
75 | vrf_id_t vrf_id; | |
216b18ef | 76 | |
d62a17ae | 77 | /* Name */ |
78 | char name[VRF_NAMSIZ + 1]; | |
216b18ef | 79 | |
d62a17ae | 80 | /* Zebra internal VRF status */ |
d7c0a89a | 81 | uint8_t status; |
84915b0a | 82 | #define VRF_ACTIVE (1 << 0) /* VRF is up in kernel */ |
22bd3e94 | 83 | #define VRF_CONFIGURED (1 << 1) /* VRF has some FRR configuration */ |
216b18ef | 84 | |
f4e14fdb RW |
85 | /* Interfaces belonging to this VRF */ |
86 | struct if_name_head ifaces_by_name; | |
ff880b78 | 87 | struct if_index_head ifaces_by_index; |
216b18ef | 88 | |
d62a17ae | 89 | /* User data */ |
90 | void *info; | |
e80e7cce | 91 | |
d62a17ae | 92 | /* The table_id from the kernel */ |
93 | struct vrf_data data; | |
1da29456 | 94 | |
b95c1883 PG |
95 | /* Back pointer to namespace context */ |
96 | void *ns_ctxt; | |
97 | ||
96244aca | 98 | QOBJ_FIELDS; |
216b18ef | 99 | }; |
d62a17ae | 100 | RB_HEAD(vrf_id_head, vrf); |
101 | RB_PROTOTYPE(vrf_id_head, vrf, id_entry, vrf_id_compare) | |
102 | RB_HEAD(vrf_name_head, vrf); | |
103 | RB_PROTOTYPE(vrf_name_head, vrf, name_entry, vrf_name_compare) | |
96244aca | 104 | DECLARE_QOBJ_TYPE(vrf); |
216b18ef | 105 | |
78dd30b2 | 106 | /* Allow VRF with netns as backend */ |
7239d3d9 QY |
107 | enum vrf_backend_type { |
108 | VRF_BACKEND_VRF_LITE, | |
109 | VRF_BACKEND_NETNS, | |
110 | VRF_BACKEND_UNKNOWN, | |
111 | VRF_BACKEND_MAX, | |
112 | }; | |
216b18ef | 113 | |
1a1a7065 | 114 | extern struct vrf_id_head vrfs_by_id; |
806f8760 | 115 | extern struct vrf_name_head vrfs_by_name; |
216b18ef | 116 | |
d62a17ae | 117 | extern struct vrf *vrf_lookup_by_id(vrf_id_t); |
118 | extern struct vrf *vrf_lookup_by_name(const char *); | |
119 | extern struct vrf *vrf_get(vrf_id_t, const char *); | |
75d26fb3 | 120 | extern struct vrf *vrf_update(vrf_id_t new_vrf_id, const char *name); |
523cafc4 | 121 | extern const char *vrf_id_to_name(vrf_id_t vrf_id); |
ac6c2a11 | 122 | |
b7e48f21 DS |
123 | #define VRF_LOGNAME(V) V ? V->name : "Unknown" |
124 | ||
ec1db588 | 125 | #define VRF_GET_ID(V, NAME, USE_JSON) \ |
d62a17ae | 126 | do { \ |
7fe96307 A |
127 | struct vrf *_vrf; \ |
128 | if (!(_vrf = vrf_lookup_by_name(NAME))) { \ | |
ec1db588 NVG |
129 | if (USE_JSON) { \ |
130 | vty_out(vty, "{}\n"); \ | |
131 | } else { \ | |
132 | vty_out(vty, "%% VRF %s not found\n", NAME); \ | |
133 | } \ | |
d62a17ae | 134 | return CMD_WARNING; \ |
135 | } \ | |
7fe96307 | 136 | if (_vrf->vrf_id == VRF_UNKNOWN) { \ |
ec1db588 NVG |
137 | if (USE_JSON) { \ |
138 | vty_out(vty, "{}\n"); \ | |
139 | } else { \ | |
140 | vty_out(vty, "%% VRF %s not active\n", NAME); \ | |
141 | } \ | |
d62a17ae | 142 | return CMD_WARNING; \ |
143 | } \ | |
7fe96307 | 144 | (V) = _vrf->vrf_id; \ |
d62a17ae | 145 | } while (0) |
216b18ef | 146 | |
84915b0a | 147 | /* |
148 | * Check whether the VRF is enabled. | |
149 | */ | |
150 | static inline int vrf_is_enabled(struct vrf *vrf) | |
151 | { | |
152 | return vrf && CHECK_FLAG(vrf->status, VRF_ACTIVE); | |
153 | } | |
154 | ||
155 | /* check if the vrf is user configured */ | |
156 | static inline int vrf_is_user_cfged(struct vrf *vrf) | |
157 | { | |
158 | return vrf && CHECK_FLAG(vrf->status, VRF_CONFIGURED); | |
159 | } | |
160 | ||
8e037331 PR |
161 | static inline uint32_t vrf_interface_count(struct vrf *vrf) |
162 | { | |
163 | uint32_t count = 0; | |
164 | struct interface *ifp; | |
165 | ||
166 | RB_FOREACH (ifp, if_name_head, &vrf->ifaces_by_name) { | |
167 | /* skip the l3mdev */ | |
168 | if (strncmp(ifp->name, vrf->name, VRF_NAMSIZ) == 0) | |
169 | continue; | |
170 | count++; | |
171 | } | |
172 | return count; | |
173 | } | |
174 | ||
b72ede27 FL |
175 | /* |
176 | * Utilities to obtain the user data | |
177 | */ | |
178 | ||
b72ede27 | 179 | /* Look up the data pointer of the specified VRF. */ |
d62a17ae | 180 | extern void *vrf_info_lookup(vrf_id_t); |
b72ede27 | 181 | |
7076bb2f FL |
182 | /* |
183 | * VRF bit-map: maintaining flags, one bit per VRF ID | |
184 | */ | |
185 | ||
d62a17ae | 186 | typedef void *vrf_bitmap_t; |
7076bb2f FL |
187 | #define VRF_BITMAP_NULL NULL |
188 | ||
d62a17ae | 189 | extern vrf_bitmap_t vrf_bitmap_init(void); |
190 | extern void vrf_bitmap_free(vrf_bitmap_t); | |
191 | extern void vrf_bitmap_set(vrf_bitmap_t, vrf_id_t); | |
192 | extern void vrf_bitmap_unset(vrf_bitmap_t, vrf_id_t); | |
193 | extern int vrf_bitmap_check(vrf_bitmap_t, vrf_id_t); | |
7076bb2f | 194 | |
b72ede27 FL |
195 | /* |
196 | * VRF initializer/destructor | |
97b1a80c DS |
197 | * |
198 | * create -> Called back when a new VRF is created. This | |
199 | * can be either through these 3 options: | |
200 | * 1) CLI mentions a vrf before OS knows about it | |
201 | * 2) OS calls zebra and we create the vrf from OS | |
202 | * callback | |
203 | * 3) zebra calls individual protocols to notify | |
204 | * about the new vrf | |
205 | * | |
206 | * enable -> Called back when a VRF is actually usable from | |
207 | * an OS perspective ( 2 and 3 above ) | |
208 | * | |
209 | * disable -> Called back when a VRF is being deleted from | |
210 | * the system ( 2 and 3 ) above | |
211 | * | |
212 | * delete -> Called back when a vrf is being deleted from | |
213 | * the system ( 2 and 3 ) above. | |
b72ede27 | 214 | */ |
ac2cb9bf IR |
215 | extern void vrf_init(int (*create)(struct vrf *vrf), |
216 | int (*enable)(struct vrf *vrf), | |
217 | int (*disable)(struct vrf *vrf), | |
218 | int (*destroy)(struct vrf *vrf)); | |
ecbc5a37 | 219 | |
97b1a80c DS |
220 | /* |
221 | * Call vrf_terminate when the protocol is being shutdown | |
b72ede27 | 222 | */ |
d62a17ae | 223 | extern void vrf_terminate(void); |
b72ede27 | 224 | |
e5bf3e1e | 225 | /* |
e26aedbe PG |
226 | * Utilities to create networks objects, |
227 | * or call network operations | |
e5bf3e1e FL |
228 | */ |
229 | ||
79a80af8 QY |
230 | /* |
231 | * Create a new socket associated with a VRF. | |
232 | * | |
233 | * This is a wrapper that ensures correct behavior when using namespace VRFs. | |
234 | * In the namespace case, the socket is created within the namespace. In the | |
235 | * non-namespace case, this is equivalent to socket(). | |
236 | * | |
237 | * If name is provided, this is provided to vrf_bind() to bind the socket to | |
238 | * the VRF. This is only relevant when using VRF-lite. | |
239 | * | |
240 | * Summary: | |
241 | * - Namespace: pass vrf_id but not name | |
242 | * - VRF-lite: pass vrf_id and name of VRF device to bind to | |
243 | * - VRF-lite, no binding: pass vrf_id but not name, or just use socket() | |
244 | */ | |
996c9314 | 245 | extern int vrf_socket(int domain, int type, int protocol, vrf_id_t vrf_id, |
02fe07c7 | 246 | const char *name); |
0f4977c6 | 247 | |
996c9314 | 248 | extern int vrf_sockunion_socket(const union sockunion *su, vrf_id_t vrf_id, |
02fe07c7 | 249 | const char *name); |
0f4977c6 | 250 | |
79a80af8 | 251 | /* |
36eef858 | 252 | * Binds a socket to an interface (ifname) in a VRF (vrf_id). |
79a80af8 | 253 | * |
36eef858 IR |
254 | * If ifname is NULL or is equal to the VRF name then bind to a VRF device. |
255 | * Otherwise, bind to the specified interface in the specified VRF. | |
79a80af8 | 256 | * |
36eef858 | 257 | * Returns 0 on success and -1 on failure. |
79a80af8 | 258 | */ |
36eef858 | 259 | extern int vrf_bind(vrf_id_t vrf_id, int fd, const char *ifname); |
ce1be369 | 260 | |
2e0d2b3d PG |
261 | /* VRF ioctl operations */ |
262 | extern int vrf_getaddrinfo(const char *node, const char *service, | |
996c9314 LB |
263 | const struct addrinfo *hints, struct addrinfo **res, |
264 | vrf_id_t vrf_id); | |
e26aedbe | 265 | |
516d7591 PG |
266 | extern int vrf_ioctl(vrf_id_t vrf_id, int d, unsigned long request, char *args); |
267 | ||
e26aedbe | 268 | /* The default VRF ID */ |
1eb92f06 | 269 | #define VRF_DEFAULT 0 |
e26aedbe | 270 | |
ac2cb9bf IR |
271 | /* Must be called only during startup, before config is read */ |
272 | extern void vrf_set_default_name(const char *default_name); | |
273 | ||
c200f5e1 PG |
274 | extern const char *vrf_get_default_name(void); |
275 | #define VRF_DEFAULT_NAME vrf_get_default_name() | |
276 | ||
2e0d2b3d PG |
277 | /* VRF switch from NETNS */ |
278 | extern int vrf_switch_to_netns(vrf_id_t vrf_id); | |
279 | extern int vrf_switchback_to_initial(void); | |
280 | ||
e26aedbe PG |
281 | /* |
282 | * VRF backend routines | |
283 | * should be called from zebra only | |
697d3ec7 | 284 | */ |
e5bf3e1e | 285 | |
e26aedbe PG |
286 | /* VRF vty command initialisation |
287 | */ | |
cfc369c4 | 288 | extern void vrf_cmd_init(int (*writefunc)(struct vty *vty)); |
e26aedbe PG |
289 | |
290 | /* VRF vty debugging | |
19dc275e | 291 | */ |
d62a17ae | 292 | extern void vrf_install_commands(void); |
ec31f30d | 293 | |
e26aedbe PG |
294 | /* |
295 | * VRF utilities | |
296 | */ | |
ec31f30d | 297 | |
7239d3d9 QY |
298 | /* |
299 | * API for configuring VRF backend | |
e26aedbe | 300 | */ |
7239d3d9 | 301 | extern int vrf_configure_backend(enum vrf_backend_type backend); |
e26aedbe PG |
302 | extern int vrf_get_backend(void); |
303 | extern int vrf_is_backend_netns(void); | |
304 | ||
e26aedbe PG |
305 | /* used internally to enable or disable VRF. |
306 | * Notify a change in the VRF ID of the VRF | |
307 | */ | |
308 | extern void vrf_disable(struct vrf *vrf); | |
309 | extern int vrf_enable(struct vrf *vrf); | |
0c902ba5 | 310 | extern void vrf_delete(struct vrf *vrf); |
ec31f30d | 311 | |
bc867a5d CS |
312 | extern const struct frr_yang_module_info frr_vrf_info; |
313 | ||
5e244469 RW |
314 | #ifdef __cplusplus |
315 | } | |
316 | #endif | |
317 | ||
b72ede27 | 318 | #endif /*_ZEBRA_VRF_H*/ |