[mirror_frr.git] / isisd / isisd.h

/*
 * IS-IS Rout(e)ing protocol - isisd.h
 *
 * Copyright (C) 2001,2002   Sampo Saaristo
 *                           Tampere University of Technology
 *                           Institute of Communications Engineering
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public Licenseas published by the Free
 * Software Foundation; either version 2 of the License, or (at your option)
 * any later version.
 *
 * This program 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 ISISD_H
#define ISISD_H

#include "vty.h"

#include "isisd/isis_constants.h"
#include "isisd/isis_common.h"
#include "isisd/isis_redist.h"
#include "isis_flags.h"
#include "dict.h"
#include "isis_memory.h"
#include "qobj.h"

#ifdef FABRICD
static const bool fabricd = true;
#define PROTO_TYPE ZEBRA_ROUTE_OPENFABRIC
#define PROTO_NAME "openfabric"
#define PROTO_HELP "OpenFabric routing protocol\n"
#define PROTO_REDIST_STR FRR_REDIST_STR_FABRICD
#define PROTO_REDIST_HELP FRR_REDIST_HELP_STR_FABRICD
#define ROUTER_NODE OPENFABRIC_NODE
#else
static const bool fabricd = false;
#define PROTO_TYPE ZEBRA_ROUTE_ISIS
#define PROTO_NAME "isis"
#define PROTO_HELP "IS-IS routing protocol\n"
#define PROTO_REDIST_STR FRR_REDIST_STR_ISISD
#define PROTO_REDIST_HELP FRR_REDIST_HELP_STR_ISISD
#define ROUTER_NODE ISIS_NODE
#endif

extern struct zebra_privs_t isisd_privs;

/* uncomment if you are a developer in bug hunt */
/* #define EXTREME_DEBUG  */
/* #define EXTREME_DICT_DEBUG */

struct fabricd;

struct isis {
	unsigned long process_id;
	int sysid_set;
	uint8_t sysid[ISIS_SYS_ID_LEN]; /* SystemID for this IS */
	uint32_t router_id;		/* Router ID from zebra */
	struct list *area_list;	/* list of IS-IS areas */
	struct list *init_circ_list;
	struct list *nexthops;		  /* IPv4 next hops from this IS */
	struct list *nexthops6;		  /* IPv6 next hops from this IS */
	uint8_t max_area_addrs;		  /* maximumAreaAdresses */
	struct area_addr *man_area_addrs; /* manualAreaAddresses */
	uint32_t debugs;		  /* bitmap for debug */
	time_t uptime;			  /* when did we start */
	struct thread *t_dync_clean;      /* dynamic hostname cache cleanup thread */
	uint32_t circuit_ids_used[8];     /* 256 bits to track circuit ids 1 through 255 */

	struct route_table *ext_info[REDIST_PROTOCOL_COUNT];

	QOBJ_FIELDS
};

extern struct isis *isis;
DECLARE_QOBJ_TYPE(isis_area)

enum spf_tree_id {
	SPFTREE_IPV4 = 0,
	SPFTREE_IPV6,
	SPFTREE_DSTSRC,
	SPFTREE_COUNT
};

struct isis_area {
	struct isis *isis;			       /* back pointer */
	dict_t *lspdb[ISIS_LEVELS];		       /* link-state dbs */
	struct isis_spftree *spftree[SPFTREE_COUNT][ISIS_LEVELS];
#define DEFAULT_LSP_MTU 1497
	unsigned int lsp_mtu;      /* Size of LSPs to generate */
	struct list *circuit_list; /* IS-IS circuits */
	struct flags flags;
	struct thread *t_tick; /* LSP walker */
	struct thread *t_lsp_refresh[ISIS_LEVELS];
	/* t_lsp_refresh is used in two ways:
	 * a) regular refresh of LSPs
	 * b) (possibly throttled) updates to LSPs
	 *
	 * The lsp_regenerate_pending flag tracks whether the timer is active
	 * for the a) or the b) case.
	 *
	 * It is of utmost importance to clear this flag when the timer is
	 * rescheduled for normal refresh, because otherwise, updates will
	 * be delayed until the next regular refresh.
	 */
	int lsp_regenerate_pending[ISIS_LEVELS];

	struct fabricd *fabricd;

