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_MAX                                6
  63
  64 /* Followings types are proposed in internet-draft documents. */
  65 #define OPAQUE_TYPE_8021_QOSPF                          129
  66 #define OPAQUE_TYPE_SECONDARY_NEIGHBOR_DISCOVERY        224
  67 #define OPAQUE_TYPE_FLOODGATE                           225
  68
  69 /* Ugly hack to make use of an unallocated value for wildcard matching! */
  70 #define OPAQUE_TYPE_WILDCARD                            0
  71
  72 #define OPAQUE_TYPE_RANGE_UNASSIGNED(type)                                     \
  73         (OPAQUE_TYPE_MAX <= (type) && (type) <= 127)
  74
  75 #define OPAQUE_TYPE_RANGE_RESERVED(type) (127 < (type) && (type) <= 255)
  76
  77 #define VALID_OPAQUE_INFO_LEN(lsahdr)                                          \
  78         ((ntohs((lsahdr)->length) >= sizeof(struct lsa_header))                \
  79          && ((ntohs((lsahdr)->length) % sizeof(u_int32_t)) == 0))
  80
  81 /*
  82  * Following section defines generic TLV (type, length, value) macros,
  83  * used for various LSA opaque usage e.g. Traffic Engineering.
  84  */
  85 struct tlv_header {
  86         u_int16_t type;         /* Type of Value */
  87         u_int16_t length;       /* Length of Value portion only, in bytes */
  88 };
  89
  90 #define TLV_HDR_SIZE    (sizeof(struct tlv_header))
  91
  92 #define TLV_BODY_SIZE(tlvh) \
  93         (ROUNDUP(ntohs((tlvh)->length), sizeof(u_int32_t)))
  94
  95 #define TLV_SIZE(tlvh)  (TLV_HDR_SIZE + TLV_BODY_SIZE(tlvh))
  96
  97 #define TLV_HDR_TOP(lsah) \
  98         (struct tlv_header *)((char *)(lsah) + OSPF_LSA_HEADER_SIZE)
  99
 100 #define TLV_HDR_NEXT(tlvh) \
 101         (struct tlv_header *)((char *)(tlvh) + TLV_SIZE(tlvh))
 102
 103 #define TLV_HDR_SUBTLV(tlvh) \
 104         (struct tlv_header *)((char *)(tlvh) + TLV_HDR_SIZE)
 105
 106 #define TLV_DATA(tlvh)  (void *)((char *)(tlvh) + TLV_HDR_SIZE)
 107
 108 #define TLV_TYPE(tlvh)  tlvh.header.type
 109 #define TLV_LEN(tlvh)   tlvh.header.length
 110 #define TLV_HDR(tlvh)   tlvh.header
 111
 112 /* Following declaration concerns the Opaque LSA management */
 113 enum lsa_opcode {
 114         REORIGINATE_THIS_LSA,
 115         REFRESH_THIS_LSA,
 116         FLUSH_THIS_LSA
 117 };
 118
 119 /* Prototypes. */
 120
 121 extern void ospf_opaque_init(void);
 122 extern void ospf_opaque_term(void);
 123 extern int ospf_opaque_type9_lsa_init(struct ospf_interface *oi);
 124 extern void ospf_opaque_type9_lsa_term(struct ospf_interface *oi);
 125 extern int ospf_opaque_type10_lsa_init(struct ospf_area *area);
 126 extern void ospf_opaque_type10_lsa_term(struct ospf_area *area);
 127 extern int ospf_opaque_type11_lsa_init(struct ospf *ospf);
 128 extern void ospf_opaque_type11_lsa_term(struct ospf *ospf);
 129
 130 extern int ospf_register_opaque_functab(
 131         u_char lsa_type, u_char opaque_type,
 132         int (*new_if_hook)(struct interface *ifp),
 133         int (*del_if_hook)(struct interface *ifp),
 134         void (*ism_change_hook)(struct ospf_interface *oi, int old_status),
 135         void (*nsm_change_hook)(struct ospf_neighbor *nbr, int old_status),
 136         void (*config_write_router)(struct vty *vty),
 137         void (*config_write_if)(struct vty *vty, struct interface *ifp),
 138         void (*config_write_debug)(struct vty *vty),
 139         void (*show_opaque_info)(struct vty *vty, struct ospf_lsa *lsa),
 140         int (*lsa_originator)(void *arg),
 141         struct ospf_lsa *(*lsa_refresher)(struct ospf_lsa *lsa),
 142         int (*new_lsa_hook)(struct ospf_lsa *lsa),
 143         int (*del_lsa_hook)(struct ospf_lsa *lsa));
 144 extern void ospf_delete_opaque_functab(u_char lsa_type, u_char opaque_type);
 145
 146 extern int ospf_opaque_new_if(struct interface *ifp);
 147 extern int ospf_opaque_del_if(struct interface *ifp);
 148 extern void ospf_opaque_ism_change(struct ospf_interface *oi, int old_status);
 149 extern void ospf_opaque_nsm_change(struct ospf_neighbor *nbr, int old_status);
 150 extern void ospf_opaque_config_write_router(struct vty *vty, struct ospf *ospf);
 151 extern void ospf_opaque_config_write_if(struct vty *vty, struct interface *ifp);
 152 extern void ospf_opaque_config_write_debug(struct vty *vty);
 153 extern void show_opaque_info_detail(struct vty *vty, struct ospf_lsa *lsa);
 154 extern void ospf_opaque_lsa_dump(struct stream *s, u_int16_t length);
 155
 156 extern void ospf_opaque_lsa_originate_schedule(struct ospf_interface *oi,
 157                                                int *init_delay);
 158 extern struct ospf_lsa *ospf_opaque_lsa_install(struct ospf_lsa *lsa,
 159                                                 int rt_recalc);
 160 extern struct ospf_lsa *ospf_opaque_lsa_refresh(struct ospf_lsa *lsa);
 161
 162 extern void ospf_opaque_lsa_reoriginate_schedule(void *lsa_type_dependent,
 163                                                  u_char lsa_type,
 164                                                  u_char opaque_type);
 165 extern void ospf_opaque_lsa_refresh_schedule(struct ospf_lsa *lsa);
 166 extern void ospf_opaque_lsa_flush_schedule(struct ospf_lsa *lsa);
 167
 168 extern void ospf_opaque_self_originated_lsa_received(struct ospf_neighbor *nbr,
 169                                                      struct ospf_lsa *lsa);
 170 extern struct ospf *oi_to_top(struct ospf_interface *oi);
 171
 172 #endif /* _ZEBRA_OSPF_OPAQUE_H */