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) (((uint32_t)(lsid)&LSID_OPAQUE_TYPE_MASK) >> 24)
45 
46 #define GET_OPAQUE_ID(lsid) ((uint32_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(uint32_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 	uint16_t type;   /* Type of Value */
89 	uint16_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) (ROUNDUP(ntohs((tlvh)->length), sizeof(uint32_t)))
95 
96 #define TLV_SIZE(tlvh)	(TLV_HDR_SIZE + TLV_BODY_SIZE(tlvh))
97 
98 #define TLV_HDR_TOP(lsah)                                                      \
99 	(struct tlv_header *)((char *)(lsah) + OSPF_LSA_HEADER_SIZE)
100 
101 #define TLV_HDR_NEXT(tlvh)                                                     \
102 	(struct tlv_header *)((char *)(tlvh) + TLV_SIZE(tlvh))
103 
104 #define TLV_HDR_SUBTLV(tlvh)                                                   \
105 	(struct tlv_header *)((char *)(tlvh) + TLV_HDR_SIZE)
106 
107 #define TLV_DATA(tlvh)	(void *)((char *)(tlvh) + TLV_HDR_SIZE)
108 
109 #define TLV_TYPE(tlvh)	tlvh.header.type
110 #define TLV_LEN(tlvh)	tlvh.header.length
111 #define TLV_HDR(tlvh)	tlvh.header
112 
113 /* Following declaration concerns the Opaque LSA management */
114 enum lsa_opcode { REORIGINATE_THIS_LSA, REFRESH_THIS_LSA, FLUSH_THIS_LSA };
115 
116 /* Prototypes. */
117 
118 extern void ospf_opaque_init(void);
119 extern void ospf_opaque_term(void);
120 extern void ospf_opaque_finish(void);
121 extern int ospf_opaque_type9_lsa_init(struct ospf_interface *oi);
122 extern void ospf_opaque_type9_lsa_term(struct ospf_interface *oi);
123 extern int ospf_opaque_type10_lsa_init(struct ospf_area *area);
124 extern void ospf_opaque_type10_lsa_term(struct ospf_area *area);
125 extern int ospf_opaque_type11_lsa_init(struct ospf *ospf);
126 extern void ospf_opaque_type11_lsa_term(struct ospf *ospf);
127 
128 extern int ospf_register_opaque_functab(
129 	uint8_t lsa_type, uint8_t opaque_type,
130 	int (*new_if_hook)(struct interface *ifp),
131 	int (*del_if_hook)(struct interface *ifp),
132 	void (*ism_change_hook)(struct ospf_interface *oi, int old_status),
133 	void (*nsm_change_hook)(struct ospf_neighbor *nbr, int old_status),
134 	void (*config_write_router)(struct vty *vty),
135 	void (*config_write_if)(struct vty *vty, struct interface *ifp),
136 	void (*config_write_debug)(struct vty *vty),
137 	void (*show_opaque_info)(struct vty *vty, struct ospf_lsa *lsa),
138 	int (*lsa_originator)(void *arg),
139 	struct ospf_lsa *(*lsa_refresher)(struct ospf_lsa *lsa),
140 	int (*new_lsa_hook)(struct ospf_lsa *lsa),
141 	int (*del_lsa_hook)(struct ospf_lsa *lsa));
142 extern void ospf_delete_opaque_functab(uint8_t lsa_type, uint8_t opaque_type);
143 
144 extern int ospf_opaque_new_if(struct interface *ifp);
145 extern int ospf_opaque_del_if(struct interface *ifp);
146 extern void ospf_opaque_ism_change(struct ospf_interface *oi, int old_status);
147 extern void ospf_opaque_nsm_change(struct ospf_neighbor *nbr, int old_status);
148 extern void ospf_opaque_config_write_router(struct vty *vty, struct ospf *ospf);
149 extern void ospf_opaque_config_write_if(struct vty *vty, struct interface *ifp);
150 extern void ospf_opaque_config_write_debug(struct vty *vty);
151 extern void show_opaque_info_detail(struct vty *vty, struct ospf_lsa *lsa);
152 extern void ospf_opaque_lsa_dump(struct stream *s, uint16_t length);
153 
154 extern void ospf_opaque_lsa_originate_schedule(struct ospf_interface *oi,
155 					       int *init_delay);
156 extern struct ospf_lsa *ospf_opaque_lsa_install(struct ospf_lsa *lsa,
157 						int rt_recalc);
158 extern struct ospf_lsa *ospf_opaque_lsa_refresh(struct ospf_lsa *lsa);
159 
160 extern void ospf_opaque_lsa_reoriginate_schedule(void *lsa_type_dependent,
161 						 uint8_t lsa_type,
162 						 uint8_t opaque_type);
163 extern void ospf_opaque_lsa_refresh_schedule(struct ospf_lsa *lsa);
164 extern void ospf_opaque_lsa_flush_schedule(struct ospf_lsa *lsa);
165 
166 extern void ospf_opaque_self_originated_lsa_received(struct ospf_neighbor *nbr,
167 						     struct ospf_lsa *lsa);
168 extern struct ospf *oi_to_top(struct ospf_interface *oi);
169 
170 #endif /* _ZEBRA_OSPF_OPAQUE_H */
171