	/*
	 * Configurables
	 */
	struct isis_passwd area_passwd;
	struct isis_passwd domain_passwd;
	/* do we support dynamic hostnames?  */
	char dynhostname;
	/* do we support new style metrics?  */
	char newmetric;
	char oldmetric;
	/* identifies the routing instance   */
	char *area_tag;
	/* area addresses for this area      */
	struct list *area_addrs;
	uint16_t max_lsp_lifetime[ISIS_LEVELS];
	char is_type; /* level-1 level-1-2 or level-2-only */
	/* are we overloaded? */
	char overload_bit;
	/* L1/L2 router identifier for inter-area traffic */
	char attached_bit;
	uint16_t lsp_refresh[ISIS_LEVELS];
	/* minimum time allowed before lsp retransmission */
	uint16_t lsp_gen_interval[ISIS_LEVELS];
	/* min interval between between consequtive SPFs */
	uint16_t min_spf_interval[ISIS_LEVELS];
	/* the percentage of LSP mtu size used, before generating a new frag */
	int lsp_frag_threshold;
	int ip_circuits;
	/* logging adjacency changes? */
	uint8_t log_adj_changes;
	/* multi topology settings */
	struct list *mt_settings;
	int ipv6_circuits;
	bool purge_originator;
	/* Counters */
	uint32_t circuit_state_changes;
	struct isis_redist redist_settings[REDIST_PROTOCOL_COUNT]
					  [ZEBRA_ROUTE_MAX + 1][ISIS_LEVELS];
	struct route_table *ext_reach[REDIST_PROTOCOL_COUNT][ISIS_LEVELS];

	struct spf_backoff *spf_delay_ietf[ISIS_LEVELS]; /*Structure with IETF
							    SPF algo
							    parameters*/
	struct thread *spf_timer[ISIS_LEVELS];

	QOBJ_FIELDS
};
DECLARE_QOBJ_TYPE(isis_area)

void isis_init(void);
void isis_new(unsigned long);
struct isis_area *isis_area_create(const char *);
struct isis_area *isis_area_lookup(const char *);
int isis_area_get(struct vty *vty, const char *area_tag);
void print_debug(struct vty *, int, int);

void isis_area_invalidate_routes(struct isis_area *area, int levels);
void isis_area_verify_routes(struct isis_area *area);

void isis_area_overload_bit_set(struct isis_area *area, bool overload_bit);
void isis_area_attached_bit_set(struct isis_area *area, bool attached_bit);
void isis_area_dynhostname_set(struct isis_area *area, bool dynhostname);
void isis_area_metricstyle_set(struct isis_area *area, bool old_metric,
			       bool new_metric);
void isis_area_lsp_mtu_set(struct isis_area *area, unsigned int lsp_mtu);
void isis_area_is_type_set(struct isis_area *area, int is_type);
void isis_area_max_lsp_lifetime_set(struct isis_area *area, int level,
				    uint16_t max_lsp_lifetime);
void isis_area_lsp_refresh_set(struct isis_area *area, int level,
			       uint16_t lsp_refresh);
/* IS_LEVEL_1 sets area_passwd, IS_LEVEL_2 domain_passwd */
int isis_area_passwd_unset(struct isis_area *area, int level);
int isis_area_passwd_cleartext_set(struct isis_area *area, int level,
				   const char *passwd, uint8_t snp_auth);
int isis_area_passwd_hmac_md5_set(struct isis_area *area, int level,
				  const char *passwd, uint8_t snp_auth);

/* Master of threads. */
extern struct thread_master *master;

#define DEBUG_ADJ_PACKETS                (1<<0)
#define DEBUG_CHECKSUM_ERRORS            (1<<1)
#define DEBUG_LOCAL_UPDATES              (1<<2)
#define DEBUG_PROTOCOL_ERRORS            (1<<3)
#define DEBUG_SNP_PACKETS                (1<<4)
#define DEBUG_UPDATE_PACKETS             (1<<5)
#define DEBUG_SPF_EVENTS                 (1<<6)
#define DEBUG_SPF_STATS                  (1<<7)
#define DEBUG_SPF_TRIGGERS               (1<<8)
#define DEBUG_RTE_EVENTS                 (1<<9)
#define DEBUG_EVENTS                     (1<<10)
#define DEBUG_ZEBRA                      (1<<11)
#define DEBUG_PACKET_DUMP                (1<<12)
#define DEBUG_LSP_GEN                    (1<<13)
#define DEBUG_LSP_SCHED                  (1<<14)
#define DEBUG_FABRICD_FLOODING           (1<<15)
#define DEBUG_BFD                        (1<<16)

