lib/vrf.h

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