mirror of
https://git.proxmox.com/git/mirror_frr
synced 2025-04-29 16:17:38 +00:00
1051417011
RFC 3623 specifies the Graceful Restart enhancement to the OSPF routing protocol. This PR implements support for the restarting mode, whereas the helper mode was implemented by #6811. This work is based on #6782, which implemented the pre-restart part and settled the foundations for the post-restart part (behavioral changes, GR exit conditions, and on-exit actions). Here's a quick summary of how the GR restarting mode works: * GR can be enabled on a per-instance basis using the `graceful-restart [grace-period (1-1800)]` command; * To perform a graceful shutdown, the `graceful-restart prepare ospf` EXEC-level command needs to be issued before restarting the ospfd daemon (there's no specific requirement on how the daemon should be restarted); * `graceful-restart prepare ospf` will initiate the graceful restart for all GR-enabled instances by taking the following actions: o Flooding Grace-LSAs over all interfaces o Freezing the OSPF routes in the RIB o Saving the end of the grace period in non-volatile memory (a JSON file stored in `$frr_statedir`) * Once ospfd is started again, it will follow the procedures described in RFC 3623 until it detects it's time to exit the graceful restart (either successfully or unsuccessfully). Testing done: * New topotest featuring a multi-area OSPF topology (including stub and NSSA areas); * Successful interop tests against IOS-XR routers acting as helpers. Co-authored-by: GalaxyGorilla <sascha@netdef.org> Signed-off-by: Renato Westphal <renato@opensourcerouting.org>
105 lines
3.8 KiB
C
105 lines
3.8 KiB
C
/*
|
|
* OSPF calculation.
|
|
* Copyright (C) 1999 Kunihiro Ishiguro
|
|
*
|
|
* This file is part of GNU Zebra.
|
|
*
|
|
* GNU Zebra is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the
|
|
* Free Software Foundation; either version 2, or (at your option) any
|
|
* later version.
|
|
*
|
|
* GNU Zebra is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; see the file COPYING; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef _QUAGGA_OSPF_SPF_H
|
|
#define _QUAGGA_OSPF_SPF_H
|
|
|
|
#include "typesafe.h"
|
|
|
|
/* values for vertex->type */
|
|
#define OSPF_VERTEX_ROUTER 1 /* for a Router-LSA */
|
|
#define OSPF_VERTEX_NETWORK 2 /* for a Network-LSA */
|
|
|
|
/* values for vertex->flags */
|
|
#define OSPF_VERTEX_PROCESSED 0x01
|
|
|
|
/* The "root" is the node running the SPF calculation */
|
|
|
|
PREDECL_SKIPLIST_NONUNIQ(vertex_pqueue);
|
|
/* A router or network in an area */
|
|
struct vertex {
|
|
struct vertex_pqueue_item pqi;
|
|
uint8_t flags;
|
|
uint8_t type; /* copied from LSA header */
|
|
struct in_addr id; /* copied from LSA header */
|
|
struct ospf_lsa *lsa_p;
|
|
struct lsa_header *lsa; /* Router or Network LSA */
|
|
uint32_t distance; /* from root to this vertex */
|
|
struct list *parents; /* list of parents in SPF tree */
|
|
struct list *children; /* list of children in SPF tree*/
|
|
};
|
|
|
|
struct vertex_nexthop {
|
|
struct in_addr router; /* router address to send to */
|
|
int lsa_pos; /* LSA position for resolving the interface */
|
|
};
|
|
|
|
struct vertex_parent {
|
|
struct vertex_nexthop *nexthop; /* nexthop taken on the root node */
|
|
struct vertex_nexthop *local_nexthop; /* local nexthop of the parent */
|
|
struct vertex *parent; /* parent vertex */
|
|
int backlink; /* index back to parent for router-lsa's */
|
|
};
|
|
|
|
/* What triggered the SPF ? */
|
|
typedef enum {
|
|
SPF_FLAG_ROUTER_LSA_INSTALL = 1,
|
|
SPF_FLAG_NETWORK_LSA_INSTALL,
|
|
SPF_FLAG_SUMMARY_LSA_INSTALL,
|
|
SPF_FLAG_ASBR_SUMMARY_LSA_INSTALL,
|
|
SPF_FLAG_MAXAGE,
|
|
SPF_FLAG_ABR_STATUS_CHANGE,
|
|
SPF_FLAG_ASBR_STATUS_CHANGE,
|
|
SPF_FLAG_CONFIG_CHANGE,
|
|
SPF_FLAG_GR_FINISH,
|
|
} ospf_spf_reason_t;
|
|
|
|
extern void ospf_spf_calculate_schedule(struct ospf *, ospf_spf_reason_t);
|
|
extern void ospf_spf_calculate(struct ospf_area *area,
|
|
struct ospf_lsa *root_lsa,
|
|
struct route_table *new_table,
|
|
struct route_table *new_rtrs, bool is_dry_run,
|
|
bool is_root_node);
|
|
extern void ospf_spf_calculate_area(struct ospf *ospf, struct ospf_area *area,
|
|
struct route_table *new_table,
|
|
struct route_table *new_rtrs);
|
|
extern void ospf_spf_calculate_areas(struct ospf *ospf,
|
|
struct route_table *new_table,
|
|
struct route_table *new_rtrs);
|
|
extern void ospf_rtrs_free(struct route_table *);
|
|
extern void ospf_spf_cleanup(struct vertex *spf, struct list *vertex_list);
|
|
extern void ospf_spf_copy(struct vertex *vertex, struct list *vertex_list);
|
|
extern void ospf_spf_remove_resource(struct vertex *vertex,
|
|
struct list *vertex_list,
|
|
struct protected_resource *resource);
|
|
extern struct vertex *ospf_spf_vertex_find(struct in_addr id,
|
|
struct list *vertex_list);
|
|
extern struct vertex *ospf_spf_vertex_by_nexthop(struct vertex *root,
|
|
struct in_addr *nexthop);
|
|
extern struct vertex_parent *ospf_spf_vertex_parent_find(struct in_addr id,
|
|
struct vertex *vertex);
|
|
extern int vertex_parent_cmp(void *aa, void *bb);
|
|
|
|
extern void ospf_spf_print(struct vty *vty, struct vertex *v, int i);
|
|
extern void ospf_restart_spf(struct ospf *ospf);
|
|
/* void ospf_spf_calculate_timer_add (); */
|
|
#endif /* _QUAGGA_OSPF_SPF_H */
|