#define lsp_debug(...)                                                         \
	do {                                                                   \
		if (isis->debugs & DEBUG_LSP_GEN)                              \
			zlog_debug(__VA_ARGS__);                               \
	} while (0)

#define sched_debug(...)                                                       \
	do {                                                                   \
		if (isis->debugs & DEBUG_LSP_SCHED)                            \
			zlog_debug(__VA_ARGS__);                               \
	} while (0)

#define DEBUG_TE                         (1<<13)

#define IS_DEBUG_ISIS(x)                 (isis->debugs & x)

#endif /* ISISD_H */
Commit	Line	Data
eb5d44eb	1	/*
d62a17ae	2	* IS-IS Rout(e)ing protocol - isisd.h
eb5d44eb	3	*
eb5d44eb	4	* Copyright (C) 2001,2002 Sampo Saaristo
d62a17ae	5	* Tampere University of Technology
eb5d44eb	6	* Institute of Communications Engineering
eb5d44eb	7	*
d62a17ae	8	* This program is free software; you can redistribute it and/or modify it
	9	* under the terms of the GNU General Public Licenseas published by the Free
	10	* Software Foundation; either version 2 of the License, or (at your option)
eb5d44eb	11	* any later version.
eb5d44eb	12	*
d62a17ae	13	* This program is distributed in the hope that it will be useful,but WITHOUT
	14	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
	15	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
eb5d44eb	16	* more details.
896014f4 DL	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
eb5d44eb	21	*/
	22
	23	#ifndef ISISD_H
	24	#define ISISD_H
	25
91283e76 DS	26	#include "vty.h"
91283e76 DS	27
65f9a9a8 DL	28	#include "isisd/isis_constants.h"
65f9a9a8 DL	29	#include "isisd/isis_common.h"
f3ccedaa	30	#include "isisd/isis_redist.h"
65f9a9a8 DL	31	#include "isis_flags.h"
65f9a9a8 DL	32	#include "dict.h"
4a1ab8e4	33	#include "isis_memory.h"
676a4ea3	34	#include "qobj.h"
f3ccedaa	35
7c0cbd0e CF	36	#ifdef FABRICD
	37	static const bool fabricd = true;
	38	#define PROTO_TYPE ZEBRA_ROUTE_OPENFABRIC
	39	#define PROTO_NAME "openfabric"
	40	#define PROTO_HELP "OpenFabric routing protocol\n"
	41	#define PROTO_REDIST_STR FRR_REDIST_STR_FABRICD
	42	#define PROTO_REDIST_HELP FRR_REDIST_HELP_STR_FABRICD
	43	#define ROUTER_NODE OPENFABRIC_NODE
	44	#else
	45	static const bool fabricd = false;
	46	#define PROTO_TYPE ZEBRA_ROUTE_ISIS
	47	#define PROTO_NAME "isis"
	48	#define PROTO_HELP "IS-IS routing protocol\n"
	49	#define PROTO_REDIST_STR FRR_REDIST_STR_ISISD
	50	#define PROTO_REDIST_HELP FRR_REDIST_HELP_STR_ISISD
	51	#define ROUTER_NODE ISIS_NODE
	52	#endif
	53
76e292f9 DS	54	extern struct zebra_privs_t isisd_privs;
76e292f9 DS	55
eb5d44eb	56	/* uncomment if you are a developer in bug hunt */
eb5d44eb	57	/* #define EXTREME_DEBUG */
8955008f	58	/* #define EXTREME_DICT_DEBUG */
eb5d44eb	59
8e6fb83b CF	60	struct fabricd;
8e6fb83b CF	61
d62a17ae	62	struct isis {
d7c0a89a	63	unsigned long process_id;
d62a17ae	64	int sysid_set;
d7c0a89a QY	65	uint8_t sysid[ISIS_SYS_ID_LEN]; /* SystemID for this IS */
d7c0a89a QY	66	uint32_t router_id; /* Router ID from zebra */
d62a17ae	67	struct list area_list; / list of IS-IS areas */
	68	struct list *init_circ_list;
	69	struct list nexthops; / IPv4 next hops from this IS */
	70	struct list nexthops6; / IPv6 next hops from this IS */
d7c0a89a	71	uint8_t max_area_addrs; /* maximumAreaAdresses */
d62a17ae	72	struct area_addr man_area_addrs; / manualAreaAddresses */
d7c0a89a	73	uint32_t debugs; /* bitmap for debug */
d62a17ae	74	time_t uptime; /* when did we start */
98c5bc15	75	struct thread t_dync_clean; / dynamic hostname cache cleanup thread */
c59f88c8	76	uint32_t circuit_ids_used[8]; /* 256 bits to track circuit ids 1 through 255 */
d62a17ae	77
	78	struct route_table *ext_info[REDIST_PROTOCOL_COUNT];
	79
	80	QOBJ_FIELDS
eb5d44eb	81	};
eb5d44eb	82
3f045a08	83	extern struct isis *isis;
676a4ea3	84	DECLARE_QOBJ_TYPE(isis_area)
3f045a08	85
be985ba0 CF	86	enum spf_tree_id {
	87	SPFTREE_IPV4 = 0,
	88	SPFTREE_IPV6,
321c1bbb	89	SPFTREE_DSTSRC,
be985ba0 CF	90	SPFTREE_COUNT
	91	};
	92
