]> git.proxmox.com Git - mirror_frr.git/blame - bgpd/bgp_route.h
doc: update workflow.rst
[mirror_frr.git] / bgpd / bgp_route.h
CommitLineData
718e3744 1/* BGP routing information base
896014f4
DL
2 * Copyright (C) 1996, 97, 98, 2000 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 */
718e3744 20
00d252cb 21#ifndef _QUAGGA_BGP_ROUTE_H
22#define _QUAGGA_BGP_ROUTE_H
23
fb018d25 24#include "queue.h"
74489921 25#include "nexthop.h"
200df115 26#include "bgp_table.h"
27
fb018d25 28struct bgp_nexthop_cache;
7ef5a232 29struct bgp_route_evpn;
fb018d25 30
d62a17ae 31enum bgp_show_type {
32 bgp_show_type_normal,
33 bgp_show_type_regexp,
34 bgp_show_type_prefix_list,
35 bgp_show_type_filter_list,
36 bgp_show_type_route_map,
37 bgp_show_type_neighbor,
38 bgp_show_type_cidr_only,
39 bgp_show_type_prefix_longer,
40 bgp_show_type_community_all,
41 bgp_show_type_community,
42 bgp_show_type_community_exact,
43 bgp_show_type_community_list,
44 bgp_show_type_community_list_exact,
45 bgp_show_type_lcommunity_all,
46 bgp_show_type_lcommunity,
47 bgp_show_type_lcommunity_list,
48 bgp_show_type_flap_statistics,
49 bgp_show_type_flap_neighbor,
50 bgp_show_type_dampend_paths,
dba3c1d3
PG
51 bgp_show_type_damp_neighbor,
52 bgp_show_type_detail,
b2f0fa55
PG
53};
54
6392aaa6
PM
55enum bgp_show_adj_route_type {
56 bgp_show_adj_route_advertised,
57 bgp_show_adj_route_received,
58 bgp_show_adj_route_filtered,
59};
60
b2f0fa55 61
d62a17ae 62#define BGP_SHOW_SCODE_HEADER \
9df8b37c 63 "Status codes: s suppressed, d damped, " \
d62a17ae 64 "h history, * valid, > best, = multipath,\n" \
9df8b37c
PZ
65 " i internal, r RIB-failure, S Stale, R Removed\n"
66#define BGP_SHOW_OCODE_HEADER "Origin codes: i - IGP, e - EGP, ? - incomplete\n\n"
67#define BGP_SHOW_NCODE_HEADER "Nexthop codes: @NNN nexthop's vrf id, < announce-nh-self\n"
181039f3 68#define BGP_SHOW_HEADER " Network Next Hop Metric LocPrf Weight Path\n"
3f9c7369 69
b57ba6d2
MK
70/* Maximum number of labels we can process or send with a prefix. We
71 * really do only 1 for MPLS (BGP-LU) but we can do 2 for EVPN-VxLAN.
72 */
73#define BGP_MAX_LABELS 2
74
d62a17ae 75/* Ancillary information to struct bgp_info,
fb982c25
PJ
76 * used for uncommonly used data (aggregation, MPLS, etc.)
77 * and lazily allocated to save memory.
78 */
d62a17ae 79struct bgp_info_extra {
80 /* Pointer to dampening structure. */
81 struct bgp_damp_info *damp_info;
fb982c25 82
d62a17ae 83 /* This route is suppressed with aggregation. */
84 int suppress;
fb982c25 85
d62a17ae 86 /* Nexthop reachability check. */
d7c0a89a 87 uint32_t igpmetric;
fb982c25 88
b57ba6d2
MK
89 /* MPLS label(s) - VNI(s) for EVPN-VxLAN */
90 mpls_label_t label[BGP_MAX_LABELS];
d7c0a89a 91 uint32_t num_labels;
342dd0c6 92
65efcfce 93#if ENABLE_BGP_VNC
d62a17ae 94 union {
95
96 struct {
97 void *rfapi_handle; /* export: NVE advertising this
98 route */
99 struct list *local_nexthops; /* optional, for static
100 routes */
101 } export;
102
103 struct {
104 struct thread *timer;
105 void *hme; /* encap monitor, if this is a VPN route */
106 struct prefix_rd
107 rd; /* import: route's route-distinguisher */
d7c0a89a 108 uint8_t un_family; /* family of cached un address, 0 if
d62a17ae 109 unset */
110 union {
111 struct in_addr addr4;
112 struct in6_addr addr6;
113 } un; /* cached un address */
114 time_t create_time;
996c9314
LB
115 struct prefix aux_prefix; /* AFI_L2VPN: the IP addr,
116 if family set */
d62a17ae 117 } import;
118
119 } vnc;
65efcfce 120#endif
128ea8ab 121
d62a17ae 122 /* For imported routes into a VNI (or VRF), this points to the parent.
123 */
124 void *parent;
ddb5b488
PZ
125
126 /*
127 * Some tunnelish parameters follow. Maybe consolidate into an
128 * internal tunnel structure?
129 */
130
131 /*
132 * Original bgp instance for imported routes. Needed for:
133 * 1. Find all routes from a specific vrf for deletion
134 * 2. vrf context of original nexthop
135 *
136 * Store pointer to bgp instance rather than bgp->vrf_id because
137 * bgp->vrf_id is not always valid (or may change?).
138 *
139 * Set to NULL if route is not imported from another bgp instance.
140 */
141 struct bgp *bgp_orig;
142
143 /*
144 * Nexthop in context of original bgp instance. Needed
145 * for label resolution of core mpls routes exported to a vrf.
146 * Set nexthop_orig.family to 0 if not valid.
147 */
148 struct prefix nexthop_orig;
b588b642
PG
149 /* presence of FS pbr entry */
150 void *bgp_fs_pbr;
fb982c25
PJ
151};
152
d62a17ae 153struct bgp_info {
154 /* For linked list. */
155 struct bgp_info *next;
156 struct bgp_info *prev;
157
158 /* For nexthop linked list */
159 LIST_ENTRY(bgp_info) nh_thread;
160
161 /* Back pointer to the prefix node */
162 struct bgp_node *net;
163
164 /* Back pointer to the nexthop structure */
165 struct bgp_nexthop_cache *nexthop;
fb018d25 166
d62a17ae 167 /* Peer structure. */
168 struct peer *peer;
fb018d25 169
d62a17ae 170 /* Attribute structure. */
171 struct attr *attr;
fb018d25 172
d62a17ae 173 /* Extra information */
174 struct bgp_info_extra *extra;
fb018d25 175
cbdfbaa5 176
d62a17ae 177 /* Multipath information */
178 struct bgp_info_mpath *mpath;
de8d5dff 179
d62a17ae 180 /* Uptime. */
181 time_t uptime;
de8d5dff 182
d62a17ae 183 /* reference count */
184 int lock;
cbdfbaa5 185
d62a17ae 186 /* BGP information status. */
d7c0a89a 187 uint16_t flags;
718e3744 188#define BGP_INFO_IGP_CHANGED (1 << 0)
189#define BGP_INFO_DAMPED (1 << 1)
190#define BGP_INFO_HISTORY (1 << 2)
191#define BGP_INFO_SELECTED (1 << 3)
192#define BGP_INFO_VALID (1 << 4)
193#define BGP_INFO_ATTR_CHANGED (1 << 5)
194#define BGP_INFO_DMED_CHECK (1 << 6)
195#define BGP_INFO_DMED_SELECTED (1 << 7)
93406d87 196#define BGP_INFO_STALE (1 << 8)
b40d939b 197#define BGP_INFO_REMOVED (1 << 9)
902212c3 198#define BGP_INFO_COUNTED (1 << 10)
de8d5dff
JB
199#define BGP_INFO_MULTIPATH (1 << 11)
200#define BGP_INFO_MULTIPATH_CHG (1 << 12)
cd1964ff 201#define BGP_INFO_RIB_ATTR_CHG (1 << 13)
960035b2 202#define BGP_INFO_ANNC_NH_SELF (1 << 14)
718e3744 203
d62a17ae 204 /* BGP route type. This can be static, RIP, OSPF, BGP etc. */
d7c0a89a 205 uint8_t type;
cbdfbaa5 206
d62a17ae 207 /* When above type is BGP. This sub type specify BGP sub type
208 information. */
d7c0a89a 209 uint8_t sub_type;
cbdfbaa5
PJ
210#define BGP_ROUTE_NORMAL 0
211#define BGP_ROUTE_STATIC 1
212#define BGP_ROUTE_AGGREGATE 2
213#define BGP_ROUTE_REDISTRIBUTE 3
65efcfce
LB
214#ifdef ENABLE_BGP_VNC
215# define BGP_ROUTE_RFP 4
216#endif
ddb5b488 217#define BGP_ROUTE_IMPORTED 5 /* from another bgp instance/safi */
7c8ff89e 218
d7c0a89a 219 unsigned short instance;
a82478b9 220
d62a17ae 221 /* Addpath identifiers */
d7c0a89a
QY
222 uint32_t addpath_rx_id;
223 uint32_t addpath_tx_id;
718e3744 224};
225
128ea8ab 226/* Structure used in BGP path selection */
d62a17ae 227struct bgp_info_pair {
228 struct bgp_info *old;
229 struct bgp_info *new;
128ea8ab 230};
231
718e3744 232/* BGP static route configuration. */
d62a17ae 233struct bgp_static {
234 /* Backdoor configuration. */
235 int backdoor;
718e3744 236
d62a17ae 237 /* Label index configuration; applies to LU prefixes. */
d7c0a89a 238 uint32_t label_index;
1b6d5c7e
VV
239#define BGP_INVALID_LABEL_INDEX 0xFFFFFFFF
240
d62a17ae 241 /* Import check status. */
d7c0a89a 242 uint8_t valid;
718e3744 243
d62a17ae 244 /* IGP metric. */
d7c0a89a 245 uint32_t igpmetric;
718e3744 246
d62a17ae 247 /* IGP nexthop. */
248 struct in_addr igpnexthop;
718e3744 249
d62a17ae 250 /* Atomic set reference count (ie cause of pathlimit) */
d7c0a89a 251 uint32_t atomic;
718e3744 252
d62a17ae 253 /* BGP redistribute route-map. */
254 struct {
255 char *name;
256 struct route_map *map;
257 } rmap;
137446f9 258
d62a17ae 259 /* Route Distinguisher */
260 struct prefix_rd prd;
684a7227 261
d62a17ae 262 /* MPLS label. */
263 mpls_label_t label;
264
265 /* EVPN */
266 struct eth_segment_id *eth_s_id;
267 struct ethaddr *router_mac;
268 uint16_t encap_tunneltype;
269 struct prefix gatewayIp;
718e3744 270};
271
d62a17ae 272#define BGP_NEXTHOP_AFI_FROM_NHLEN(nhlen) \
273 ((nhlen) < IPV4_MAX_BYTELEN \
274 ? 0 \
275 : ((nhlen) < IPV6_MAX_BYTELEN ? AFI_IP : AFI_IP6))
fe3ca08f 276
d62a17ae 277#define BGP_ATTR_NEXTHOP_AFI_IP6(attr) \
278 (!CHECK_FLAG(attr->flag, ATTR_FLAG_BIT(BGP_ATTR_NEXT_HOP)) \
279 && ((attr)->mp_nexthop_len == 16 || (attr)->mp_nexthop_len == 32))
280#define BGP_INFO_COUNTABLE(BI) \
281 (!CHECK_FLAG((BI)->flags, BGP_INFO_HISTORY) \
282 && !CHECK_FLAG((BI)->flags, BGP_INFO_REMOVED))
80e0ad24 283
1a392d46 284/* Flags which indicate a route is unuseable in some form */
d62a17ae 285#define BGP_INFO_UNUSEABLE \
286 (BGP_INFO_HISTORY | BGP_INFO_DAMPED | BGP_INFO_REMOVED)
1a392d46
PJ
287/* Macro to check BGP information is alive or not. Sadly,
288 * not equivalent to just checking previous, because of the
289 * sense of the additional VALID flag.
290 */
d62a17ae 291#define BGP_INFO_HOLDDOWN(BI) \
292 (!CHECK_FLAG((BI)->flags, BGP_INFO_VALID) \
293 || CHECK_FLAG((BI)->flags, BGP_INFO_UNUSEABLE))
1a392d46 294
718e3744 295#define DISTRIBUTE_IN_NAME(F) ((F)->dlist[FILTER_IN].name)
296#define DISTRIBUTE_IN(F) ((F)->dlist[FILTER_IN].alist)
297#define DISTRIBUTE_OUT_NAME(F) ((F)->dlist[FILTER_OUT].name)
298#define DISTRIBUTE_OUT(F) ((F)->dlist[FILTER_OUT].alist)
299
300#define PREFIX_LIST_IN_NAME(F) ((F)->plist[FILTER_IN].name)
301#define PREFIX_LIST_IN(F) ((F)->plist[FILTER_IN].plist)
302#define PREFIX_LIST_OUT_NAME(F) ((F)->plist[FILTER_OUT].name)
303#define PREFIX_LIST_OUT(F) ((F)->plist[FILTER_OUT].plist)
304
305#define FILTER_LIST_IN_NAME(F) ((F)->aslist[FILTER_IN].name)
306#define FILTER_LIST_IN(F) ((F)->aslist[FILTER_IN].aslist)
307#define FILTER_LIST_OUT_NAME(F) ((F)->aslist[FILTER_OUT].name)
308#define FILTER_LIST_OUT(F) ((F)->aslist[FILTER_OUT].aslist)
309
fee0f4c6 310#define ROUTE_MAP_IN_NAME(F) ((F)->map[RMAP_IN].name)
311#define ROUTE_MAP_IN(F) ((F)->map[RMAP_IN].map)
312#define ROUTE_MAP_OUT_NAME(F) ((F)->map[RMAP_OUT].name)
313#define ROUTE_MAP_OUT(F) ((F)->map[RMAP_OUT].map)
314
718e3744 315#define UNSUPPRESS_MAP_NAME(F) ((F)->usmap.name)
316#define UNSUPPRESS_MAP(F) ((F)->usmap.map)
317
2ec1e66f
DW
318/* path PREFIX (addpath rxid NUMBER) */
319#define PATH_ADDPATH_STR_BUFFER PREFIX2STR_BUFFER + 32
320
d62a17ae 321enum bgp_path_type { BGP_PATH_ALL, BGP_PATH_BESTPATH, BGP_PATH_MULTIPATH };
4092b06c 322
d62a17ae 323static inline void bgp_bump_version(struct bgp_node *node)
3f9c7369 324{
d62a17ae 325 node->version = bgp_table_next_version(bgp_node_table(node));
3f9c7369
DS
326}
327
d62a17ae 328static inline int bgp_fibupd_safi(safi_t safi)
cd1964ff 329{
d62a17ae 330 if (safi == SAFI_UNICAST || safi == SAFI_MULTICAST
529efa23
PG
331 || safi == SAFI_LABELED_UNICAST
332 || safi == SAFI_FLOWSPEC)
d62a17ae 333 return 1;
334 return 0;
cd1964ff
DS
335}
336
718e3744 337/* Prototypes. */
db0e1937
MK
338extern void bgp_rib_remove(struct bgp_node *rn, struct bgp_info *ri,
339 struct peer *peer, afi_t afi, safi_t safi);
d62a17ae 340extern void bgp_process_queue_init(void);
341extern void bgp_route_init(void);
342extern void bgp_route_finish(void);
343extern void bgp_cleanup_routes(struct bgp *);
344extern void bgp_announce_route(struct peer *, afi_t, safi_t);
3f9c7369 345extern void bgp_stop_announce_route_timer(struct peer_af *paf);
d62a17ae 346extern void bgp_announce_route_all(struct peer *);
347extern void bgp_default_originate(struct peer *, afi_t, safi_t, int);
348extern void bgp_soft_reconfig_in(struct peer *, afi_t, safi_t);
349extern void bgp_clear_route(struct peer *, afi_t, safi_t);
350extern void bgp_clear_route_all(struct peer *);
351extern void bgp_clear_adj_in(struct peer *, afi_t, safi_t);
352extern void bgp_clear_stale_route(struct peer *, afi_t, safi_t);
353
354extern struct bgp_node *bgp_afi_node_get(struct bgp_table *table, afi_t afi,
355 safi_t safi, struct prefix *p,
356 struct prefix_rd *prd);
357extern struct bgp_info *bgp_info_lock(struct bgp_info *);
358extern struct bgp_info *bgp_info_unlock(struct bgp_info *);
359extern void bgp_info_add(struct bgp_node *rn, struct bgp_info *ri);
360extern void bgp_info_reap(struct bgp_node *rn, struct bgp_info *ri);
361extern void bgp_info_delete(struct bgp_node *rn, struct bgp_info *ri);
362extern struct bgp_info_extra *bgp_info_extra_get(struct bgp_info *);
d7c0a89a
QY
363extern void bgp_info_set_flag(struct bgp_node *, struct bgp_info *, uint32_t);
364extern void bgp_info_unset_flag(struct bgp_node *, struct bgp_info *, uint32_t);
d62a17ae 365extern void bgp_info_path_with_addpath_rx_str(struct bgp_info *ri, char *buf);
366
367extern int bgp_nlri_parse_ip(struct peer *, struct attr *, struct bgp_nlri *);
368
369extern int bgp_maximum_prefix_overflow(struct peer *, afi_t, safi_t, int);
370
9de1f7ff
DS
371extern void bgp_redistribute_add(struct bgp *bgp, struct prefix *p,
372 const union g_addr *nexthop, ifindex_t ifindex,
373 enum nexthop_types_t nhtype, uint32_t metric,
d7c0a89a 374 uint8_t type, unsigned short instance,
9de1f7ff 375 route_tag_t tag);
d7c0a89a
QY
376extern void bgp_redistribute_delete(struct bgp *, struct prefix *, uint8_t,
377 unsigned short);
378extern void bgp_redistribute_withdraw(struct bgp *, afi_t, int, unsigned short);
d62a17ae 379
380extern void bgp_static_add(struct bgp *);
381extern void bgp_static_delete(struct bgp *);
382extern void bgp_static_redo_import_check(struct bgp *);
383extern void bgp_purge_static_redist_routes(struct bgp *bgp);
384extern void bgp_static_update(struct bgp *, struct prefix *,
385 struct bgp_static *, afi_t, safi_t);
386extern void bgp_static_withdraw(struct bgp *, struct prefix *, afi_t, safi_t);
387
388extern int bgp_static_set_safi(afi_t afi, safi_t safi, struct vty *vty,
389 const char *, const char *, const char *,
390 const char *, int, const char *, const char *,
391 const char *, const char *);
392
393extern int bgp_static_unset_safi(afi_t afi, safi_t safi, struct vty *,
394 const char *, const char *, const char *, int,
395 const char *, const char *, const char *);
718e3744 396
94f2b392 397/* this is primarily for MPLS-VPN */
d7c0a89a 398extern int bgp_update(struct peer *, struct prefix *, uint32_t, struct attr *,
d62a17ae 399 afi_t, safi_t, int, int, struct prefix_rd *,
d7c0a89a
QY
400 mpls_label_t *, uint32_t, int, struct bgp_route_evpn *);
401extern int bgp_withdraw(struct peer *, struct prefix *, uint32_t, struct attr *,
402 afi_t, safi_t, int, int, struct prefix_rd *,
403 mpls_label_t *, uint32_t, struct bgp_route_evpn *);
718e3744 404
94f2b392 405/* for bgp_nexthop and bgp_damp */
d62a17ae 406extern void bgp_process(struct bgp *, struct bgp_node *, afi_t, safi_t);
cb1faec9
DS
407
408/*
409 * Add an end-of-initial-update marker to the process queue. This is just a
410 * queue element with NULL bgp node.
411 */
d62a17ae 412extern void bgp_add_eoiu_mark(struct bgp *);
60466a63
QY
413extern void bgp_config_write_table_map(struct vty *, struct bgp *, afi_t,
414 safi_t);
2b791107 415extern void bgp_config_write_network(struct vty *, struct bgp *, afi_t, safi_t);
60466a63
QY
416extern void bgp_config_write_distance(struct vty *, struct bgp *, afi_t,
417 safi_t);
d62a17ae 418
419extern void bgp_aggregate_increment(struct bgp *, struct prefix *,
420 struct bgp_info *, afi_t, safi_t);
421extern void bgp_aggregate_decrement(struct bgp *, struct prefix *,
422 struct bgp_info *, afi_t, safi_t);
423
d7c0a89a
QY
424extern uint8_t bgp_distance_apply(struct prefix *, struct bgp_info *, afi_t,
425 safi_t, struct bgp *);
d62a17ae 426
427extern afi_t bgp_node_afi(struct vty *);
428extern safi_t bgp_node_safi(struct vty *);
429
d7c0a89a
QY
430extern struct bgp_info *info_make(int type, int sub_type,
431 unsigned short instance, struct peer *peer,
432 struct attr *attr, struct bgp_node *rn);
d62a17ae 433
434extern void route_vty_out(struct vty *, struct prefix *, struct bgp_info *, int,
435 safi_t, json_object *);
436extern void route_vty_out_tag(struct vty *, struct prefix *, struct bgp_info *,
437 int, safi_t, json_object *);
438extern void route_vty_out_tmp(struct vty *, struct prefix *, struct attr *,
d7c0a89a 439 safi_t, uint8_t, json_object *);
d62a17ae 440extern void route_vty_out_overlay(struct vty *vty, struct prefix *p,
441 struct bgp_info *binfo, int display,
442 json_object *json);
443
444extern int subgroup_process_announce_selected(struct update_subgroup *subgrp,
445 struct bgp_info *selected,
446 struct bgp_node *rn,
d7c0a89a 447 uint32_t addpath_tx_id);
3f9c7369 448
cd1964ff 449extern int subgroup_announce_check(struct bgp_node *rn, struct bgp_info *ri,
3f9c7369
DS
450 struct update_subgroup *subgrp,
451 struct prefix *p, struct attr *attr);
452
d62a17ae 453extern void bgp_peer_clear_node_queue_drain_immediate(struct peer *peer);
454extern void bgp_process_queues_drain_immediate(void);
bb86c601 455
65efcfce 456/* for encap/vpn */
d62a17ae 457extern struct bgp_node *bgp_afi_node_lookup(struct bgp_table *table, afi_t afi,
458 safi_t safi, struct prefix *p,
459 struct prefix_rd *prd);
460extern struct bgp_info *bgp_info_new(void);
461extern void bgp_info_restore(struct bgp_node *, struct bgp_info *);
462
463extern int bgp_info_cmp_compatible(struct bgp *, struct bgp_info *,
464 struct bgp_info *, char *pfx_buf, afi_t afi,
465 safi_t safi);
7f323236 466extern void bgp_attr_add_gshut_community(struct attr *attr);
d62a17ae 467
468extern void bgp_best_selection(struct bgp *bgp, struct bgp_node *rn,
469 struct bgp_maxpaths_cfg *mpath_cfg,
470 struct bgp_info_pair *result, afi_t afi,
471 safi_t safi);
472extern void bgp_zebra_clear_route_change_flags(struct bgp_node *rn);
473extern int bgp_zebra_has_route_changed(struct bgp_node *rn,
474 struct bgp_info *selected);
475
476extern void route_vty_out_detail_header(struct vty *vty, struct bgp *bgp,
477 struct bgp_node *rn,
478 struct prefix_rd *prd, afi_t afi,
479 safi_t safi, json_object *json);
480extern void route_vty_out_detail(struct vty *vty, struct bgp *bgp,
481 struct prefix *p, struct bgp_info *binfo,
482 afi_t afi, safi_t safi,
483 json_object *json_paths);
1ae44dfc
LB
484extern int bgp_show_table_rd(struct vty *vty, struct bgp *bgp, safi_t safi,
485 struct bgp_table *table, struct prefix_rd *prd,
486 enum bgp_show_type type, void *output_arg,
d7c0a89a 487 uint8_t use_json);
00d252cb 488#endif /* _QUAGGA_BGP_ROUTE_H */