lib/zebra.h

   1 /* Zebra common header.
   2  * Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002 Kunihiro Ishiguro
   3  *
   4  * This file is part of GNU Zebra.
   5  *
   6  * GNU Zebra is free software; you can redistribute it and/or modify it
   7  * under the terms of the GNU General Public License as published by the
   8  * Free Software Foundation; either version 2, or (at your option) any
   9  * later version.
  10  *
  11  * GNU Zebra is distributed in the hope that it will be useful, but
  12  * WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License along
  17  * with this program; see the file COPYING; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
  19  */
  20
  21 #ifndef _ZEBRA_H
  22 #define _ZEBRA_H
  23
  24 #ifdef HAVE_CONFIG_H
  25 #include "config.h"
  26 #endif /* HAVE_CONFIG_H */
  27
  28 #include "compiler.h"
  29
  30 #ifdef SUNOS_5
  31 typedef unsigned int uint32_t;
  32 typedef unsigned short uint16_t;
  33 typedef unsigned char uint8_t;
  34 #endif /* SUNOS_5 */
  35
  36 #include <unistd.h>
  37 #include <stdio.h>
  38 #include <stdlib.h>
  39 #include <stddef.h>
  40 #include <ctype.h>
  41 #include <errno.h>
  42 #include <fcntl.h>
  43 #include <signal.h>
  44 #include <string.h>
  45 #include <pwd.h>
  46 #include <grp.h>
  47 #ifdef HAVE_STROPTS_H
  48 #include <stropts.h>
  49 #endif /* HAVE_STROPTS_H */
  50 #include <sys/select.h>
  51 #include <sys/stat.h>
  52 #include <sys/types.h>
  53 #include <sys/param.h>
  54 #ifdef HAVE_SYS_SYSCTL_H
  55 #ifdef GNU_LINUX
  56 #include <linux/types.h>
  57 #endif
  58 #include <sys/sysctl.h>
  59 #endif /* HAVE_SYS_SYSCTL_H */
  60 #include <sys/ioctl.h>
  61 #ifdef HAVE_SYS_CONF_H
  62 #include <sys/conf.h>
  63 #endif /* HAVE_SYS_CONF_H */
  64 #ifdef HAVE_SYS_KSYM_H
  65 #include <sys/ksym.h>
  66 #endif /* HAVE_SYS_KSYM_H */
  67 #include <syslog.h>
  68 #include <sys/time.h>
  69 #include <time.h>
  70 #include <sys/uio.h>
  71 #include <sys/utsname.h>
  72 #include <sys/resource.h>
  73 #include <limits.h>
  74 #include <inttypes.h>
  75 #include <stdbool.h>
  76
  77 /* machine dependent includes */
  78 #ifdef SUNOS_5
  79 #include <strings.h>
  80 #endif /* SUNOS_5 */
  81
  82 /* machine dependent includes */
  83 #ifdef HAVE_LINUX_VERSION_H
  84 #include <linux/version.h>
  85 #endif /* HAVE_LINUX_VERSION_H */
  86
  87 #ifdef HAVE_ASM_TYPES_H
  88 #include <asm/types.h>
  89 #endif /* HAVE_ASM_TYPES_H */
  90
  91 /* misc include group */
  92 #include <stdarg.h>
  93 #if !(defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L)
  94 /* Not C99; do we need to define va_copy? */
  95 #ifndef va_copy
  96 #ifdef __va_copy
  97 #define va_copy(DST,SRC) __va_copy(DST,SRC)
  98 #else
  99 /* Now we are desperate; this should work on many typical platforms.
 100    But this is slightly dangerous, because the standard does not require
 101    va_copy to be a macro. */
 102 #define va_copy(DST,SRC) memcpy(&(DST), &(SRC), sizeof(va_list))
 103 #warning "Not C99 and no va_copy macro available, falling back to memcpy"
 104 #endif /* __va_copy */
 105 #endif /* !va_copy */
 106 #endif /* !C99 */
 107
 108
 109 #ifdef HAVE_LCAPS
 110 #include <sys/capability.h>
 111 #include <sys/prctl.h>
 112 #endif /* HAVE_LCAPS */
 113
 114 #ifdef HAVE_SOLARIS_CAPABILITIES
 115 #include <priv.h>
 116 #endif /* HAVE_SOLARIS_CAPABILITIES */
 117
 118 /* network include group */
 119
 120 #include <sys/socket.h>
 121
 122 #ifdef HAVE_SYS_SOCKIO_H
 123 #include <sys/sockio.h>
 124 #endif /* HAVE_SYS_SOCKIO_H */
 125
 126 #ifdef __APPLE__
 127 #define __APPLE_USE_RFC_3542
 128 #endif
 129
 130 #ifndef HAVE_LIBCRYPT
 131 #ifdef HAVE_LIBCRYPTO
 132 #include <openssl/des.h>
 133 #      define crypt DES_crypt
 134 #endif
 135 #endif
 136
 137 #include "openbsd-tree.h"
 138
 139 #include <netinet/in.h>
 140 #include <netinet/in_systm.h>
 141 #include <netinet/ip.h>
 142 #include <netinet/tcp.h>
 143
 144 #ifdef HAVE_NET_NETOPT_H
 145 #include <net/netopt.h>
 146 #endif /* HAVE_NET_NETOPT_H */
 147
 148 #include <net/if.h>
 149
 150 #ifdef HAVE_NET_IF_DL_H
 151 #include <net/if_dl.h>
 152 #endif /* HAVE_NET_IF_DL_H */
 153
 154 #ifdef HAVE_NET_IF_VAR_H
 155 #include <net/if_var.h>
 156 #endif /* HAVE_NET_IF_VAR_H */
 157
 158 #include <net/route.h>
 159
 160 #ifdef HAVE_NETLINK
 161 #include <linux/netlink.h>
 162 #include <linux/rtnetlink.h>
 163 #include <linux/filter.h>
 164 #else
 165 #define RT_TABLE_MAIN           0
 166 #endif /* HAVE_NETLINK */
 167
 168 #include <netdb.h>
 169 #include <arpa/inet.h>
 170
 171 #ifdef HAVE_INET_ND_H
 172 #include <inet/nd.h>
 173 #endif /* HAVE_INET_ND_H */
 174
 175 #ifdef HAVE_NETINET_IN_VAR_H
 176 #include <netinet/in_var.h>
 177 #endif /* HAVE_NETINET_IN_VAR_H */
 178
 179 #ifdef HAVE_NETINET6_IN6_VAR_H
 180 #include <netinet6/in6_var.h>
 181 #endif /* HAVE_NETINET6_IN6_VAR_H */
 182
 183 #ifdef HAVE_NETINET_IN6_VAR_H
 184 #include <netinet/in6_var.h>
 185 #endif /* HAVE_NETINET_IN6_VAR_H */
 186
 187 #ifdef HAVE_NETINET6_IN_H
 188 #include <netinet6/in.h>
 189 #endif /* HAVE_NETINET6_IN_H */
 190
 191
 192 #ifdef HAVE_NETINET6_IP6_H
 193 #include <netinet6/ip6.h>
 194 #endif /* HAVE_NETINET6_IP6_H */
 195
 196 #include <netinet/icmp6.h>
 197
 198 #ifdef HAVE_NETINET6_ND6_H
 199 #include <netinet6/nd6.h>
 200 #endif /* HAVE_NETINET6_ND6_H */
 201
 202 /* Some systems do not define UINT32_MAX, etc.. from inttypes.h
 203  * e.g. this makes life easier for FBSD 4.11 users.
 204  */
 205 #ifndef INT8_MAX
 206 #define INT8_MAX        (127)
 207 #endif
 208 #ifndef INT16_MAX
 209 #define INT16_MAX       (32767)
 210 #endif
 211 #ifndef INT32_MAX
 212 #define INT32_MAX       (2147483647)
 213 #endif
 214 #ifndef UINT8_MAX
 215 #define UINT8_MAX       (255U)
 216 #endif
 217 #ifndef UINT16_MAX
 218 #define UINT16_MAX      (65535U)
 219 #endif
 220 #ifndef UINT32_MAX
 221 #define UINT32_MAX      (4294967295U)
 222 #endif
 223
 224 #ifdef HAVE_GLIBC_BACKTRACE
 225 #include <execinfo.h>
 226 #endif /* HAVE_GLIBC_BACKTRACE */
 227
 228 /* Local includes: */
 229 #if !(defined(__GNUC__) || defined(VTYSH_EXTRACT_PL))
 230 #define __attribute__(x)
 231 #endif /* !__GNUC__ || VTYSH_EXTRACT_PL */
 232
 233 #include "zassert.h"
 234
 235 /*
 236  * Add explicit static cast only when using a C++ compiler.
 237  */
 238 #ifdef __cplusplus
 239 #define static_cast(l, r) static_cast<decltype(l)>((r))
 240 #else
 241 #define static_cast(l, r) (r)
 242 #endif
 243
 244 #ifndef HAVE_STRLCAT
 245 size_t strlcat(char *__restrict dest,
 246                const char *__restrict src, size_t destsize);
 247 #endif
 248 #ifndef HAVE_STRLCPY
 249 size_t strlcpy(char *__restrict dest,
 250                const char *__restrict src, size_t destsize);
 251 #endif
 252
 253 /* GCC have printf type attribute check.  */
 254 #ifdef __GNUC__
 255 #define PRINTF_ATTRIBUTE(a,b) __attribute__ ((__format__ (__printf__, a, b)))
 256 #else
 257 #define PRINTF_ATTRIBUTE(a,b)
 258 #endif /* __GNUC__ */
 259
 260 /*
 261  * RFC 3542 defines several macros for using struct cmsghdr.
 262  * Here, we define those that are not present
 263  */
 264
 265 /*
 266  * Internal defines, for use only in this file.
 267  * These are likely wrong on other than ILP32 machines, so warn.
 268  */
 269 #ifndef _CMSG_DATA_ALIGN
 270 #define _CMSG_DATA_ALIGN(n)           (((n) + 3) & ~3)
 271 #endif /* _CMSG_DATA_ALIGN */
 272
 273 #ifndef _CMSG_HDR_ALIGN
 274 #define _CMSG_HDR_ALIGN(n)            (((n) + 3) & ~3)
 275 #endif /* _CMSG_HDR_ALIGN */
 276
 277 /*
 278  * CMSG_SPACE and CMSG_LEN are required in RFC3542, but were new in that
 279  * version.
 280  */
 281 #ifndef CMSG_SPACE
 282 #define CMSG_SPACE(l)                                                          \
 283         (_CMSG_DATA_ALIGN(sizeof(struct cmsghdr)) + _CMSG_HDR_ALIGN(l))
 284 #warning "assuming 4-byte alignment for CMSG_SPACE"
 285 #endif /* CMSG_SPACE */
 286
 287
 288 #ifndef CMSG_LEN
 289 #define CMSG_LEN(l)         (_CMSG_DATA_ALIGN(sizeof(struct cmsghdr)) + (l))
 290 #warning "assuming 4-byte alignment for CMSG_LEN"
 291 #endif /* CMSG_LEN */
 292
 293
 294 /*  The definition of struct in_pktinfo is missing in old version of
 295     GLIBC 2.1 (Redhat 6.1).  */
 296 #if defined(GNU_LINUX) && !defined(HAVE_STRUCT_IN_PKTINFO)
 297 struct in_pktinfo {
 298         int ipi_ifindex;
 299         struct in_addr ipi_spec_dst;
 300         struct in_addr ipi_addr;
 301 };
 302 #endif
 303
 304 /*
 305  * IP_HDRINCL / struct ip byte order
 306  *
 307  * Linux: network byte order
 308  * *BSD: network, except for length and offset. (cf Stevens)
 309  * SunOS: nominally as per BSD. but bug: network order on LE.
 310  * OpenBSD: network byte order, apart from older versions which are as per
 311  *          *BSD
 312  */
 313 #if defined(__NetBSD__)                                                        \
 314         || (defined(__FreeBSD__) && (__FreeBSD_version < 1100030))             \
 315         || (defined(__OpenBSD__) && (OpenBSD < 200311))                        \
 316         || (defined(__APPLE__))                                                \
 317         || (defined(SUNOS_5) && defined(WORDS_BIGENDIAN))
 318 #define HAVE_IP_HDRINCL_BSD_ORDER
 319 #endif
 320
 321 /* Define BYTE_ORDER, if not defined. Useful for compiler conditional
 322  * code, rather than preprocessor conditional.
 323  * Not all the world has this BSD define.
 324  */
 325 #ifndef BYTE_ORDER
 326 #define BIG_ENDIAN      4321    /* least-significant byte first (vax, pc) */
 327 #define LITTLE_ENDIAN   1234    /* most-significant byte first (IBM, net) */
 328 #define PDP_ENDIAN      3412    /* LSB first in word, MSW first in long (pdp) */
 329
 330 #if defined(WORDS_BIGENDIAN)
 331 #define BYTE_ORDER      BIG_ENDIAN
 332 #else  /* !WORDS_BIGENDIAN */
 333 #define BYTE_ORDER      LITTLE_ENDIAN
 334 #endif /* WORDS_BIGENDIAN */
 335
 336 #endif /* ndef BYTE_ORDER */
 337
 338 /* For old definition. */
 339 #ifndef IN6_ARE_ADDR_EQUAL
 340 #define IN6_ARE_ADDR_EQUAL IN6_IS_ADDR_EQUAL
 341 #endif /* IN6_ARE_ADDR_EQUAL */
 342
 343 /* default zebra TCP port for zclient */
 344 #define ZEBRA_PORT                      2600
 345
 346 /* Marker value used in new Zserv, in the byte location corresponding
 347  * the command value in the old zserv header. To allow old and new
 348  * Zserv headers to be distinguished from each other.
 349  */
 350 #define ZEBRA_HEADER_MARKER              254
 351
 352 /*
 353  * The compiler.h header is used for anyone using the CPP_NOTICE
 354  * since this is universally needed, let's add it to zebra.h
 355  */
 356 #include "compiler.h"
 357
 358 /* Zebra route's types are defined in route_types.h */
 359 #include "route_types.h"
 360
 361 #define strmatch(a,b) (!strcmp((a), (b)))
 362
 363 /* Zebra message flags */
 364
 365 /*
 366  * Cause Zebra to consider this routes nexthops recursively
 367  */
 368 #define ZEBRA_FLAG_ALLOW_RECURSION    0x01
 369 /*
 370  * This is a route that is read in on startup that was left around
 371  * from a previous run of FRR
 372  */
 373 #define ZEBRA_FLAG_SELFROUTE          0x02
 374 /*
 375  * This flag is used to tell Zebra that the BGP route being passed
 376  * down is a IBGP route
 377  */
 378 #define ZEBRA_FLAG_IBGP               0x04
 379 /*
 380  * This is a route that has been selected for FIB installation.
 381  * This flag is set in zebra and can be passed up to routing daemons
 382  */
 383 #define ZEBRA_FLAG_SELECTED           0x08
 384 /*
 385  * This is a route that we are telling Zebra that this route *must*
 386  * win and will be installed even over ZEBRA_FLAG_SELECTED
 387  */
 388 #define ZEBRA_FLAG_FIB_OVERRIDE       0x10
 389 /*
 390  * This flag tells Zebra that the route is a EVPN route and should
 391  * be treated specially
 392  */
 393 #define ZEBRA_FLAG_EVPN_ROUTE         0x20
 394 /*
 395  * This flag tells Zebra that it should treat the distance passed
 396  * down as an additional discriminator for route selection of the
 397  * route entry.  This mainly is used for backup static routes.
 398  */
 399 #define ZEBRA_FLAG_RR_USE_DISTANCE    0x40
 400
 401 #ifndef INADDR_LOOPBACK
 402 #define INADDR_LOOPBACK 0x7f000001      /* Internet address 127.0.0.1.  */
 403 #endif
 404
 405 /* Address family numbers from RFC1700. */
 406 typedef enum {
 407         AFI_UNSPEC = 0,
 408         AFI_IP = 1,
 409         AFI_IP6 = 2,
 410         AFI_L2VPN = 3,
 411         AFI_MAX = 4
 412 } afi_t;
 413
 414 /* Subsequent Address Family Identifier. */
 415 typedef enum {
 416         SAFI_UNICAST = 1,
 417         SAFI_MULTICAST = 2,
 418         SAFI_MPLS_VPN = 3,
 419         SAFI_ENCAP = 4,
 420         SAFI_EVPN = 5,
 421         SAFI_LABELED_UNICAST = 6,
 422         SAFI_FLOWSPEC = 7,
 423         SAFI_MAX = 8
 424 } safi_t;
 425
 426 /*
 427  * The above AFI and SAFI definitions are for internal use. The protocol
 428  * definitions (IANA values) as for example used in BGP protocol packets
 429  * are defined below and these will get mapped to/from the internal values
 430  * in the appropriate places.
 431  * The rationale is that the protocol (IANA) values may be sparse and are
 432  * not optimal for use in data-structure sizing.
 433  * Note: Only useful (i.e., supported) values are defined below.
 434  */
 435 typedef enum {
 436         IANA_AFI_RESERVED = 0,
 437         IANA_AFI_IPV4 = 1,
 438         IANA_AFI_IPV6 = 2,
 439         IANA_AFI_L2VPN = 25,
 440         IANA_AFI_IPMR = 128,
 441         IANA_AFI_IP6MR = 129
 442 } iana_afi_t;
 443
 444 typedef enum {
 445         IANA_SAFI_RESERVED = 0,
 446         IANA_SAFI_UNICAST = 1,
 447         IANA_SAFI_MULTICAST = 2,
 448         IANA_SAFI_LABELED_UNICAST = 4,
 449         IANA_SAFI_ENCAP = 7,
 450         IANA_SAFI_EVPN = 70,
 451         IANA_SAFI_MPLS_VPN = 128,
 452         IANA_SAFI_FLOWSPEC = 133
 453 } iana_safi_t;
 454
 455 /* Default Administrative Distance of each protocol. */
 456 #define ZEBRA_KERNEL_DISTANCE_DEFAULT      0
 457 #define ZEBRA_CONNECT_DISTANCE_DEFAULT     0
 458 #define ZEBRA_STATIC_DISTANCE_DEFAULT      1
 459 #define ZEBRA_RIP_DISTANCE_DEFAULT       120
 460 #define ZEBRA_RIPNG_DISTANCE_DEFAULT     120
 461 #define ZEBRA_OSPF_DISTANCE_DEFAULT      110
 462 #define ZEBRA_OSPF6_DISTANCE_DEFAULT     110
 463 #define ZEBRA_ISIS_DISTANCE_DEFAULT      115
 464 #define ZEBRA_IBGP_DISTANCE_DEFAULT      200
 465 #define ZEBRA_EBGP_DISTANCE_DEFAULT       20
 466 #define ZEBRA_TABLE_DISTANCE_DEFAULT      15
 467
 468 /* Flag manipulation macros. */
 469 #define CHECK_FLAG(V,F)      ((V) & (F))
 470 #define SET_FLAG(V,F)        (V) |= (F)
 471 #define UNSET_FLAG(V,F)      (V) &= ~(F)
 472 #define RESET_FLAG(V)        (V) = 0
 473 #define COND_FLAG(V, F, C)   ((C) ? (SET_FLAG(V, F)) : (UNSET_FLAG(V, F)))
 474
 475 /* Atomic flag manipulation macros. */
 476 #define CHECK_FLAG_ATOMIC(PV, F)                                               \
 477         ((atomic_load_explicit(PV, memory_order_seq_cst)) & (F))
 478 #define SET_FLAG_ATOMIC(PV, F)                                                 \
 479         ((atomic_fetch_or_explicit(PV, (F), memory_order_seq_cst)))
 480 #define UNSET_FLAG_ATOMIC(PV, F)                                               \
 481         ((atomic_fetch_and_explicit(PV, ~(F), memory_order_seq_cst)))
 482 #define RESET_FLAG_ATOMIC(PV)                                                  \
 483         ((atomic_store_explicit(PV, 0, memory_order_seq_cst)))
 484
 485 /* Zebra types. Used in Zserv message header. */
 486 typedef uint16_t zebra_size_t;
 487 typedef uint16_t zebra_command_t;
 488
 489 /* VRF ID type. */
 490 typedef uint32_t vrf_id_t;
 491
 492 typedef uint32_t route_tag_t;
 493 #define ROUTE_TAG_MAX UINT32_MAX
 494 #define ROUTE_TAG_PRI PRIu32
 495
 496 static inline afi_t afi_iana2int(iana_afi_t afi)
 497 {
 498         switch (afi) {
 499         case IANA_AFI_IPV4:
 500                 return AFI_IP;
 501         case IANA_AFI_IPV6:
 502                 return AFI_IP6;
 503         case IANA_AFI_L2VPN:
 504                 return AFI_L2VPN;
 505         default:
 506                 return AFI_MAX;
 507         }
 508 }
 509
 510 static inline iana_afi_t afi_int2iana(afi_t afi)
 511 {
 512         switch (afi) {
 513         case AFI_IP:
 514                 return IANA_AFI_IPV4;
 515         case AFI_IP6:
 516                 return IANA_AFI_IPV6;
 517         case AFI_L2VPN:
 518                 return IANA_AFI_L2VPN;
 519         default:
 520                 return IANA_AFI_RESERVED;
 521         }
 522 }
 523
 524 static inline safi_t safi_iana2int(iana_safi_t safi)
 525 {
 526         switch (safi) {
 527         case IANA_SAFI_UNICAST:
 528                 return SAFI_UNICAST;
 529         case IANA_SAFI_MULTICAST:
 530                 return SAFI_MULTICAST;
 531         case IANA_SAFI_MPLS_VPN:
 532                 return SAFI_MPLS_VPN;
 533         case IANA_SAFI_ENCAP:
 534                 return SAFI_ENCAP;
 535         case IANA_SAFI_EVPN:
 536                 return SAFI_EVPN;
 537         case IANA_SAFI_LABELED_UNICAST:
 538                 return SAFI_LABELED_UNICAST;
 539         case IANA_SAFI_FLOWSPEC:
 540                 return SAFI_FLOWSPEC;
 541         default:
 542                 return SAFI_MAX;
 543         }
 544 }
 545
 546 static inline iana_safi_t safi_int2iana(safi_t safi)
 547 {
 548         switch (safi) {
 549         case SAFI_UNICAST:
 550                 return IANA_SAFI_UNICAST;
 551         case SAFI_MULTICAST:
 552                 return IANA_SAFI_MULTICAST;
 553         case SAFI_MPLS_VPN:
 554                 return IANA_SAFI_MPLS_VPN;
 555         case SAFI_ENCAP:
 556                 return IANA_SAFI_ENCAP;
 557         case SAFI_EVPN:
 558                 return IANA_SAFI_EVPN;
 559         case SAFI_LABELED_UNICAST:
 560                 return IANA_SAFI_LABELED_UNICAST;
 561         case SAFI_FLOWSPEC:
 562                 return IANA_SAFI_FLOWSPEC;
 563         default:
 564                 return IANA_SAFI_RESERVED;
 565         }
 566 }
 567
 568 #endif /* _ZEBRA_H */