mirror of
https://git.proxmox.com/git/mirror_frr
synced 2025-11-04 06:38:04 +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>
73 lines
3.3 KiB
C
73 lines
3.3 KiB
C
/*
|
|
* OSPF Flooding -- RFC2328 Section 13.
|
|
* Copyright (C) 1999, 2000 Toshiaki Takada
|
|
*
|
|
* 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 _ZEBRA_OSPF_FLOOD_H
|
|
#define _ZEBRA_OSPF_FLOOD_H
|
|
|
|
extern int ospf_flood(struct ospf *, struct ospf_neighbor *, struct ospf_lsa *,
|
|
struct ospf_lsa *);
|
|
extern int ospf_flood_through(struct ospf *, struct ospf_neighbor *,
|
|
struct ospf_lsa *);
|
|
extern int ospf_flood_through_area(struct ospf_area *, struct ospf_neighbor *,
|
|
struct ospf_lsa *);
|
|
extern int ospf_flood_through_as(struct ospf *, struct ospf_neighbor *,
|
|
struct ospf_lsa *);
|
|
extern int ospf_flood_through_interface(struct ospf_interface *oi,
|
|
struct ospf_neighbor *inbr,
|
|
struct ospf_lsa *lsa);
|
|
|
|
extern unsigned long ospf_ls_request_count(struct ospf_neighbor *);
|
|
extern int ospf_ls_request_isempty(struct ospf_neighbor *);
|
|
extern struct ospf_lsa *ospf_ls_request_new(struct lsa_header *);
|
|
extern void ospf_ls_request_free(struct ospf_lsa *);
|
|
extern void ospf_ls_request_add(struct ospf_neighbor *, struct ospf_lsa *);
|
|
extern void ospf_ls_request_delete(struct ospf_neighbor *, struct ospf_lsa *);
|
|
extern void ospf_ls_request_delete_all(struct ospf_neighbor *);
|
|
extern struct ospf_lsa *ospf_ls_request_lookup(struct ospf_neighbor *,
|
|
struct ospf_lsa *);
|
|
|
|
extern unsigned long ospf_ls_retransmit_count(struct ospf_neighbor *);
|
|
extern unsigned long ospf_ls_retransmit_count_self(struct ospf_neighbor *, int);
|
|
extern int ospf_ls_retransmit_isempty(struct ospf_neighbor *);
|
|
extern void ospf_ls_retransmit_add(struct ospf_neighbor *, struct ospf_lsa *);
|
|
extern void ospf_ls_retransmit_delete(struct ospf_neighbor *,
|
|
struct ospf_lsa *);
|
|
extern void ospf_ls_retransmit_clear(struct ospf_neighbor *);
|
|
extern struct ospf_lsa *ospf_ls_retransmit_lookup(struct ospf_neighbor *,
|
|
struct ospf_lsa *);
|
|
extern void ospf_ls_retransmit_delete_nbr_area(struct ospf_area *,
|
|
struct ospf_lsa *);
|
|
extern void ospf_ls_retransmit_delete_nbr_as(struct ospf *, struct ospf_lsa *);
|
|
extern void ospf_ls_retransmit_add_nbr_all(struct ospf_interface *,
|
|
struct ospf_lsa *);
|
|
|
|
extern void ospf_flood_lsa_area(struct ospf_lsa *, struct ospf_area *);
|
|
extern void ospf_flood_lsa_as(struct ospf_lsa *);
|
|
extern void ospf_lsa_flush_area(struct ospf_lsa *, struct ospf_area *);
|
|
extern void ospf_lsa_flush_as(struct ospf *, struct ospf_lsa *);
|
|
extern void ospf_lsa_flush(struct ospf *, struct ospf_lsa *);
|
|
extern struct external_info *ospf_external_info_check(struct ospf *,
|
|
struct ospf_lsa *);
|
|
|
|
extern void ospf_lsdb_init(struct ospf_lsdb *);
|
|
|
|
#endif /* _ZEBRA_OSPF_FLOOD_H */
|