]> git.proxmox.com Git - mirror_frr.git/blame - ospfd/ospf_lsa.h
topotests: increase OSPF convergence speed
[mirror_frr.git] / ospfd / ospf_lsa.h
CommitLineData
718e3744 1/*
2 * OSPF Link State Advertisement
3 * Copyright (C) 1999, 2000 Toshiaki Takada
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 *
896014f4
DL
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
718e3744 20 */
21
22#ifndef _ZEBRA_OSPF_LSA_H
23#define _ZEBRA_OSPF_LSA_H
24
4dadc291 25#include "stream.h"
26
236e900c
QY
27/* OSPF LSA Default metric values */
28#define DEFAULT_DEFAULT_METRIC 20
29#define DEFAULT_DEFAULT_ORIGINATE_METRIC 10
30#define DEFAULT_DEFAULT_ALWAYS_METRIC 1
31#define DEFAULT_METRIC_TYPE EXTERNAL_METRIC_TYPE_2
32
718e3744 33/* OSPF LSA Range definition. */
34#define OSPF_MIN_LSA 1 /* begin range here */
718e3744 35#define OSPF_MAX_LSA 12
718e3744 36
37/* OSPF LSA Type definition. */
38#define OSPF_UNKNOWN_LSA 0
39#define OSPF_ROUTER_LSA 1
40#define OSPF_NETWORK_LSA 2
41#define OSPF_SUMMARY_LSA 3
42#define OSPF_ASBR_SUMMARY_LSA 4
43#define OSPF_AS_EXTERNAL_LSA 5
44#define OSPF_GROUP_MEMBER_LSA 6 /* Not supported. */
45#define OSPF_AS_NSSA_LSA 7
46#define OSPF_EXTERNAL_ATTRIBUTES_LSA 8 /* Not supported. */
47#define OSPF_OPAQUE_LINK_LSA 9
48#define OSPF_OPAQUE_AREA_LSA 10
49#define OSPF_OPAQUE_AS_LSA 11
50
779adb01 51#define OSPF_LSA_HEADER_SIZE 20U
52#define OSPF_ROUTER_LSA_LINK_SIZE 12U
05b7709d 53#define OSPF_ROUTER_LSA_TOS_SIZE 4U
779adb01 54#define OSPF_MAX_LSA_SIZE 1500U
718e3744 55
56/* AS-external-LSA refresh method. */
57#define LSA_REFRESH_IF_CHANGED 0
58#define LSA_REFRESH_FORCE 1
59
60/* OSPF LSA header. */
d62a17ae 61struct lsa_header {
d7c0a89a
QY
62 uint16_t ls_age;
63 uint8_t options;
64 uint8_t type;
d62a17ae 65 struct in_addr id;
66 struct in_addr adv_router;
d7c0a89a
QY
67 uint32_t ls_seqnum;
68 uint16_t checksum;
69 uint16_t length;
718e3744 70};
71
c971918a
DL
72struct vertex;
73
718e3744 74/* OSPF LSA. */
d62a17ae 75struct ospf_lsa {
76 /* LSA origination flag. */
d7c0a89a 77 uint8_t flags;
718e3744 78#define OSPF_LSA_SELF 0x01
79#define OSPF_LSA_SELF_CHECKED 0x02
80#define OSPF_LSA_RECEIVED 0x04
81#define OSPF_LSA_APPROVED 0x08
82#define OSPF_LSA_DISCARD 0x10
718e3744 83#define OSPF_LSA_LOCAL_XLT 0x20
7ddf1d6e 84#define OSPF_LSA_PREMATURE_AGE 0x40
3106a032 85#define OSPF_LSA_IN_MAXAGE 0x80
718e3744 86
8db278b5 87 /* LSA data. and size */
d62a17ae 88 struct lsa_header *data;
8db278b5 89 size_t size;
718e3744 90
d62a17ae 91 /* Received time stamp. */
92 struct timeval tv_recv;
718e3744 93
d62a17ae 94 /* Last time it was originated */
95 struct timeval tv_orig;
718e3744 96
d62a17ae 97 /* All of reference count, also lock to remove. */
98 int lock;
718e3744 99
d62a17ae 100 /* Flags for the SPF calculation. */
c971918a 101 struct vertex *stat;
718e3744 102
d62a17ae 103 /* References to this LSA in neighbor retransmission lists*/
104 int retransmit_counter;
718e3744 105
d62a17ae 106 /* Area the LSA belongs to, may be NULL if AS-external-LSA. */
107 struct ospf_area *area;
718e3744 108
d62a17ae 109 /* Parent LSDB. */
110 struct ospf_lsdb *lsdb;
718e3744 111
d62a17ae 112 /* Related Route. */
113 void *route;
114
115 /* Refreshement List or Queue */
116 int refresh_list;
117
118 /* For Type-9 Opaque-LSAs */
119 struct ospf_interface *oi;
b5a8894d
CS
120
121 /* VRF Id */
122 vrf_id_t vrf_id;
ad686992 123
124 /*For topo chg detection in HELPER role*/
125 bool to_be_acknowledged;
718e3744 126};
127
128/* OSPF LSA Link Type. */
129#define LSA_LINK_TYPE_POINTOPOINT 1
130#define LSA_LINK_TYPE_TRANSIT 2
131#define LSA_LINK_TYPE_STUB 3
132#define LSA_LINK_TYPE_VIRTUALLINK 4
133
134/* OSPF Router LSA Flag. */
135#define ROUTER_LSA_BORDER 0x01 /* The router is an ABR */
136#define ROUTER_LSA_EXTERNAL 0x02 /* The router is an ASBR */
137#define ROUTER_LSA_VIRTUAL 0x04 /* The router has a VL in this area */
0c9491b3 138#define ROUTER_LSA_NT 0x10 /* The routers always translates Type-7 */
718e3744 139#define ROUTER_LSA_SHORTCUT 0x20 /* Shortcut-ABR specific flag */
140
141#define IS_ROUTER_LSA_VIRTUAL(x) ((x)->flags & ROUTER_LSA_VIRTUAL)
142#define IS_ROUTER_LSA_EXTERNAL(x) ((x)->flags & ROUTER_LSA_EXTERNAL)
143#define IS_ROUTER_LSA_BORDER(x) ((x)->flags & ROUTER_LSA_BORDER)
144#define IS_ROUTER_LSA_SHORTCUT(x) ((x)->flags & ROUTER_LSA_SHORTCUT)
0c9491b3 145#define IS_ROUTER_LSA_NT(x) ((x)->flags & ROUTER_LSA_NT)
718e3744 146
147/* OSPF Router-LSA Link information. */
d62a17ae 148struct router_lsa_link {
149 struct in_addr link_id;
150 struct in_addr link_data;
151 struct {
d7c0a89a
QY
152 uint8_t type;
153 uint8_t tos_count;
154 uint16_t metric;
d62a17ae 155 } m[1];
718e3744 156};
157
158/* OSPF Router-LSAs structure. */
a25a44db
DO
159#define OSPF_ROUTER_LSA_MIN_SIZE 4U /* w/0 link descriptors */
160/* There is an edge case, when number of links in a Router-LSA may be 0 without
161 breaking the specification. A router, which has no other links to backbone
162 area besides one virtual link, will not put any VL descriptor blocks into
163 the Router-LSA generated for area 0 until a full adjacency over the VL is
164 reached (RFC2328 12.4.1.3). In this case the Router-LSA initially received
165 by the other end of the VL will have 0 link descriptor blocks, but soon will
166 be replaced with the next revision having 1 descriptor block. */
d62a17ae 167struct router_lsa {
168 struct lsa_header header;
d7c0a89a
QY
169 uint8_t flags;
170 uint8_t zero;
171 uint16_t links;
8db278b5 172 struct router_link {
d62a17ae 173 struct in_addr link_id;
174 struct in_addr link_data;
d7c0a89a
QY
175 uint8_t type;
176 uint8_t tos;
177 uint16_t metric;
d62a17ae 178 } link[1];
718e3744 179};
180
181/* OSPF Network-LSAs structure. */
4e31de79 182#define OSPF_NETWORK_LSA_MIN_SIZE 8U /* w/1 router-ID */
d62a17ae 183struct network_lsa {
184 struct lsa_header header;
185 struct in_addr mask;
186 struct in_addr routers[1];
718e3744 187};
188
189/* OSPF Summary-LSAs structure. */
4e31de79 190#define OSPF_SUMMARY_LSA_MIN_SIZE 8U /* w/1 TOS metric block */
d62a17ae 191struct summary_lsa {
192 struct lsa_header header;
193 struct in_addr mask;
d7c0a89a
QY
194 uint8_t tos;
195 uint8_t metric[3];
718e3744 196};
197
198/* OSPF AS-external-LSAs structure. */
4e31de79 199#define OSPF_AS_EXTERNAL_LSA_MIN_SIZE 16U /* w/1 TOS forwarding block */
d62a17ae 200struct as_external_lsa {
201 struct lsa_header header;
202 struct in_addr mask;
8db278b5 203 struct as_route {
d7c0a89a
QY
204 uint8_t tos;
205 uint8_t metric[3];
d62a17ae 206 struct in_addr fwd_addr;
d7c0a89a 207 uint32_t route_tag;
d62a17ae 208 } e[1];
718e3744 209};
210
718e3744 211#include "ospfd/ospf_opaque.h"
718e3744 212
213/* Macros. */
214#define GET_METRIC(x) get_metric(x)
215#define IS_EXTERNAL_METRIC(x) ((x) & 0x80)
216
217#define GET_AGE(x) (ntohs ((x)->data->ls_age) + time (NULL) - (x)->tv_recv)
d62a17ae 218#define LS_AGE(x) (OSPF_LSA_MAXAGE < get_age(x) ? OSPF_LSA_MAXAGE : get_age(x))
718e3744 219#define IS_LSA_SELF(L) (CHECK_FLAG ((L)->flags, OSPF_LSA_SELF))
220#define IS_LSA_MAXAGE(L) (LS_AGE ((L)) == OSPF_LSA_MAXAGE)
44d1115a
MR
221#define IS_LSA_MAX_SEQ(L) \
222 ((L)->data->ls_seqnum == htonl(OSPF_MAX_SEQUENCE_NUMBER))
718e3744 223
718e3744 224#define OSPF_LSA_UPDATE_DELAY 2
225
d62a17ae 226#define OSPF_LSA_UPDATE_TIMER_ON(T, F) \
227 if (!(T)) \
228 (T) = thread_add_timer(master, (F), 0, 2)
718e3744 229
df074ec3 230#define CHECK_LSA_TYPE_1_TO_5_OR_7(type) \
231 ((type == OSPF_ROUTER_LSA) || (type == OSPF_NETWORK_LSA) \
232 || (type == OSPF_SUMMARY_LSA) || (type == OSPF_ASBR_SUMMARY_LSA) \
233 || (type == OSPF_AS_EXTERNAL_LSA) || (type == OSPF_AS_NSSA_LSA))
234
718e3744 235/* Prototypes. */
4dadc291 236/* XXX: Eek, time functions, similar are in lib/thread.c */
d62a17ae 237extern struct timeval int2tv(int);
238extern struct timeval msec2tv(int);
4dadc291 239
d62a17ae 240extern int get_age(struct ospf_lsa *);
d7c0a89a 241extern uint16_t ospf_lsa_checksum(struct lsa_header *);
d62a17ae 242extern int ospf_lsa_checksum_valid(struct lsa_header *);
243extern int ospf_lsa_refresh_delay(struct ospf_lsa *);
4dadc291 244
d62a17ae 245extern const char *dump_lsa_key(struct ospf_lsa *);
d7c0a89a
QY
246extern uint32_t lsa_seqnum_increment(struct ospf_lsa *);
247extern void lsa_header_set(struct stream *, uint8_t, uint8_t, struct in_addr,
d62a17ae 248 struct in_addr);
249extern struct ospf_neighbor *ospf_nbr_lookup_ptop(struct ospf_interface *);
250extern int ospf_check_nbr_status(struct ospf *);
718e3744 251
252/* Prototype for LSA primitive. */
d62a17ae 253extern struct ospf_lsa *ospf_lsa_new(void);
5b3d4186 254extern struct ospf_lsa *ospf_lsa_new_and_data(size_t size);
d62a17ae 255extern struct ospf_lsa *ospf_lsa_dup(struct ospf_lsa *);
256extern void ospf_lsa_free(struct ospf_lsa *);
257extern struct ospf_lsa *ospf_lsa_lock(struct ospf_lsa *);
258extern void ospf_lsa_unlock(struct ospf_lsa **);
259extern void ospf_lsa_discard(struct ospf_lsa *);
260extern int ospf_lsa_flush_schedule(struct ospf *, struct ospf_lsa *);
261extern struct lsa_header *ospf_lsa_data_new(size_t);
262extern struct lsa_header *ospf_lsa_data_dup(struct lsa_header *);
263extern void ospf_lsa_data_free(struct lsa_header *);
718e3744 264
265/* Prototype for various LSAs */
7fd0729f
G
266extern void ospf_router_lsa_body_set(struct stream **s, struct ospf_area *area);
267extern uint8_t router_lsa_flags(struct ospf_area *area);
d62a17ae 268extern int ospf_router_lsa_update(struct ospf *);
269extern int ospf_router_lsa_update_area(struct ospf_area *);
270
271extern void ospf_network_lsa_update(struct ospf_interface *);
272
273extern struct ospf_lsa *
d7c0a89a 274ospf_summary_lsa_originate(struct prefix_ipv4 *, uint32_t, struct ospf_area *);
d62a17ae 275extern struct ospf_lsa *ospf_summary_asbr_lsa_originate(struct prefix_ipv4 *,
d7c0a89a 276 uint32_t,
d62a17ae 277 struct ospf_area *);
278
279extern struct ospf_lsa *ospf_lsa_install(struct ospf *, struct ospf_interface *,
280 struct ospf_lsa *);
281
282extern void ospf_nssa_lsa_flush(struct ospf *ospf, struct prefix_ipv4 *p);
d7c0a89a
QY
283extern void ospf_external_lsa_flush(struct ospf *, uint8_t,
284 struct prefix_ipv4 *,
d62a17ae 285 ifindex_t /* , struct in_addr nexthop */);
286
287extern struct in_addr ospf_get_ip_from_ifp(struct ospf_interface *);
288
289extern struct ospf_lsa *ospf_external_lsa_originate(struct ospf *,
290 struct external_info *);
fa3c7c7e 291extern void ospf_external_lsa_rid_change(struct ospf *ospf);
b5a8894d 292extern struct ospf_lsa *ospf_lsa_lookup(struct ospf *ospf, struct ospf_area *,
d7c0a89a 293 uint32_t, struct in_addr,
b5a8894d 294 struct in_addr);
d7c0a89a 295extern struct ospf_lsa *ospf_lsa_lookup_by_id(struct ospf_area *, uint32_t,
d62a17ae 296 struct in_addr);
297extern struct ospf_lsa *ospf_lsa_lookup_by_header(struct ospf_area *,
298 struct lsa_header *);
299extern int ospf_lsa_more_recent(struct ospf_lsa *, struct ospf_lsa *);
300extern int ospf_lsa_different(struct ospf_lsa *, struct ospf_lsa *);
301extern void ospf_flush_self_originated_lsas_now(struct ospf *);
302
303extern int ospf_lsa_is_self_originated(struct ospf *, struct ospf_lsa *);
304
d7c0a89a 305extern struct ospf_lsa *ospf_lsa_lookup_by_prefix(struct ospf_lsdb *, uint8_t,
d62a17ae 306 struct prefix_ipv4 *,
307 struct in_addr);
308
309extern void ospf_lsa_maxage(struct ospf *, struct ospf_lsa *);
d7c0a89a 310extern uint32_t get_metric(uint8_t *);
d62a17ae 311
312extern int ospf_lsa_maxage_walker(struct thread *);
313extern struct ospf_lsa *ospf_lsa_refresh(struct ospf *, struct ospf_lsa *);
314
315extern void ospf_external_lsa_refresh_default(struct ospf *);
316
d7c0a89a
QY
317extern void ospf_external_lsa_refresh_type(struct ospf *, uint8_t,
318 unsigned short, int);
d62a17ae 319extern struct ospf_lsa *ospf_external_lsa_refresh(struct ospf *,
320 struct ospf_lsa *,
63f0e941 321 struct external_info *, int,
322 bool aggr);
d62a17ae 323extern struct in_addr ospf_lsa_unique_id(struct ospf *, struct ospf_lsdb *,
d7c0a89a 324 uint8_t, struct prefix_ipv4 *);
d62a17ae 325extern void ospf_schedule_lsa_flood_area(struct ospf_area *, struct ospf_lsa *);
326extern void ospf_schedule_lsa_flush_area(struct ospf_area *, struct ospf_lsa *);
327
328extern void ospf_refresher_register_lsa(struct ospf *, struct ospf_lsa *);
329extern void ospf_refresher_unregister_lsa(struct ospf *, struct ospf_lsa *);
330extern int ospf_lsa_refresh_walker(struct thread *);
331
332extern void ospf_lsa_maxage_delete(struct ospf *, struct ospf_lsa *);
333
334extern void ospf_discard_from_db(struct ospf *, struct ospf_lsdb *,
335 struct ospf_lsa *);
d62a17ae 336
d7c0a89a
QY
337extern int metric_type(struct ospf *, uint8_t, unsigned short);
338extern int metric_value(struct ospf *, uint8_t, unsigned short);
d62a17ae 339
7fd0729f
G
340extern char link_info_set(struct stream **s, struct in_addr id,
341 struct in_addr data, uint8_t type, uint8_t tos,
342 uint16_t cost);
343
d62a17ae 344extern struct in_addr ospf_get_nssa_ip(struct ospf_area *);
345extern int ospf_translated_nssa_compare(struct ospf_lsa *, struct ospf_lsa *);
c317eddb 346extern struct ospf_lsa *ospf_translated_nssa_refresh(struct ospf *ospf,
347 struct ospf_lsa *type7,
348 struct ospf_lsa *type5);
349extern struct ospf_lsa *ospf_translated_nssa_originate(struct ospf *ospf,
350 struct ospf_lsa *type7,
351 struct ospf_lsa *type5);
3cb62bb3
MR
352extern void ospf_check_and_gen_init_seq_lsa(struct ospf_interface *oi,
353 struct ospf_lsa *lsa);
44445dee
S
354extern void ospf_flush_lsa_from_area(struct ospf *ospf, struct in_addr area_id,
355 int type);
718e3744 356#endif /* _ZEBRA_OSPF_LSA_H */