zebra/interface.h

   1
   2 /* Interface function header.
   3  * Copyright (C) 1999 Kunihiro Ishiguro
   4  *
   5  * This file is part of GNU Zebra.
   6  *
   7  * GNU Zebra is free software; you can redistribute it and/or modify it
   8  * under the terms of the GNU General Public License as published by the
   9  * Free Software Foundation; either version 2, or (at your option) any
  10  * 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_INTERFACE_H
  23 #define _ZEBRA_INTERFACE_H
  24
  25 #include "redistribute.h"
  26 #include "vrf.h"
  27 #include "hook.h"
  28 #include "bitfield.h"
  29
  30 #include "zebra/zebra_l2.h"
  31 #include "zebra/zebra_nhg_private.h"
  32 #include "zebra/zebra_router.h"
  33
  34 #ifdef __cplusplus
  35 extern "C" {
  36 #endif
  37
  38 /* For interface multicast configuration. */
  39 #define IF_ZEBRA_MULTICAST_UNSPEC 0
  40 #define IF_ZEBRA_MULTICAST_ON     1
  41 #define IF_ZEBRA_MULTICAST_OFF    2
  42
  43 /* For interface shutdown configuration. */
  44 #define IF_ZEBRA_SHUTDOWN_OFF    0
  45 #define IF_ZEBRA_SHUTDOWN_ON     1
  46
  47 #define IF_VLAN_BITMAP_MAX 4096
  48
  49 #if defined(HAVE_RTADV)
  50 /* Router advertisement parameter.  From RFC4861, RFC6275 and RFC4191. */
  51 struct rtadvconf {
  52         /* A flag indicating whether or not the router sends periodic Router
  53            Advertisements and responds to Router Solicitations.
  54            Default: false */
  55         int AdvSendAdvertisements;
  56
  57         /* The maximum time allowed between sending unsolicited multicast
  58            Router Advertisements from the interface, in milliseconds.
  59            MUST be no less than 70 ms [RFC6275 7.5] and no greater
  60            than 1800000 ms [RFC4861 6.2.1].
  61
  62            Default: 600000 milliseconds */
  63         int MaxRtrAdvInterval;
  64 #define RTADV_MAX_RTR_ADV_INTERVAL 600000
  65
  66         /* The minimum time allowed between sending unsolicited multicast
  67            Router Advertisements from the interface, in milliseconds.
  68            MUST be no less than 30 ms [RFC6275 7.5].
  69            MUST be no greater than .75 * MaxRtrAdvInterval.
  70
  71            Default: 0.33 * MaxRtrAdvInterval */
  72         int MinRtrAdvInterval; /* This field is currently unused. */
  73 #define RTADV_MIN_RTR_ADV_INTERVAL (0.33 * RTADV_MAX_RTR_ADV_INTERVAL)
  74
  75         /* Unsolicited Router Advertisements' interval timer. */
  76         int AdvIntervalTimer;
  77
  78         /* The true/false value to be placed in the "Managed address
  79            configuration" flag field in the Router Advertisement.  See
  80            [ADDRCONF].
  81
  82            Default: false */
  83         int AdvManagedFlag;
  84
  85
  86         /* The true/false value to be placed in the "Other stateful
  87            configuration" flag field in the Router Advertisement.  See
  88            [ADDRCONF].
  89
  90            Default: false */
  91         int AdvOtherConfigFlag;
  92
  93         /* The value to be placed in MTU options sent by the router.  A
  94            value of zero indicates that no MTU options are sent.
  95
  96            Default: 0 */
  97         int AdvLinkMTU;
  98
  99
 100         /* The value to be placed in the Reachable Time field in the Router
 101            Advertisement messages sent by the router.  The value zero means
 102            unspecified (by this router).  MUST be no greater than 3,600,000
 103            milliseconds (1 hour).
 104
 105            Default: 0 */
 106         uint32_t AdvReachableTime;
 107 #define RTADV_MAX_REACHABLE_TIME 3600000
 108
 109         /* The value to be placed in the Retrans Timer field in the Router
 110            Advertisement messages sent by the router.  The value zero means
 111            unspecified (by this router).
 112
 113            Default: 0 */
 114         int AdvRetransTimer;
 115
 116         /* The default value to be placed in the Cur Hop Limit field in the
 117            Router Advertisement messages sent by the router.  The value
 118            should be set to that current diameter of the Internet.  The
 119            value zero means unspecified (by this router).
 120
 121            Default: The value specified in the "Assigned Numbers" RFC
 122            [ASSIGNED] that was in effect at the time of implementation. */
 123         int AdvCurHopLimit;
 124 #define RTADV_DEFAULT_HOPLIMIT 64 /* 64 hops */
 125
 126         /* The value to be placed in the Router Lifetime field of Router
 127            Advertisements sent from the interface, in seconds.  MUST be
 128            either zero or between MaxRtrAdvInterval and 9000 seconds.  A
 129            value of zero indicates that the router is not to be used as a
 130            default router.
 131
 132            Default: 3 * MaxRtrAdvInterval */
 133         int AdvDefaultLifetime;
 134 #define RTADV_MAX_RTRLIFETIME 9000 /* 2.5 hours */
 135
 136         /* A list of prefixes to be placed in Prefix Information options in
 137            Router Advertisement messages sent from the interface.
 138
 139            Default: all prefixes that the router advertises via routing
 140            protocols as being on-link for the interface from which the
 141            advertisement is sent. The link-local prefix SHOULD NOT be
 142            included in the list of advertised prefixes. */
 143         struct list *AdvPrefixList;
 144
 145         /* The true/false value to be placed in the "Home agent"
 146            flag field in the Router Advertisement.  See [RFC6275 7.1].
 147
 148            Default: false */
 149         int AdvHomeAgentFlag;
 150 #ifndef ND_RA_FLAG_HOME_AGENT
 151 #define ND_RA_FLAG_HOME_AGENT   0x20
 152 #endif
 153
 154         /* The value to be placed in Home Agent Information option if Home
 155            Flag is set.
 156            Default: 0 */
 157         int HomeAgentPreference;
 158
 159         /* The value to be placed in Home Agent Information option if Home
 160            Flag is set. Lifetime (seconds) MUST not be greater than 18.2
 161            hours.
 162            The value 0 has special meaning: use of AdvDefaultLifetime value.
 163
 164            Default: 0 */
 165         int HomeAgentLifetime;
 166 #define RTADV_MAX_HALIFETIME 65520 /* 18.2 hours */
 167
 168         /* The true/false value to insert or not an Advertisement Interval
 169            option. See [RFC 6275 7.3]
 170
 171            Default: false */
 172         int AdvIntervalOption;
 173
 174         /* The value to be placed in the Default Router Preference field of
 175            a router advertisement. See [RFC 4191 2.1 & 2.2]
 176
 177            Default: 0 (medium) */
 178         int DefaultPreference;
 179 #define RTADV_PREF_MEDIUM 0x0 /* Per RFC4191. */
 180
 181         /*
 182          * List of recursive DNS servers to include in the RDNSS option.
 183          * See [RFC8106 5.1]
 184          *
 185          * Default: empty list; do not emit RDNSS option
 186          */
 187         struct list *AdvRDNSSList;
 188
 189         /*
 190          * List of DNS search domains to include in the DNSSL option.
 191          * See [RFC8106 5.2]
 192          *
 193          * Default: empty list; do not emit DNSSL option
 194          */
 195         struct list *AdvDNSSLList;
 196
 197         /*
 198          * rfc4861 states RAs must be sent at least 3 seconds apart.
 199          * We allow faster retransmits to speed up convergence but can
 200          * turn that capability off to meet the rfc if needed.
 201          */
 202         bool UseFastRexmit; /* True if fast rexmits are enabled */
 203
 204         uint8_t inFastRexmit; /* True if we're rexmits faster than usual */
 205
 206         /* Track if RA was configured by BGP or by the Operator or both */
 207         uint8_t ra_configured;    /* Was RA configured? */
 208 #define BGP_RA_CONFIGURED (1<<0)  /* BGP configured RA? */
 209 #define VTY_RA_CONFIGURED (1<<1)  /* Operator configured RA? */
 210 #define VTY_RA_INTERVAL_CONFIGURED (1<<2)  /* Operator configured RA interval */
 211         int NumFastReXmitsRemain; /* Loaded first with number of fast
 212                                      rexmits to do */
 213
 214 #define RTADV_FAST_REXMIT_PERIOD 1 /* 1 sec */
 215 #define RTADV_NUM_FAST_REXMITS   4 /* Fast Rexmit RA 4 times on certain events */
 216 };
 217
 218 struct rtadv_rdnss {
 219         /* Address of recursive DNS server to advertise */
 220         struct in6_addr addr;
 221
 222         /*
 223          * Lifetime in seconds; all-ones means infinity, zero
 224          * stop using it.
 225          */
 226         uint32_t lifetime;
 227
 228         /* If lifetime not set, use a default of 3*MaxRtrAdvInterval */
 229         int lifetime_set;
 230 };
 231
 232 /*
 233  * [RFC1035 2.3.4] sets the maximum length of a domain name (a sequence of
 234  * labels, each prefixed by a length octet) at 255 octets.
 235  */
 236 #define RTADV_MAX_ENCODED_DOMAIN_NAME 255
 237
 238 struct rtadv_dnssl {
 239         /* Domain name without trailing root zone dot (NUL-terminated) */
 240         char name[RTADV_MAX_ENCODED_DOMAIN_NAME - 1];
 241
 242         /* Name encoded as in [RFC1035 3.1] */
 243         uint8_t encoded_name[RTADV_MAX_ENCODED_DOMAIN_NAME];
 244
 245         /* Actual length of encoded_name */
 246         size_t encoded_len;
 247
 248         /* Lifetime as for RDNSS */
 249         uint32_t lifetime;
 250         int lifetime_set;
 251 };
 252
 253 #endif /* HAVE_RTADV */
 254
 255 /* Zebra interface type - ones of interest. */
 256 enum zebra_iftype {
 257         ZEBRA_IF_OTHER = 0, /* Anything else */
 258         ZEBRA_IF_VXLAN,     /* VxLAN interface */
 259         ZEBRA_IF_VRF,       /* VRF device */
 260         ZEBRA_IF_BRIDGE,    /* bridge device */
 261         ZEBRA_IF_VLAN,      /* VLAN sub-interface */
 262         ZEBRA_IF_MACVLAN,   /* MAC VLAN interface*/
 263         ZEBRA_IF_VETH,      /* VETH interface*/
 264         ZEBRA_IF_BOND,      /* Bond */
 265         ZEBRA_IF_BOND_SLAVE,        /* Bond */
 266         ZEBRA_IF_GRE,      /* GRE interface */
 267 };
 268
 269 /* Zebra "slave" interface type */
 270 enum zebra_slave_iftype {
 271         ZEBRA_IF_SLAVE_NONE,   /* Not a slave */
 272         ZEBRA_IF_SLAVE_VRF,    /* Member of a VRF */
 273         ZEBRA_IF_SLAVE_BRIDGE, /* Member of a bridge */
 274         ZEBRA_IF_SLAVE_BOND,   /* Bond member */
 275         ZEBRA_IF_SLAVE_OTHER,  /* Something else - e.g., bond slave */
 276 };
 277
 278 struct irdp_interface;
 279
 280 /* Ethernet segment info used for setting up EVPN multihoming */
 281 struct zebra_evpn_es;
 282 struct zebra_es_if_info {
 283         /* type-3 esi config */
 284         struct ethaddr sysmac;
 285         uint32_t lid; /* local-id; has to be unique per-ES-sysmac */
 286
 287         esi_t esi;
 288
 289         uint16_t df_pref;
 290         uint8_t flags;
 291 #define ZIF_CFG_ES_FLAG_BYPASS (1 << 0)
 292
 293         struct zebra_evpn_es *es; /* local ES */
 294 };
 295
 296 enum zebra_if_flags {
 297         /* device has been configured as an uplink for
 298          * EVPN multihoming
 299          */
 300         ZIF_FLAG_EVPN_MH_UPLINK = (1 << 0),
 301         ZIF_FLAG_EVPN_MH_UPLINK_OPER_UP = (1 << 1),
 302
 303         /* Dataplane protodown-on */
 304         ZIF_FLAG_PROTODOWN = (1 << 2),
 305
 306         /* LACP bypass state is set by the dataplane on a bond member
 307          * and inherited by the bond (if one or more bond members are in
 308          * a bypass state the bond is placed in a bypass state)
 309          */
 310         ZIF_FLAG_LACP_BYPASS = (1 << 3)
 311 };
 312
 313 /* `zebra' daemon local interface structure. */
 314 struct zebra_if {
 315         /* back pointer to the interface */
 316         struct interface *ifp;
 317
 318         enum zebra_if_flags flags;
 319
 320         /* Shutdown configuration. */
 321         uint8_t shutdown;
 322
 323         /* Multicast configuration. */
 324         uint8_t multicast;
 325
 326         /* Router advertise configuration. */
 327         uint8_t rtadv_enable;
 328
 329         /* Installed addresses chains tree. */
 330         struct route_table *ipv4_subnets;
 331
 332         /* Nexthops pointing to this interface */
 333         /**
 334          * Any nexthop that we get should have an
 335          * interface. When an interface goes down,
 336          * we will use this list to update the nexthops
 337          * pointing to it with that info.
 338          */
 339         struct nhg_connected_tree_head nhg_dependents;
 340
 341         /* Information about up/down changes */
 342         unsigned int up_count;
 343         char up_last[QUAGGA_TIMESTAMP_LEN];
 344         unsigned int down_count;
 345         char down_last[QUAGGA_TIMESTAMP_LEN];
 346
 347 #if defined(HAVE_RTADV)
 348         struct rtadvconf rtadv;
 349         unsigned int ra_sent, ra_rcvd;
 350 #endif /* HAVE_RTADV */
 351
 352         struct irdp_interface *irdp;
 353
 354 #ifdef HAVE_STRUCT_SOCKADDR_DL
 355         union {
 356                 /* note that sdl_storage is never accessed, it only exists to
 357                  * make space.
 358                  * all actual uses refer to sdl - but use sizeof(sdl_storage)!
 359                  * this fits
 360                  * best with C aliasing rules. */
 361                 struct sockaddr_dl sdl;
 362                 struct sockaddr_storage sdl_storage;
 363         };
 364 #endif
 365
 366         /* ptm enable configuration */
 367         uint8_t ptm_enable;
 368
 369         /* Zebra interface and "slave" interface type */
 370         enum zebra_iftype zif_type;
 371         enum zebra_slave_iftype zif_slave_type;
 372
 373         /* Additional L2 info, depends on zif_type */
 374         union zebra_l2if_info l2info;
 375
 376         /* For members of a bridge, link to bridge. */
 377         /* Note: If additional fields become necessary, this can be modified to
 378          * be a pointer to a dynamically allocd struct.
 379          */
 380         struct zebra_l2info_brslave brslave_info;
 381
 382         struct zebra_l2info_bondslave bondslave_info;
 383         struct zebra_l2info_bond bond_info;
 384
 385         /* ethernet segment */
 386         struct zebra_es_if_info es_info;
 387
 388         /* bitmap of vlans associated with this interface */
 389         bitfield_t vlan_bitmap;
 390
 391         /* An interface can be error-disabled if a protocol (such as EVPN or
 392          * VRRP) detects a problem with keeping it operationally-up.
 393          * If any of the protodown bits are set protodown-on is programmed
 394          * in the dataplane. This results in a carrier/L1 down on the
 395          * physical device.
 396          */
 397         enum protodown_reasons protodown_rc;
 398
 399         /* list of zebra_mac entries using this interface as destination */
 400         struct list *mac_list;
 401
 402         /* Link fields - for sub-interfaces. */
 403         ifindex_t link_ifindex;
 404         struct interface *link;
 405
 406         struct thread *speed_update;
 407
 408         /*
 409          * Does this interface have a v6 to v4 ll neighbor entry
 410          * for bgp unnumbered?
 411          */
 412         bool v6_2_v4_ll_neigh_entry;
 413         char neigh_mac[6];
 414         struct in6_addr v6_2_v4_ll_addr6;
 415
 416         /* The description of the interface */
 417         char *desc;
 418 };
 419
 420 DECLARE_HOOK(zebra_if_extra_info, (struct vty * vty, struct interface *ifp),
 421              (vty, ifp));
 422 DECLARE_HOOK(zebra_if_config_wr, (struct vty * vty, struct interface *ifp),
 423              (vty, ifp));
 424
 425 #define IS_ZEBRA_IF_VRF(ifp)                                                   \
 426         (((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_VRF)
 427
 428 #define IS_ZEBRA_IF_BRIDGE(ifp)                                                \
 429         (((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_BRIDGE)
 430
 431 #define IS_ZEBRA_IF_VLAN(ifp)                                                  \
 432         (((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_VLAN)
 433
 434 #define IS_ZEBRA_IF_VXLAN(ifp)                                                 \
 435         (((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_VXLAN)
 436
 437 #define IS_ZEBRA_IF_MACVLAN(ifp)                                               \
 438         (((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_MACVLAN)
 439
 440 #define IS_ZEBRA_IF_VETH(ifp)                                               \
 441         (((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_VETH)
 442
 443 #define IS_ZEBRA_IF_BOND(ifp)                                                  \
 444         (((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_BOND)
 445
 446 #define IS_ZEBRA_IF_GRE(ifp)                                               \
 447         (((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_GRE)
 448
 449 #define IS_ZEBRA_IF_BRIDGE_SLAVE(ifp)                                   \
 450         (((struct zebra_if *)(ifp->info))->zif_slave_type                      \
 451          == ZEBRA_IF_SLAVE_BRIDGE)
 452
 453 #define IS_ZEBRA_IF_VRF_SLAVE(ifp)                                             \
 454         (((struct zebra_if *)(ifp->info))->zif_slave_type == ZEBRA_IF_SLAVE_VRF)
 455
 456 #define IS_ZEBRA_IF_BOND_SLAVE(ifp)                                     \
 457         (((struct zebra_if *)(ifp->info))->zif_slave_type                      \
 458          == ZEBRA_IF_SLAVE_BOND)
 459
 460 extern void zebra_if_init(void);
 461
 462 extern struct interface *if_lookup_by_index_per_ns(struct zebra_ns *, uint32_t);
 463 extern struct interface *if_lookup_by_name_per_ns(struct zebra_ns *,
 464                                                   const char *);
 465 extern struct interface *if_link_per_ns(struct zebra_ns *, struct interface *);
 466 extern const char *ifindex2ifname_per_ns(struct zebra_ns *, unsigned int);
 467
 468 extern void if_unlink_per_ns(struct interface *);
 469 extern void if_nbr_mac_to_ipv4ll_neigh_update(struct interface *fip,
 470                                               char mac[6],
 471                                               struct in6_addr *address,
 472                                               int add);
 473 extern void if_nbr_ipv6ll_to_ipv4ll_neigh_update(struct interface *ifp,
 474                                                  struct in6_addr *address,
 475                                                  int add);
 476 extern void if_nbr_ipv6ll_to_ipv4ll_neigh_del_all(struct interface *ifp);
 477 extern void if_delete_update(struct interface *ifp);
 478 extern void if_add_update(struct interface *ifp);
 479 extern void if_up(struct interface *);
 480 extern void if_down(struct interface *);
 481 extern void if_refresh(struct interface *);
 482 extern void if_flags_update(struct interface *, uint64_t);
 483 extern int if_subnet_add(struct interface *, struct connected *);
 484 extern int if_subnet_delete(struct interface *, struct connected *);
 485 extern int ipv6_address_configured(struct interface *ifp);
 486 extern void if_handle_vrf_change(struct interface *ifp, vrf_id_t vrf_id);
 487 extern void zebra_if_update_link(struct interface *ifp, ifindex_t link_ifindex,
 488                                  ns_id_t ns_id);
 489 extern void zebra_if_update_all_links(struct zebra_ns *zns);
 490 extern void zebra_if_set_protodown(struct interface *ifp, bool down);
 491 extern int if_ip_address_install(struct interface *ifp, struct prefix *prefix,
 492                                  const char *label, struct prefix *pp);
 493 extern int if_ipv6_address_install(struct interface *ifp, struct prefix *prefix,
 494                                    const char *label);
 495 extern int if_ip_address_uinstall(struct interface *ifp, struct prefix *prefix);
 496 extern int if_shutdown(struct interface *ifp);
 497 extern int if_no_shutdown(struct interface *ifp);
 498 extern int if_multicast_set(struct interface *ifp);
 499 extern int if_multicast_unset(struct interface *ifp);
 500 extern int if_linkdetect(struct interface *ifp, bool detect);
 501 extern void if_addr_wakeup(struct interface *ifp);
 502
 503 /* Nexthop group connected functions */
 504 extern void if_nhg_dependents_add(struct interface *ifp,
 505                                   struct nhg_hash_entry *nhe);
 506 extern void if_nhg_dependents_del(struct interface *ifp,
 507                                   struct nhg_hash_entry *nhe);
 508 extern unsigned int if_nhg_dependents_count(const struct interface *ifp);
 509 extern bool if_nhg_dependents_is_empty(const struct interface *ifp);
 510
 511 extern void vrf_add_update(struct vrf *vrfp);
 512 extern void zebra_l2_map_slave_to_bond(struct zebra_if *zif, vrf_id_t vrf);
 513 extern void zebra_l2_unmap_slave_from_bond(struct zebra_if *zif);
 514 extern const char *zebra_protodown_rc_str(enum protodown_reasons protodown_rc,
 515                                           char *pd_buf, uint32_t pd_buf_len);
 516 void zebra_if_addr_update_ctx(struct zebra_dplane_ctx *ctx);
 517
 518 #ifdef HAVE_PROC_NET_DEV
 519 extern void ifstat_update_proc(void);
 520 #endif /* HAVE_PROC_NET_DEV */
 521 #ifdef HAVE_NET_RT_IFLIST
 522 extern void ifstat_update_sysctl(void);
 523
 524 #endif /* HAVE_NET_RT_IFLIST */
 525 #ifdef HAVE_PROC_NET_DEV
 526 extern int interface_list_proc(void);
 527 #endif /* HAVE_PROC_NET_DEV */
 528 #ifdef HAVE_PROC_NET_IF_INET6
 529 extern int ifaddr_proc_ipv6(void);
 530 #endif /* HAVE_PROC_NET_IF_INET6 */
 531
 532 #ifdef __cplusplus
 533 }
 534 #endif
 535
 536 #endif /* _ZEBRA_INTERFACE_H */