d62a17ae	93	struct isis_area {
	94	struct isis isis; / back pointer */
	95	dict_t lspdb[ISIS_LEVELS]; / link-state dbs */
be985ba0	96	struct isis_spftree *spftree[SPFTREE_COUNT][ISIS_LEVELS];
b20ccb3a	97	#define DEFAULT_LSP_MTU 1497
d62a17ae	98	unsigned int lsp_mtu; /* Size of LSPs to generate */
	99	struct list circuit_list; / IS-IS circuits */
	100	struct flags flags;
	101	struct thread t_tick; / LSP walker */
	102	struct thread *t_lsp_refresh[ISIS_LEVELS];
	103	/* t_lsp_refresh is used in two ways:
	104	* a) regular refresh of LSPs
	105	* b) (possibly throttled) updates to LSPs
	106	*
	107	* The lsp_regenerate_pending flag tracks whether the timer is active
	108	* for the a) or the b) case.
	109	*
	110	* It is of utmost importance to clear this flag when the timer is
	111	* rescheduled for normal refresh, because otherwise, updates will
	112	* be delayed until the next regular refresh.
	113	*/
	114	int lsp_regenerate_pending[ISIS_LEVELS];
	115
8e6fb83b CF	116	struct fabricd *fabricd;
8e6fb83b CF	117
d62a17ae	118	/*
	119	* Configurables
	120	*/
	121	struct isis_passwd area_passwd;
	122	struct isis_passwd domain_passwd;
	123	/* do we support dynamic hostnames? */
	124	char dynhostname;
	125	/* do we support new style metrics? */
	126	char newmetric;
	127	char oldmetric;
	128	/* identifies the routing instance */
	129	char *area_tag;
	130	/* area addresses for this area */
	131	struct list *area_addrs;
d7c0a89a	132	uint16_t max_lsp_lifetime[ISIS_LEVELS];
d62a17ae	133	char is_type; /* level-1 level-1-2 or level-2-only */
	134	/* are we overloaded? */
	135	char overload_bit;
	136	/* L1/L2 router identifier for inter-area traffic */
	137	char attached_bit;
d7c0a89a	138	uint16_t lsp_refresh[ISIS_LEVELS];
d62a17ae	139	/* minimum time allowed before lsp retransmission */
d7c0a89a	140	uint16_t lsp_gen_interval[ISIS_LEVELS];
d62a17ae	141	/* min interval between between consequtive SPFs */
d7c0a89a	142	uint16_t min_spf_interval[ISIS_LEVELS];
d62a17ae	143	/* the percentage of LSP mtu size used, before generating a new frag */
	144	int lsp_frag_threshold;
	145	int ip_circuits;
	146	/* logging adjacency changes? */
d7c0a89a	147	uint8_t log_adj_changes;
d62a17ae	148	/* multi topology settings */
	149	struct list *mt_settings;
	150	int ipv6_circuits;
2c92bee4	151	bool purge_originator;
d62a17ae	152	/* Counters */
d7c0a89a	153	uint32_t circuit_state_changes;
d62a17ae	154	struct isis_redist redist_settings[REDIST_PROTOCOL_COUNT]
	155	[ZEBRA_ROUTE_MAX + 1][ISIS_LEVELS];
	156	struct route_table *ext_reach[REDIST_PROTOCOL_COUNT][ISIS_LEVELS];
	157
	158	struct spf_backoff spf_delay_ietf[ISIS_LEVELS]; /Structure with IETF
	159	SPF algo
	160	parameters*/
	161	struct thread *spf_timer[ISIS_LEVELS];
	162
	163	QOBJ_FIELDS
eb5d44eb	164	};
676a4ea3	165	DECLARE_QOBJ_TYPE(isis_area)
eb5d44eb	166
d62a17ae	167	void isis_init(void);
3f045a08 JB	168	void isis_new(unsigned long);
3f045a08 JB	169	struct isis_area isis_area_create(const char );
d62a17ae	170	struct isis_area isis_area_lookup(const char );
d62a17ae	171	int isis_area_get(struct vty vty, const char area_tag);
3f045a08 JB	172	void print_debug(struct vty *, int, int);
3f045a08 JB	173
3dace42d CF	174	void isis_area_invalidate_routes(struct isis_area *area, int levels);
	175	void isis_area_verify_routes(struct isis_area *area);
	176
