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