]>
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 | |
b72ede27 | 31 | /* The default VRF ID */ |
a9ff90c4 | 32 | #define VRF_UNKNOWN UINT32_MAX |
b72ede27 | 33 | |
216b18ef DS |
34 | /* Pending: May need to refine this. */ |
35 | #ifndef IFLA_VRF_MAX | |
d62a17ae | 36 | enum { IFLA_VRF_UNSPEC, IFLA_VRF_TABLE, __IFLA_VRF_MAX }; |
216b18ef DS |
37 | |
38 | #define IFLA_VRF_MAX (__IFLA_VRF_MAX - 1) | |
39 | #endif | |
40 | ||
41 | #define VRF_NAMSIZ 36 | |
4691b65a | 42 | #define NS_NAMSIZ 16 |
216b18ef DS |
43 | |
44 | #define VRF_DEFAULT_NAME "Default-IP-Routing-Table" | |
45 | ||
8736158a FL |
46 | /* |
47 | * The command strings | |
48 | */ | |
216b18ef | 49 | #define VRF_CMD_HELP_STR "Specify the VRF\nThe VRF name\n" |
8736158a | 50 | #define VRF_ALL_CMD_HELP_STR "Specify the VRF\nAll VRFs\n" |
ecffa493 | 51 | #define VRF_FULL_CMD_HELP_STR "Specify the VRF\nThe VRF name\nAll VRFs\n" |
8736158a | 52 | |
1da29456 DS |
53 | /* |
54 | * Pass some OS specific data up through | |
55 | * to the daemons | |
56 | */ | |
d62a17ae | 57 | struct vrf_data { |
58 | union { | |
59 | struct { | |
60 | uint32_t table_id; | |
4691b65a | 61 | char netns_name[NS_NAMSIZ]; |
d62a17ae | 62 | } l; |
63 | }; | |
1da29456 DS |
64 | }; |
65 | ||
d62a17ae | 66 | struct vrf { |
67 | RB_ENTRY(vrf) id_entry, name_entry; | |
1a1a7065 | 68 | |
d62a17ae | 69 | /* Identifier, same as the vector index */ |
70 | vrf_id_t vrf_id; | |
216b18ef | 71 | |
d62a17ae | 72 | /* Name */ |
73 | char name[VRF_NAMSIZ + 1]; | |
216b18ef | 74 | |
d62a17ae | 75 | /* Zebra internal VRF status */ |
d7c0a89a | 76 | uint8_t status; |
84915b0a | 77 | #define VRF_ACTIVE (1 << 0) /* VRF is up in kernel */ |
22bd3e94 | 78 | #define VRF_CONFIGURED (1 << 1) /* VRF has some FRR configuration */ |
216b18ef | 79 | |
f4e14fdb RW |
80 | /* Interfaces belonging to this VRF */ |
81 | struct if_name_head ifaces_by_name; | |
ff880b78 | 82 | struct if_index_head ifaces_by_index; |
216b18ef | 83 | |
d62a17ae | 84 | /* User data */ |
85 | void *info; | |
e80e7cce | 86 | |
d62a17ae | 87 | /* The table_id from the kernel */ |
88 | struct vrf_data data; | |
1da29456 | 89 | |
b95c1883 PG |
90 | /* Back pointer to namespace context */ |
91 | void *ns_ctxt; | |
92 | ||
d62a17ae | 93 | QOBJ_FIELDS |
216b18ef | 94 | }; |
d62a17ae | 95 | RB_HEAD(vrf_id_head, vrf); |
96 | RB_PROTOTYPE(vrf_id_head, vrf, id_entry, vrf_id_compare) | |
97 | RB_HEAD(vrf_name_head, vrf); | |
98 | RB_PROTOTYPE(vrf_name_head, vrf, name_entry, vrf_name_compare) | |
e80e7cce | 99 | DECLARE_QOBJ_TYPE(vrf) |
216b18ef | 100 | |
78dd30b2 PG |
101 | /* Allow VRF with netns as backend */ |
102 | #define VRF_BACKEND_VRF_LITE 0 | |
103 | #define VRF_BACKEND_NETNS 1 | |
216b18ef | 104 | |
1a1a7065 | 105 | extern struct vrf_id_head vrfs_by_id; |
806f8760 | 106 | extern struct vrf_name_head vrfs_by_name; |
216b18ef | 107 | |
d62a17ae | 108 | extern struct vrf *vrf_lookup_by_id(vrf_id_t); |
109 | extern struct vrf *vrf_lookup_by_name(const char *); | |
110 | extern struct vrf *vrf_get(vrf_id_t, const char *); | |
523cafc4 | 111 | extern const char *vrf_id_to_name(vrf_id_t vrf_id); |
d62a17ae | 112 | extern vrf_id_t vrf_name_to_id(const char *); |
113 | ||
114 | #define VRF_GET_ID(V, NAME) \ | |
115 | do { \ | |
116 | struct vrf *vrf; \ | |
117 | if (!(vrf = vrf_lookup_by_name(NAME))) { \ | |
118 | vty_out(vty, "%% VRF %s not found\n", NAME); \ | |
119 | return CMD_WARNING; \ | |
120 | } \ | |
121 | if (vrf->vrf_id == VRF_UNKNOWN) { \ | |
122 | vty_out(vty, "%% VRF %s not active\n", NAME); \ | |
123 | return CMD_WARNING; \ | |
124 | } \ | |
125 | (V) = vrf->vrf_id; \ | |
126 | } while (0) | |
216b18ef | 127 | |
84915b0a | 128 | /* |
129 | * Check whether the VRF is enabled. | |
130 | */ | |
131 | static inline int vrf_is_enabled(struct vrf *vrf) | |
132 | { | |
133 | return vrf && CHECK_FLAG(vrf->status, VRF_ACTIVE); | |
134 | } | |
135 | ||
136 | /* check if the vrf is user configured */ | |
137 | static inline int vrf_is_user_cfged(struct vrf *vrf) | |
138 | { | |
139 | return vrf && CHECK_FLAG(vrf->status, VRF_CONFIGURED); | |
140 | } | |
141 | ||
22bd3e94 | 142 | /* Mark that VRF has user configuration */ |
143 | static inline void vrf_set_user_cfged(struct vrf *vrf) | |
144 | { | |
145 | SET_FLAG(vrf->status, VRF_CONFIGURED); | |
146 | } | |
147 | ||
148 | /* Mark that VRF no longer has any user configuration */ | |
149 | static inline void vrf_reset_user_cfged(struct vrf *vrf) | |
150 | { | |
151 | UNSET_FLAG(vrf->status, VRF_CONFIGURED); | |
152 | } | |
153 | ||
b72ede27 FL |
154 | /* |
155 | * Utilities to obtain the user data | |
156 | */ | |
157 | ||
158 | /* Get the data pointer of the specified VRF. If not found, create one. */ | |
d62a17ae | 159 | extern void *vrf_info_get(vrf_id_t); |
b72ede27 | 160 | /* Look up the data pointer of the specified VRF. */ |
d62a17ae | 161 | extern void *vrf_info_lookup(vrf_id_t); |
b72ede27 | 162 | |
7076bb2f FL |
163 | /* |
164 | * VRF bit-map: maintaining flags, one bit per VRF ID | |
165 | */ | |
166 | ||
d62a17ae | 167 | typedef void *vrf_bitmap_t; |
7076bb2f FL |
168 | #define VRF_BITMAP_NULL NULL |
169 | ||
d62a17ae | 170 | extern vrf_bitmap_t vrf_bitmap_init(void); |
171 | extern void vrf_bitmap_free(vrf_bitmap_t); | |
172 | extern void vrf_bitmap_set(vrf_bitmap_t, vrf_id_t); | |
173 | extern void vrf_bitmap_unset(vrf_bitmap_t, vrf_id_t); | |
174 | extern int vrf_bitmap_check(vrf_bitmap_t, vrf_id_t); | |
7076bb2f | 175 | |
b72ede27 FL |
176 | /* |
177 | * VRF initializer/destructor | |
97b1a80c DS |
178 | * |
179 | * create -> Called back when a new VRF is created. This | |
180 | * can be either through these 3 options: | |
181 | * 1) CLI mentions a vrf before OS knows about it | |
182 | * 2) OS calls zebra and we create the vrf from OS | |
183 | * callback | |
184 | * 3) zebra calls individual protocols to notify | |
185 | * about the new vrf | |
186 | * | |
187 | * enable -> Called back when a VRF is actually usable from | |
188 | * an OS perspective ( 2 and 3 above ) | |
189 | * | |
190 | * disable -> Called back when a VRF is being deleted from | |
191 | * the system ( 2 and 3 ) above | |
192 | * | |
193 | * delete -> Called back when a vrf is being deleted from | |
194 | * the system ( 2 and 3 ) above. | |
b72ede27 | 195 | */ |
d62a17ae | 196 | extern void vrf_init(int (*create)(struct vrf *), int (*enable)(struct vrf *), |
197 | int (*disable)(struct vrf *), int (*delete)(struct vrf *)); | |
97b1a80c DS |
198 | /* |
199 | * Call vrf_terminate when the protocol is being shutdown | |
b72ede27 | 200 | */ |
d62a17ae | 201 | extern void vrf_terminate(void); |
b72ede27 | 202 | |
e5bf3e1e | 203 | /* |
e26aedbe PG |
204 | * Utilities to create networks objects, |
205 | * or call network operations | |
e5bf3e1e FL |
206 | */ |
207 | ||
208 | /* Create a socket serving for the given VRF */ | |
996c9314 | 209 | extern int vrf_socket(int domain, int type, int protocol, vrf_id_t vrf_id, |
0f4977c6 PG |
210 | char *name); |
211 | ||
996c9314 LB |
212 | extern int vrf_sockunion_socket(const union sockunion *su, vrf_id_t vrf_id, |
213 | char *name); | |
0f4977c6 PG |
214 | |
215 | extern int vrf_bind(vrf_id_t vrf_id, int fd, char *name); | |
ce1be369 | 216 | |
2e0d2b3d PG |
217 | /* VRF ioctl operations */ |
218 | extern int vrf_getaddrinfo(const char *node, const char *service, | |
996c9314 LB |
219 | const struct addrinfo *hints, struct addrinfo **res, |
220 | vrf_id_t vrf_id); | |
e26aedbe | 221 | |
516d7591 PG |
222 | extern int vrf_ioctl(vrf_id_t vrf_id, int d, unsigned long request, char *args); |
223 | ||
e26aedbe PG |
224 | /* function called by macro VRF_DEFAULT |
225 | * to get the default VRF_ID | |
226 | */ | |
227 | extern vrf_id_t vrf_get_default_id(void); | |
228 | /* The default VRF ID */ | |
229 | #define VRF_DEFAULT vrf_get_default_id() | |
230 | ||
231 | /* VRF is mapped on netns or not ? */ | |
232 | int vrf_is_mapped_on_netns(vrf_id_t vrf_id); | |
233 | ||
2e0d2b3d PG |
234 | /* VRF switch from NETNS */ |
235 | extern int vrf_switch_to_netns(vrf_id_t vrf_id); | |
236 | extern int vrf_switchback_to_initial(void); | |
237 | ||
e26aedbe PG |
238 | /* |
239 | * VRF backend routines | |
240 | * should be called from zebra only | |
697d3ec7 | 241 | */ |
e5bf3e1e | 242 | |
e26aedbe PG |
243 | /* VRF vty command initialisation |
244 | */ | |
3bc34908 PG |
245 | extern void vrf_cmd_init(int (*writefunc)(struct vty *vty), |
246 | struct zebra_privs_t *daemon_priv); | |
e26aedbe PG |
247 | |
248 | /* VRF vty debugging | |
19dc275e | 249 | */ |
d62a17ae | 250 | extern void vrf_install_commands(void); |
ec31f30d | 251 | |
e26aedbe PG |
252 | /* |
253 | * VRF utilities | |
254 | */ | |
ec31f30d | 255 | |
e26aedbe PG |
256 | /* API for configuring VRF backend |
257 | * should be called from zebra only | |
258 | */ | |
259 | extern void vrf_configure_backend(int vrf_backend_netns); | |
260 | extern int vrf_get_backend(void); | |
261 | extern int vrf_is_backend_netns(void); | |
262 | ||
263 | ||
264 | /* API to create a VRF. either from vty | |
265 | * or through discovery | |
266 | */ | |
996c9314 | 267 | extern int vrf_handler_create(struct vty *vty, const char *name, |
e26aedbe PG |
268 | struct vrf **vrf); |
269 | ||
270 | /* API to associate a VRF with a NETNS. | |
271 | * called either from vty or through discovery | |
272 | * should be called from zebra only | |
273 | */ | |
274 | extern int vrf_netns_handler_create(struct vty *vty, struct vrf *vrf, | |
03aff2d8 PG |
275 | char *pathname, ns_id_t ext_ns_id, |
276 | ns_id_t ns_id); | |
e26aedbe PG |
277 | |
278 | /* used internally to enable or disable VRF. | |
279 | * Notify a change in the VRF ID of the VRF | |
280 | */ | |
281 | extern void vrf_disable(struct vrf *vrf); | |
282 | extern int vrf_enable(struct vrf *vrf); | |
0c902ba5 | 283 | extern void vrf_delete(struct vrf *vrf); |
ec31f30d | 284 | |
b72ede27 | 285 | #endif /*_ZEBRA_VRF_H*/ |