a38a72db CF	177	void isis_area_overload_bit_set(struct isis_area *area, bool overload_bit);
	178	void isis_area_attached_bit_set(struct isis_area *area, bool attached_bit);
	179	void isis_area_dynhostname_set(struct isis_area *area, bool dynhostname);
	180	void isis_area_metricstyle_set(struct isis_area *area, bool old_metric,
	181	bool new_metric);
6754fc66 CF	182	void isis_area_lsp_mtu_set(struct isis_area *area, unsigned int lsp_mtu);
6754fc66 CF	183	void isis_area_is_type_set(struct isis_area *area, int is_type);
466ed406	184	void isis_area_max_lsp_lifetime_set(struct isis_area *area, int level,
d62a17ae	185	uint16_t max_lsp_lifetime);
466ed406 CF	186	void isis_area_lsp_refresh_set(struct isis_area *area, int level,
466ed406 CF	187	uint16_t lsp_refresh);
9093b230	188	/* IS_LEVEL_1 sets area_passwd, IS_LEVEL_2 domain_passwd */
d62a17ae	189	int isis_area_passwd_unset(struct isis_area *area, int level);
d62a17ae	190	int isis_area_passwd_cleartext_set(struct isis_area *area, int level,
d7c0a89a	191	const char *passwd, uint8_t snp_auth);
d62a17ae	192	int isis_area_passwd_hmac_md5_set(struct isis_area *area, int level,
d7c0a89a	193	const char *passwd, uint8_t snp_auth);
65f9a9a8	194
3f045a08 JB	195	/* Master of threads. */
3f045a08 JB	196	extern struct thread_master *master;
eb5d44eb	197
	198	#define DEBUG_ADJ_PACKETS (1<<0)
	199	#define DEBUG_CHECKSUM_ERRORS (1<<1)
	200	#define DEBUG_LOCAL_UPDATES (1<<2)
	201	#define DEBUG_PROTOCOL_ERRORS (1<<3)
	202	#define DEBUG_SNP_PACKETS (1<<4)
	203	#define DEBUG_UPDATE_PACKETS (1<<5)
	204	#define DEBUG_SPF_EVENTS (1<<6)
	205	#define DEBUG_SPF_STATS (1<<7)
	206	#define DEBUG_SPF_TRIGGERS (1<<8)
	207	#define DEBUG_RTE_EVENTS (1<<9)
	208	#define DEBUG_EVENTS (1<<10)
c89c05dd	209	#define DEBUG_ZEBRA (1<<11)
3f045a08	210	#define DEBUG_PACKET_DUMP (1<<12)
14872644	211	#define DEBUG_LSP_GEN (1<<13)
414766a1	212	#define DEBUG_LSP_SCHED (1<<14)
d4cff91a	213	#define DEBUG_FABRICD_FLOODING (1<<15)
2815f817	214	#define DEBUG_BFD (1<<16)
14872644	215
d62a17ae	216	#define lsp_debug(...) \
	217	do { \
	218	if (isis->debugs & DEBUG_LSP_GEN) \
	219	zlog_debug(__VA_ARGS__); \
	220	} while (0)
	221
	222	#define sched_debug(...) \
	223	do { \
	224	if (isis->debugs & DEBUG_LSP_SCHED) \
	225	zlog_debug(__VA_ARGS__); \
	226	} while (0)
414766a1	227
f8c06e2c OD	228	#define DEBUG_TE (1<<13)
	229
	230	#define IS_DEBUG_ISIS(x) (isis->debugs & x)
	231
eb5d44eb	232	#endif /* ISISD_H */