ospfd/ospf_opaque.h

   1 /*
   2  * This is an implementation of rfc2370.
   3  * Copyright (C) 2001 KDD R&D Laboratories, Inc.
   4  * http://www.kddlabs.co.jp/
   5  *
   6  * This file is part of GNU Zebra.
   7  *
   8  * GNU Zebra is free software; you can redistribute it and/or modify it
   9  * under the terms of the GNU General Public License as published by the
  10  * Free Software Foundation; either version 2, or (at your option) any
  11  * later version.
  12  *
  13  * GNU Zebra is distributed in the hope that it will be useful, but
  14  * WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License along
  19  * with this program; see the file COPYING; if not, write to the Free Software
  20  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
  21  */
  22
  23 #ifndef _ZEBRA_OSPF_OPAQUE_H
  24 #define _ZEBRA_OSPF_OPAQUE_H
  25
  26 #include "vty.h"
  27
  28 #define IS_OPAQUE_LSA(type)                                                    \
  29         ((type) == OSPF_OPAQUE_LINK_LSA || (type) == OSPF_OPAQUE_AREA_LSA      \
  30          || (type) == OSPF_OPAQUE_AS_LSA)
  31
  32 /*
  33  * Opaque LSA's link state ID is redefined as follows.
  34  *
  35  *        24       16        8        0
  36  * +--------+--------+--------+--------+
  37  * |tttttttt|........|........|........|
  38  * +--------+--------+--------+--------+
  39  * |<-Type->|<------- Opaque ID ------>|
  40  */
  41 #define LSID_OPAQUE_TYPE_MASK   0xff000000      /*  8 bits */
  42 #define LSID_OPAQUE_ID_MASK     0x00ffffff      /* 24 bits */
  43
  44 #define GET_OPAQUE_TYPE(lsid) (((u_int32_t)(lsid)&LSID_OPAQUE_TYPE_MASK) >> 24)
  45
  46 #define GET_OPAQUE_ID(lsid) ((u_int32_t)(lsid)&LSID_OPAQUE_ID_MASK)
  47
  48 #define SET_OPAQUE_LSID(type, id)                                              \
  49         ((((unsigned)(type) << 24) & LSID_OPAQUE_TYPE_MASK)                    \
  50          | ((id) & LSID_OPAQUE_ID_MASK))
  51
  52 /*
  53  * Opaque LSA types will be assigned by IANA.
  54  * <http://www.iana.org/assignments/ospf-opaque-types>
  55  */
  56 #define OPAQUE_TYPE_TRAFFIC_ENGINEERING_LSA             1
  57 #define OPAQUE_TYPE_SYCAMORE_OPTICAL_TOPOLOGY_DESC      2
  58 #define OPAQUE_TYPE_GRACE_LSA                           3
  59 #define OPAQUE_TYPE_L1VPN_LSA                          5
  60 #define OPAQUE_TYPE_ROUTER_INFORMATION_LSA             4
  61 #define OPAQUE_TYPE_INTER_AS_LSA                       6
  62 #define OPAQUE_TYPE_EXTENDED_PREFIX_LSA                7
  63 #define OPAQUE_TYPE_EXTENDED_LINK_LSA                  8
  64 #define OPAQUE_TYPE_MAX                                8
  65
  66 /* Followings types are proposed in internet-draft documents. */
  67 #define OPAQUE_TYPE_8021_QOSPF                          129
  68 #define OPAQUE_TYPE_SECONDARY_NEIGHBOR_DISCOVERY        224
  69 #define OPAQUE_TYPE_FLOODGATE                           225
  70
  71 /* Ugly hack to make use of an unallocated value for wildcard matching! */
  72 #define OPAQUE_TYPE_WILDCARD                            0
  73
  74 #define OPAQUE_TYPE_RANGE_UNASSIGNED(type)                                     \
  75         (OPAQUE_TYPE_MAX <= (type) && (type) <= 127)
  76
  77 #define OPAQUE_TYPE_RANGE_RESERVED(type) (127 < (type) && (type) <= 255)
  78
  79 #define VALID_OPAQUE_INFO_LEN(lsahdr)                                          \
  80         ((ntohs((lsahdr)->length) >= sizeof(struct lsa_header))                \
  81          && ((ntohs((lsahdr)->length) % sizeof(u_int32_t)) == 0))
  82
  83 /*
  84  * Following section defines generic TLV (type, length, value) macros,
  85  * used for various LSA opaque usage e.g. Traffic Engineering.
  86  */
  87 struct tlv_header {
  88         u_int16_t type;         /* Type of Value */
  89         u_int16_t length;       /* Length of Value portion only, in bytes */
  90 };
  91
  92 #define TLV_HDR_SIZE    (sizeof(struct tlv_header))
  93
  94 #define TLV_BODY_SIZE(tlvh) \
  95         (ROUNDUP(ntohs((tlvh)->length), sizeof(u_int32_t)))
  96
  97 #define TLV_SIZE(tlvh)  (TLV_HDR_SIZE + TLV_BODY_SIZE(tlvh))
  98
  99 #define TLV_HDR_TOP(lsah) \
 100         (struct tlv_header *)((char *)(lsah) + OSPF_LSA_HEADER_SIZE)
 101
 102 #define TLV_HDR_NEXT(tlvh) \
 103         (struct tlv_header *)((char *)(tlvh) + TLV_SIZE(tlvh))
 104
 105 #define TLV_HDR_SUBTLV(tlvh) \
 106         (struct tlv_header *)((char *)(tlvh) + TLV_HDR_SIZE)
 107
 108 #define TLV_DATA(tlvh)  (void *)((char *)(tlvh) + TLV_HDR_SIZE)
 109
 110 #define TLV_TYPE(tlvh)  tlvh.header.type
 111 #define TLV_LEN(tlvh)   tlvh.header.length
 112 #define TLV_HDR(tlvh)   tlvh.header
 113
 114 /* Following declaration concerns the Opaque LSA management */
 115 enum lsa_opcode {
 116         REORIGINATE_THIS_LSA,
 117         REFRESH_THIS_LSA,
 118         FLUSH_THIS_LSA
 119 };
 120
 121 /* Prototypes. */
 122
 123 extern void ospf_opaque_init(void);
 124 extern void ospf_opaque_term(void);
 125 extern void ospf_opaque_finish(void);
 126 extern int ospf_opaque_type9_lsa_init(struct ospf_interface *oi);
 127 extern void ospf_opaque_type9_lsa_term(struct ospf_interface *oi);
 128 extern int ospf_opaque_type10_lsa_init(struct ospf_area *area);
 129 extern void ospf_opaque_type10_lsa_term(struct ospf_area *area);
 130 extern int ospf_opaque_type11_lsa_init(struct ospf *ospf);
 131 extern void ospf_opaque_type11_lsa_term(struct ospf *ospf);
 132
 133 extern int ospf_register_opaque_functab(
 134         u_char lsa_type, u_char opaque_type,
 135         int (*new_if_hook)(struct interface *ifp),
 136         int (*del_if_hook)(struct interface *ifp),
 137         void (*ism_change_hook)(struct ospf_interface *oi, int old_status),
 138         void (*nsm_change_hook)(struct ospf_neighbor *nbr, int old_status),
 139         void (*config_write_router)(struct vty *vty),
 140         void (*config_write_if)(struct vty *vty, struct interface *ifp),
 141         void (*config_write_debug)(struct vty *vty),
 142         void (*show_opaque_info)(struct vty *vty, struct ospf_lsa *lsa),
 143         int (*lsa_originator)(void *arg),
 144         struct ospf_lsa *(*lsa_refresher)(struct ospf_lsa *lsa),
 145         int (*new_lsa_hook)(struct ospf_lsa *lsa),
 146         int (*del_lsa_hook)(struct ospf_lsa *lsa));
 147 extern void ospf_delete_opaque_functab(u_char lsa_type, u_char opaque_type);
 148
 149 extern int ospf_opaque_new_if(struct interface *ifp);
 150 extern int ospf_opaque_del_if(struct interface *ifp);
 151 extern void ospf_opaque_ism_change(struct ospf_interface *oi, int old_status);
 152 extern void ospf_opaque_nsm_change(struct ospf_neighbor *nbr, int old_status);
 153 extern void ospf_opaque_config_write_router(struct vty *vty, struct ospf *ospf);
 154 extern void ospf_opaque_config_write_if(struct vty *vty, struct interface *ifp);
 155 extern void ospf_opaque_config_write_debug(struct vty *vty);
 156 extern void show_opaque_info_detail(struct vty *vty, struct ospf_lsa *lsa);
 157 extern void ospf_opaque_lsa_dump(struct stream *s, u_int16_t length);
 158
 159 extern void ospf_opaque_lsa_originate_schedule(struct ospf_interface *oi,
 160                                                int *init_delay);
 161 extern struct ospf_lsa *ospf_opaque_lsa_install(struct ospf_lsa *lsa,
 162                                                 int rt_recalc);
 163 extern struct ospf_lsa *ospf_opaque_lsa_refresh(struct ospf_lsa *lsa);
 164
 165 extern void ospf_opaque_lsa_reoriginate_schedule(void *lsa_type_dependent,
 166                                                  u_char lsa_type,
 167                                                  u_char opaque_type);
 168 extern void ospf_opaque_lsa_refresh_schedule(struct ospf_lsa *lsa);
 169 extern void ospf_opaque_lsa_flush_schedule(struct ospf_lsa *lsa);
 170
 171 extern void ospf_opaque_self_originated_lsa_received(struct ospf_neighbor *nbr,
 172                                                      struct ospf_lsa *lsa);
 173 extern struct ospf *oi_to_top(struct ospf_interface *oi);
 174
 175 #endif /* _ZEBRA_OSPF_OPAQUE_H */