[mirror_frr.git] / bfdd / bfd.h

/*********************************************************************
 * Copyright 2014,2015,2016,2017 Cumulus Networks, Inc.  All rights reserved.
 *
 * This program 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 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
 *
 * bfd.h: implements the BFD protocol.
 */

#ifndef _BFD_H_
#define _BFD_H_

#include <netinet/in.h>

#include <stdbool.h>
#include <stdarg.h>
#include <stdint.h>

#include "lib/hash.h"
#include "lib/libfrr.h"
#include "lib/qobj.h"
#include "lib/queue.h"

#include "bfdctl.h"

#define ETHERNET_ADDRESS_LENGTH 6

#ifdef BFD_DEBUG
#define BFDD_JSON_CONV_OPTIONS (JSON_C_TO_STRING_PRETTY)
#else
#define BFDD_JSON_CONV_OPTIONS (0)
#endif

DECLARE_MGROUP(BFDD);
DECLARE_MTYPE(BFDD_TMP);
DECLARE_MTYPE(BFDD_CONFIG);
DECLARE_MTYPE(BFDD_LABEL);
DECLARE_MTYPE(BFDD_CONTROL);
DECLARE_MTYPE(BFDD_NOTIFICATION);

struct bfd_timers {
	uint32_t desired_min_tx;
	uint32_t required_min_rx;
	uint32_t required_min_echo;
};

struct bfd_discrs {
	uint32_t my_discr;
	uint32_t remote_discr;
};

/*
 * Format of control packet.  From section 4)
 */
struct bfd_pkt {
	union {
		uint32_t byteFields;
		struct {
			uint8_t diag;
			uint8_t flags;
			uint8_t detect_mult;
			uint8_t len;
		};
	};
	struct bfd_discrs discrs;
	struct bfd_timers timers;
};

/*
 * Format of Echo packet.
 */
struct bfd_echo_pkt {
	union {
		uint32_t byteFields;
		struct {
			uint8_t ver;
			uint8_t len;
			uint16_t reserved;
		};
	};
	uint32_t my_discr;
	uint8_t pad[16];
};


/* Macros for manipulating control packets */
#define BFD_VERMASK 0x03
#define BFD_DIAGMASK 0x1F
#define BFD_GETVER(diag) ((diag >> 5) & BFD_VERMASK)
#define BFD_SETVER(diag, val) ((diag) |= (val & BFD_VERMASK) << 5)
#define BFD_VERSION 1
#define BFD_PBIT 0x20
#define BFD_FBIT 0x10
#define BFD_CBIT 0x08
#define BFD_ABIT 0x04
#define BFD_DEMANDBIT 0x02
#define BFD_SETDEMANDBIT(flags, val)                                           \
	{                                                                      \
		if ((val))                                                     \
			flags |= BFD_DEMANDBIT;                                \
	}
#define BFD_SETPBIT(flags, val)                                                \
	{                                                                      \
		if ((val))                                                     \
			flags |= BFD_PBIT;                                     \
	}
#define BFD_GETPBIT(flags) (flags & BFD_PBIT)
#define BFD_SETFBIT(flags, val)                                                \
	{                                                                      \
		if ((val))                                                     \
			flags |= BFD_FBIT;                                     \
	}
#define BFD_GETFBIT(flags) (flags & BFD_FBIT)
#define BFD_SETSTATE(flags, val)                                               \
	{                                                                      \
		if ((val))                                                     \
			flags |= (val & 0x3) << 6;                             \
	}
#define BFD_GETSTATE(flags) ((flags >> 6) & 0x3)
#define BFD_ECHO_VERSION 1
#define BFD_ECHO_PKT_LEN sizeof(struct bfd_echo_pkt)

enum bfd_diagnosticis {
	BD_OK = 0,
	/* Control Detection Time Expired. */
	BD_CONTROL_EXPIRED = 1,
	/* Echo Function Failed. */
	BD_ECHO_FAILED = 2,
	/* Neighbor Signaled Session Down. */
	BD_NEIGHBOR_DOWN = 3,
	/* Forwarding Plane Reset. */
	BD_FORWARDING_RESET = 4,
	/* Path Down. */
	BD_PATH_DOWN = 5,
	/* Concatenated Path Down. */
	BD_CONCATPATH_DOWN = 6,
	/* Administratively Down. */
	BD_ADMIN_DOWN = 7,
	/* Reverse Concatenated Path Down. */
	BD_REVCONCATPATH_DOWN = 8,
	/* 9..31: reserved. */
};

/* BFD session flags */
enum bfd_session_flags {
	BFD_SESS_FLAG_NONE = 0,
	BFD_SESS_FLAG_ECHO = 1 << 0,	/* BFD Echo functionality */
	BFD_SESS_FLAG_ECHO_ACTIVE = 1 << 1, /* BFD Echo Packets are being sent
					     * actively
					     */
	BFD_SESS_FLAG_MH = 1 << 2,	  /* BFD Multi-hop session */
	BFD_SESS_FLAG_IPV6 = 1 << 4,	/* BFD IPv6 session */
	BFD_SESS_FLAG_SEND_EVT_ACTIVE = 1 << 5, /* send event timer active */
	BFD_SESS_FLAG_SEND_EVT_IGNORE = 1 << 6, /* ignore send event when timer
						 * expires
						 */
	BFD_SESS_FLAG_SHUTDOWN = 1 << 7,	/* disable BGP peer function */
};

#define BFD_SET_FLAG(field, flag) (field |= flag)
#define BFD_UNSET_FLAG(field, flag) (field &= ~flag)
#define BFD_CHECK_FLAG(field, flag) (field & flag)

/* BFD session hash keys */
struct bfd_shop_key {
	struct sockaddr_any peer;
	char port_name[MAXNAMELEN + 1];
};

struct bfd_mhop_key {
	struct sockaddr_any peer;
	struct sockaddr_any local;
	char vrf_name[MAXNAMELEN + 1];
};

struct bfd_session_stats {
	uint64_t rx_ctrl_pkt;
	uint64_t tx_ctrl_pkt;
	uint64_t rx_echo_pkt;
	uint64_t tx_echo_pkt;
	uint64_t session_up;
	uint64_t session_down;
	uint64_t znotification;
};

/* bfd_session shortcut label forwarding. */
struct peer_label;

/*
 * Session state information
 */
struct bfd_session {

	/* protocol state per RFC 5880*/
	uint8_t ses_state;
	struct bfd_discrs discrs;
	uint8_t local_diag;
	uint8_t demand_mode;
	uint8_t detect_mult;
	uint8_t remote_detect_mult;
	uint8_t mh_ttl;

	/* Timers */
	struct bfd_timers timers;
	struct bfd_timers new_timers;
	uint32_t up_min_tx;
	uint64_t detect_TO;
	struct thread *echo_recvtimer_ev;
	struct thread *recvtimer_ev;
	uint64_t xmt_TO;
	uint64_t echo_xmt_TO;
	struct thread *xmttimer_ev;
	struct thread *echo_xmttimer_ev;
	uint64_t echo_detect_TO;

	/* software object state */
	uint8_t polling;

	/* This and the localDiscr are the keys to state info */
	struct peer_label *pl;
	union {
		struct bfd_shop_key shop;
		struct bfd_mhop_key mhop;
	};
	int sock;

	struct sockaddr_any local_address;
	struct sockaddr_any local_ip;
	int ifindex;
	uint8_t local_mac[ETHERNET_ADDRESS_LENGTH];
	uint8_t peer_mac[ETHERNET_ADDRESS_LENGTH];

	/* BFD session flags */
	enum bfd_session_flags flags;

	struct bfd_session_stats stats;

	struct timeval uptime;   /* last up time */
	struct timeval downtime; /* last down time */

	/* Remote peer data (for debugging mostly) */
	uint8_t remote_diag;
	struct bfd_timers remote_timers;

	uint64_t refcount; /* number of pointers referencing this. */

	/* VTY context data. */
	QOBJ_FIELDS;
};
DECLARE_QOBJ_TYPE(bfd_session);

struct peer_label {
	TAILQ_ENTRY(peer_label) pl_entry;

	struct bfd_session *pl_bs;
	char pl_label[MAXNAMELEN];
};
TAILQ_HEAD(pllist, peer_label);

struct bfd_diag_str_list {
	const char *str;
	int type;
};

struct bfd_state_str_list {
	const char *str;
	int type;
};

struct bfd_vrf {
	int vrf_id;
	char name[MAXNAMELEN + 1];
} bfd_vrf;

struct bfd_iface {
	int vrf_id;
	char ifname[MAXNAMELEN + 1];
} bfd_iface;


/* States defined per 4.1 */
#define PTM_BFD_ADM_DOWN 0
#define PTM_BFD_DOWN 1
#define PTM_BFD_INIT 2
#define PTM_BFD_UP 3


/* Various constants */
/* Retrieved from ptm_timer.h from Cumulus PTM sources. */
#define MSEC_PER_SEC 1000L
#define NSEC_PER_MSEC 1000000L

#define BFD_DEF_DEMAND 0
#define BFD_DEFDETECTMULT 3
#define BFD_DEFDESIREDMINTX (300 * MSEC_PER_SEC)
#define BFD_DEFREQUIREDMINRX (300 * MSEC_PER_SEC)
#define BFD_DEF_REQ_MIN_ECHO (50 * MSEC_PER_SEC)
#define BFD_DEF_SLOWTX (2000 * MSEC_PER_SEC)
#define BFD_DEF_MHOP_TTL 5
#define BFD_PKT_LEN 24 /* Length of control packet */
#define BFD_TTL_VAL 255
#define BFD_RCV_TTL_VAL 1
#define BFD_TOS_VAL 0xC0
#define BFD_PKT_INFO_VAL 1
#define BFD_IPV6_PKT_INFO_VAL 1
#define BFD_IPV6_ONLY_VAL 1
#define BFD_SRCPORTINIT 49142
#define BFD_SRCPORTMAX 65536
#define BFD_DEFDESTPORT 3784
#define BFD_DEF_ECHO_PORT 3785
#define BFD_DEF_MHOP_DEST_PORT 4784
#define BFD_CMD_STRING_LEN (MAXNAMELEN + 50)
#define BFD_BUFFER_LEN (BFD_CMD_STRING_LEN + MAXNAMELEN + 1)

/*
 * control.c
 *
 * Daemon control code to speak with local consumers.
 */

/* See 'bfdctrl.h' for client protocol definitions. */

struct bfd_control_buffer {
	size_t bcb_left;
	size_t bcb_pos;
	union {
		struct bfd_control_msg *bcb_bcm;
		uint8_t *bcb_buf;
	};
};

struct bfd_control_queue {
	TAILQ_ENTRY(bfd_control_queue) bcq_entry;

	struct bfd_control_buffer bcq_bcb;
};
TAILQ_HEAD(bcqueue, bfd_control_queue);

struct bfd_notify_peer {
	TAILQ_ENTRY(bfd_notify_peer) bnp_entry;

	struct bfd_session *bnp_bs;
};
TAILQ_HEAD(bnplist, bfd_notify_peer);

struct bfd_control_socket {
	TAILQ_ENTRY(bfd_control_socket) bcs_entry;

	int bcs_sd;
	struct thread *bcs_ev;
	struct thread *bcs_outev;
	struct bcqueue bcs_bcqueue;

	/* Notification data */
	uint64_t bcs_notify;
	struct bnplist bcs_bnplist;

	enum bc_msg_version bcs_version;
	enum bc_msg_type bcs_type;

	/* Message buffering */
	struct bfd_control_buffer bcs_bin;
	struct bfd_control_buffer *bcs_bout;
};
TAILQ_HEAD(bcslist, bfd_control_socket);

int control_init(const char *path);
void control_shutdown(void);
int control_notify(struct bfd_session *bs);
int control_notify_config(const char *op, struct bfd_session *bs);
int control_accept(struct thread *t);


/*
 * bfdd.c
 *
 * Daemon specific code.
 */
struct bfd_global {
	int bg_shop;
	int bg_mhop;
	int bg_shop6;
	int bg_mhop6;
	int bg_echo;
	int bg_echov6;
	struct thread *bg_ev[6];

	int bg_csock;
	struct thread *bg_csockev;
	struct bcslist bg_bcslist;

	struct pllist bg_pllist;
};
extern struct bfd_global bglobal;
extern struct bfd_diag_str_list diag_list[];
extern struct bfd_state_str_list state_list[];

void socket_close(int *s);


/*
 * config.c
 *
 * Contains the code related with loading/reloading configuration.
 */
int parse_config(const char *fname);
int config_request_add(const char *jsonstr);
int config_request_del(const char *jsonstr);
char *config_response(const char *status, const char *error);
char *config_notify(struct bfd_session *bs);
char *config_notify_config(const char *op, struct bfd_session *bs);

typedef int (*bpc_handle)(struct bfd_peer_cfg *, void *arg);
int config_notify_request(struct bfd_control_socket *bcs, const char *jsonstr,
			  bpc_handle bh);

struct peer_label *pl_new(const char *label, struct bfd_session *bs);
struct peer_label *pl_find(const char *label);
void pl_free(struct peer_label *pl);


/*
 * log.c
 *
 * Contains code that does the logging procedures. Might implement multiple
 * backends (e.g. zebra log, syslog or other logging lib).
 */
enum blog_level {
	/* level vs syslog equivalent */
	BLOG_DEBUG = 0,   /* LOG_DEBUG */
	BLOG_INFO = 1,    /* LOG_INFO */
	BLOG_WARNING = 2, /* LOG_WARNING */
	BLOG_ERROR = 3,   /* LOG_ERR */
	BLOG_FATAL = 4,   /* LOG_CRIT */
};

void log_init(int foreground, enum blog_level level,
	      struct frr_daemon_info *fdi);
void log_info(const char *fmt, ...);
void log_debug(const char *fmt, ...);
void log_warning(const char *fmt, ...);
void log_error(const char *fmt, ...);
void log_fatal(const char *fmt, ...);


/*
 * bfd_packet.c
 *
 * Contains the code related with receiving/seding, packing/unpacking BFD data.
 */
int bp_set_ttlv6(int sd, uint8_t value);
int bp_set_ttl(int sd, uint8_t value);
int bp_set_tosv6(int sd, uint8_t value);
int bp_set_tos(int sd, uint8_t value);
int bp_bind_dev(int sd, const char *dev);

int bp_udp_shop(void);
int bp_udp_mhop(void);
int bp_udp6_shop(void);
int bp_udp6_mhop(void);
int bp_peer_socket(struct bfd_peer_cfg *bpc);
int bp_peer_socketv6(struct bfd_peer_cfg *bpc);
int bp_echo_socket(void);
int bp_echov6_socket(void);

void ptm_bfd_snd(struct bfd_session *bfd, int fbit);
void ptm_bfd_echo_snd(struct bfd_session *bfd);

int bfd_recv_cb(struct thread *t);


/*
 * event.c
 *
 * Contains the code related with event loop.
 */
typedef void (*bfd_ev_cb)(struct thread *t);

void bfd_recvtimer_update(struct bfd_session *bs);
void bfd_echo_recvtimer_update(struct bfd_session *bs);
void bfd_xmttimer_update(struct bfd_session *bs, uint64_t jitter);
void bfd_echo_xmttimer_update(struct bfd_session *bs, uint64_t jitter);

void bfd_xmttimer_delete(struct bfd_session *bs);
void bfd_echo_xmttimer_delete(struct bfd_session *bs);
void bfd_recvtimer_delete(struct bfd_session *bs);
void bfd_echo_recvtimer_delete(struct bfd_session *bs);

void bfd_recvtimer_assign(struct bfd_session *bs, bfd_ev_cb cb, int sd);
void bfd_echo_recvtimer_assign(struct bfd_session *bs, bfd_ev_cb cb, int sd);
void bfd_xmttimer_assign(struct bfd_session *bs, bfd_ev_cb cb);
void bfd_echo_xmttimer_assign(struct bfd_session *bs, bfd_ev_cb cb);


/*
 * bfd.c
 *
 * BFD protocol specific code.
 */
struct bfd_session *ptm_bfd_sess_new(struct bfd_peer_cfg *bpc);
int ptm_bfd_ses_del(struct bfd_peer_cfg *bpc);
void ptm_bfd_ses_dn(struct bfd_session *bfd, uint8_t diag);
void ptm_bfd_ses_up(struct bfd_session *bfd);
void fetch_portname_from_ifindex(int ifindex, char *ifname, size_t ifnamelen);
void ptm_bfd_echo_stop(struct bfd_session *bfd, int polling);
void ptm_bfd_echo_start(struct bfd_session *bfd);
void ptm_bfd_xmt_TO(struct bfd_session *bfd, int fbit);
void ptm_bfd_start_xmt_timer(struct bfd_session *bfd, bool is_echo);
struct bfd_session *ptm_bfd_sess_find(struct bfd_pkt *cp, char *port_name,
				      struct sockaddr_any *peer,
				      struct sockaddr_any *local,
				      char *vrf_name, bool is_mhop);

struct bfd_session *bs_peer_find(struct bfd_peer_cfg *bpc);
int bfd_session_update_label(struct bfd_session *bs, const char *nlabel);
void bfd_set_polling(struct bfd_session *bs);
const char *satostr(struct sockaddr_any *sa);
const char *diag2str(uint8_t diag);
int strtosa(const char *addr, struct sockaddr_any *sa);
void integer2timestr(uint64_t time, char *buf, size_t buflen);
const char *bs_to_string(struct bfd_session *bs);

/* BFD hash data structures interface */
void bfd_initialize(void);
void bfd_shutdown(void);
struct bfd_session *bfd_id_lookup(uint32_t id);
struct bfd_session *bfd_shop_lookup(struct bfd_shop_key shop);
struct bfd_session *bfd_mhop_lookup(struct bfd_mhop_key mhop);
struct bfd_vrf *bfd_vrf_lookup(int vrf_id);
struct bfd_iface *bfd_iface_lookup(const char *ifname);

struct bfd_session *bfd_id_delete(uint32_t id);
struct bfd_session *bfd_shop_delete(struct bfd_shop_key shop);
struct bfd_session *bfd_mhop_delete(struct bfd_mhop_key mhop);
struct bfd_vrf *bfd_vrf_delete(int vrf_id);
struct bfd_iface *bfd_iface_delete(const char *ifname);

bool bfd_id_insert(struct bfd_session *bs);
bool bfd_shop_insert(struct bfd_session *bs);
bool bfd_mhop_insert(struct bfd_session *bs);
bool bfd_vrf_insert(struct bfd_vrf *vrf);
bool bfd_iface_insert(struct bfd_iface *iface);

typedef void (*hash_iter_func)(struct hash_backet *hb, void *arg);
void bfd_id_iterate(hash_iter_func hif, void *arg);
void bfd_shop_iterate(hash_iter_func hif, void *arg);
void bfd_mhop_iterate(hash_iter_func hif, void *arg);
void bfd_vrf_iterate(hash_iter_func hif, void *arg);
void bfd_iface_iterate(hash_iter_func hif, void *arg);

/* Export callback functions for `event.c`. */
extern struct thread_master *master;

int bfd_recvtimer_cb(struct thread *t);
int bfd_echo_recvtimer_cb(struct thread *t);
int bfd_xmt_cb(struct thread *t);
int bfd_echo_xmt_cb(struct thread *t);


/*
 * bfdd_vty.c
 *
 * BFD daemon vty shell commands.
 */
void bfdd_vty_init(void);


/*
 * ptm_adapter.c
 */
void bfdd_zclient_init(struct zebra_privs_t *bfdd_priv);
void bfdd_zclient_stop(void);

int ptm_bfd_notify(struct bfd_session *bs);


/*
 * OS compatibility functions.
 */
#if defined(BFD_LINUX) || defined(BFD_BSD)
int ptm_bfd_fetch_ifindex(const char *ifname);
void ptm_bfd_fetch_local_mac(const char *ifname, uint8_t *mac);
void fetch_portname_from_ifindex(int ifindex, char *ifname, size_t ifnamelen);
#endif /* BFD_LINUX || BFD_BSD */

#ifdef BFD_BSD
ssize_t bsd_echo_sock_read(int sd, uint8_t *buf, ssize_t *buflen,
			   struct sockaddr_storage *ss, socklen_t *sslen,
			   uint8_t *ttl, uint32_t *id);
#endif /* BFD_BSD */

#endif /* _BFD_H_ */
Commit	Line	Data
e9e2c950 RZ	1	/*********************************************************************
	2	* Copyright 2014,2015,2016,2017 Cumulus Networks, Inc. All rights reserved.
	3	*
	4	* This program is free software; you can redistribute it and/or modify it
	5	* under the terms of the GNU General Public License as published by the Free
	6	* Software Foundation; either version 2 of the License, or (at your option)
	7	* any later version.
	8	*
	9	* This program is distributed in the hope that it will be useful, but WITHOUT
	10	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
	11	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
	12	* more details.
	13	*
	14	* You should have received a copy of the GNU General Public License along
	15	* with this program; see the file COPYING; if not, write to the Free Software
	16	* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
	17	*
	18	* bfd.h: implements the BFD protocol.
	19	*/
	20
	21	#ifndef _BFD_H_
	22	#define _BFD_H_
	23
	24	#include <netinet/in.h>
	25
	26	#include <stdbool.h>
	27	#include <stdarg.h>
	28	#include <stdint.h>
	29
	30	#include "lib/hash.h"
	31	#include "lib/libfrr.h"
	32	#include "lib/qobj.h"
	33	#include "lib/queue.h"
	34
	35	#include "bfdctl.h"
	36
	37	#define ETHERNET_ADDRESS_LENGTH 6
	38
	39	#ifdef BFD_DEBUG
	40	#define BFDD_JSON_CONV_OPTIONS (JSON_C_TO_STRING_PRETTY)
	41	#else
	42	#define BFDD_JSON_CONV_OPTIONS (0)
	43	#endif
	44
	45	DECLARE_MGROUP(BFDD);
	46	DECLARE_MTYPE(BFDD_TMP);
	47	DECLARE_MTYPE(BFDD_CONFIG);
	48	DECLARE_MTYPE(BFDD_LABEL);
	49	DECLARE_MTYPE(BFDD_CONTROL);
	50	DECLARE_MTYPE(BFDD_NOTIFICATION);
	51
	52	struct bfd_timers {
	53	uint32_t desired_min_tx;
	54	uint32_t required_min_rx;
	55	uint32_t required_min_echo;
	56	};
	57
	58	struct bfd_discrs {
	59	uint32_t my_discr;
	60	uint32_t remote_discr;
	61	};
	62
	63	/*
	64	* Format of control packet. From section 4)
65	*/
66	struct bfd_pkt {
67	union {
68	uint32_t byteFields;
69	struct {
70	uint8_t diag;
71	uint8_t flags;
72	uint8_t detect_mult;
73	uint8_t len;
74	};
75	};
76	struct bfd_discrs discrs;
77	struct bfd_timers timers;
78	};
79
80	/*
81	* Format of Echo packet.
82	*/
83	struct bfd_echo_pkt {
84	union {
85	uint32_t byteFields;
86	struct {
87	uint8_t ver;
88	uint8_t len;
89	uint16_t reserved;
90	};
91	};
92	uint32_t my_discr;
93	uint8_t pad[16];
94	};
95
96
97	/* Macros for manipulating control packets */
98	#define BFD_VERMASK 0x03
99	#define BFD_DIAGMASK 0x1F
100	#define BFD_GETVER(diag) ((diag >> 5) & BFD_VERMASK)
101	#define BFD_SETVER(diag, val) ((diag) \|= (val & BFD_VERMASK) << 5)
102	#define BFD_VERSION 1
103	#define BFD_PBIT 0x20
104	#define BFD_FBIT 0x10
105	#define BFD_CBIT 0x08
106	#define BFD_ABIT 0x04
107	#define BFD_DEMANDBIT 0x02
e9e2c950 RZ	108	#define BFD_SETDEMANDBIT(flags, val) \
	109	{ \
	110	if ((val)) \
	111	flags \|= BFD_DEMANDBIT; \
	112	}
	113	#define BFD_SETPBIT(flags, val) \
	114	{ \
	115	if ((val)) \
	116	flags \|= BFD_PBIT; \
	117	}
	118	#define BFD_GETPBIT(flags) (flags & BFD_PBIT)
	119	#define BFD_SETFBIT(flags, val) \
	120	{ \
	121	if ((val)) \
	122	flags \|= BFD_FBIT; \
	123	}
	124	#define BFD_GETFBIT(flags) (flags & BFD_FBIT)
	125	#define BFD_SETSTATE(flags, val) \
	126	{ \
	127	if ((val)) \
	128	flags \|= (val & 0x3) << 6; \
	129	}
	130	#define BFD_GETSTATE(flags) ((flags >> 6) & 0x3)
	131	#define BFD_ECHO_VERSION 1
	132	#define BFD_ECHO_PKT_LEN sizeof(struct bfd_echo_pkt)
e9e2c950	133
40675ea9 RZ	134	enum bfd_diagnosticis {
	135	BD_OK = 0,
	136	/* Control Detection Time Expired. */
	137	BD_CONTROL_EXPIRED = 1,
	138	/* Echo Function Failed. */
	139	BD_ECHO_FAILED = 2,
	140	/* Neighbor Signaled Session Down. */
	141	BD_NEIGHBOR_DOWN = 3,
	142	/* Forwarding Plane Reset. */
	143	BD_FORWARDING_RESET = 4,
	144	/* Path Down. */
	145	BD_PATH_DOWN = 5,
	146	/* Concatenated Path Down. */
	147	BD_CONCATPATH_DOWN = 6,
	148	/* Administratively Down. */
	149	BD_ADMIN_DOWN = 7,
	150	/* Reverse Concatenated Path Down. */
	151	BD_REVCONCATPATH_DOWN = 8,
	152	/* 9..31: reserved. */
	153	};
	154
e9e2c950 RZ	155	/* BFD session flags */
	156	enum bfd_session_flags {
	157	BFD_SESS_FLAG_NONE = 0,
	158	BFD_SESS_FLAG_ECHO = 1 << 0, /* BFD Echo functionality */
	159	BFD_SESS_FLAG_ECHO_ACTIVE = 1 << 1, /* BFD Echo Packets are being sent
	160	* actively
	161	*/
	162	BFD_SESS_FLAG_MH = 1 << 2, /* BFD Multi-hop session */
e9e2c950 RZ	163	BFD_SESS_FLAG_IPV6 = 1 << 4, /* BFD IPv6 session */
	164	BFD_SESS_FLAG_SEND_EVT_ACTIVE = 1 << 5, /* send event timer active */
	165	BFD_SESS_FLAG_SEND_EVT_IGNORE = 1 << 6, /* ignore send event when timer
	166	* expires
	167	*/
	168	BFD_SESS_FLAG_SHUTDOWN = 1 << 7, /* disable BGP peer function */
	169	};
	170
	171	#define BFD_SET_FLAG(field, flag) (field \|= flag)
	172	#define BFD_UNSET_FLAG(field, flag) (field &= ~flag)
	173	#define BFD_CHECK_FLAG(field, flag) (field & flag)
	174
	175	/* BFD session hash keys */
	176	struct bfd_shop_key {
	177	struct sockaddr_any peer;
	178	char port_name[MAXNAMELEN + 1];
	179	};
	180
	181	struct bfd_mhop_key {
	182	struct sockaddr_any peer;
	183	struct sockaddr_any local;
	184	char vrf_name[MAXNAMELEN + 1];
	185	};
	186
	187	struct bfd_session_stats {
	188	uint64_t rx_ctrl_pkt;
	189	uint64_t tx_ctrl_pkt;
	190	uint64_t rx_echo_pkt;
	191	uint64_t tx_echo_pkt;
0684c9b1 RZ	192	uint64_t session_up;
	193	uint64_t session_down;
	194	uint64_t znotification;
e9e2c950 RZ	195	};
e9e2c950 RZ	196
e9e2c950 RZ	197	/* bfd_session shortcut label forwarding. */
	198	struct peer_label;
	199
	200	/*
	201	* Session state information
	202	*/
	203	struct bfd_session {
	204
	205	/* protocol state per RFC 5880*/
	206	uint8_t ses_state;
	207	struct bfd_discrs discrs;
	208	uint8_t local_diag;
	209	uint8_t demand_mode;
	210	uint8_t detect_mult;
	211	uint8_t remote_detect_mult;
	212	uint8_t mh_ttl;
	213
	214	/* Timers */
	215	struct bfd_timers timers;
	216	struct bfd_timers new_timers;
	217	uint32_t up_min_tx;
	218	uint64_t detect_TO;
	219	struct thread *echo_recvtimer_ev;
	220	struct thread *recvtimer_ev;
	221	uint64_t xmt_TO;
	222	uint64_t echo_xmt_TO;
	223	struct thread *xmttimer_ev;
	224	struct thread *echo_xmttimer_ev;
	225	uint64_t echo_detect_TO;
	226
	227	/* software object state */
	228	uint8_t polling;
	229
	230	/* This and the localDiscr are the keys to state info */
	231	struct peer_label *pl;
	232	union {
	233	struct bfd_shop_key shop;
	234	struct bfd_mhop_key mhop;
	235	};
	236	int sock;
	237
	238	struct sockaddr_any local_address;
	239	struct sockaddr_any local_ip;
	240	int ifindex;
	241	uint8_t local_mac[ETHERNET_ADDRESS_LENGTH];
	242	uint8_t peer_mac[ETHERNET_ADDRESS_LENGTH];
e9e2c950 RZ	243
	244	/* BFD session flags */
	245	enum bfd_session_flags flags;
	246
e9e2c950	247	struct bfd_session_stats stats;
e9e2c950 RZ	248
	249	struct timeval uptime; /* last up time */
	250	struct timeval downtime; /* last down time */
	251
	252	/* Remote peer data (for debugging mostly) */
	253	uint8_t remote_diag;
	254	struct bfd_timers remote_timers;
	255
	256	uint64_t refcount; /* number of pointers referencing this. */
	257
	258	/* VTY context data. */
	259	QOBJ_FIELDS;
	260	};
	261	DECLARE_QOBJ_TYPE(bfd_session);
	262
	263	struct peer_label {
	264	TAILQ_ENTRY(peer_label) pl_entry;
	265
	266	struct bfd_session *pl_bs;
	267	char pl_label[MAXNAMELEN];
	268	};
	269	TAILQ_HEAD(pllist, peer_label);
	270
	271	struct bfd_diag_str_list {
	272	const char *str;
	273	int type;
	274	};
	275
	276	struct bfd_state_str_list {
	277	const char *str;
	278	int type;
	279	};
	280
	281	struct bfd_vrf {
	282	int vrf_id;
	283	char name[MAXNAMELEN + 1];
	284	} bfd_vrf;
	285
	286	struct bfd_iface {
	287	int vrf_id;
	288	char ifname[MAXNAMELEN + 1];
	289	} bfd_iface;
	290
	291
	292	/* States defined per 4.1 */
	293	#define PTM_BFD_ADM_DOWN 0
	294	#define PTM_BFD_DOWN 1
	295	#define PTM_BFD_INIT 2
	296	#define PTM_BFD_UP 3
	297
	298
	299	/* Various constants */
	300	/* Retrieved from ptm_timer.h from Cumulus PTM sources. */
	301	#define MSEC_PER_SEC 1000L
	302	#define NSEC_PER_MSEC 1000000L
	303
	304	#define BFD_DEF_DEMAND 0
	305	#define BFD_DEFDETECTMULT 3
	306	#define BFD_DEFDESIREDMINTX (300 * MSEC_PER_SEC)
	307	#define BFD_DEFREQUIREDMINRX (300 * MSEC_PER_SEC)
	308	#define BFD_DEF_REQ_MIN_ECHO (50 * MSEC_PER_SEC)
	309	#define BFD_DEF_SLOWTX (2000 * MSEC_PER_SEC)
	310	#define BFD_DEF_MHOP_TTL 5
	311	#define BFD_PKT_LEN 24 /* Length of control packet */
312	#define BFD_TTL_VAL 255
313	#define BFD_RCV_TTL_VAL 1
314	#define BFD_TOS_VAL 0xC0
315	#define BFD_PKT_INFO_VAL 1
316	#define BFD_IPV6_PKT_INFO_VAL 1
317	#define BFD_IPV6_ONLY_VAL 1
318	#define BFD_SRCPORTINIT 49142
319	#define BFD_SRCPORTMAX 65536
320	#define BFD_DEFDESTPORT 3784
321	#define BFD_DEF_ECHO_PORT 3785
322	#define BFD_DEF_MHOP_DEST_PORT 4784
323	#define BFD_CMD_STRING_LEN (MAXNAMELEN + 50)
324	#define BFD_BUFFER_LEN (BFD_CMD_STRING_LEN + MAXNAMELEN + 1)
325
326	/*
327	* control.c
328	*
329	* Daemon control code to speak with local consumers.
330	*/
331
332	/* See 'bfdctrl.h' for client protocol definitions. */
333
334	struct bfd_control_buffer {
335	size_t bcb_left;
336	size_t bcb_pos;
337	union {
338	struct bfd_control_msg *bcb_bcm;
339	uint8_t *bcb_buf;
340	};
341	};
342
343	struct bfd_control_queue {
344	TAILQ_ENTRY(bfd_control_queue) bcq_entry;
345
346	struct bfd_control_buffer bcq_bcb;
347	};
348	TAILQ_HEAD(bcqueue, bfd_control_queue);
349
350	struct bfd_notify_peer {
351	TAILQ_ENTRY(bfd_notify_peer) bnp_entry;
352
353	struct bfd_session *bnp_bs;
354	};
355	TAILQ_HEAD(bnplist, bfd_notify_peer);
356
357	struct bfd_control_socket {
358	TAILQ_ENTRY(bfd_control_socket) bcs_entry;
359
360	int bcs_sd;
361	struct thread *bcs_ev;
362	struct thread *bcs_outev;
363	struct bcqueue bcs_bcqueue;
364
365	/* Notification data */
366	uint64_t bcs_notify;
367	struct bnplist bcs_bnplist;
368
369	enum bc_msg_version bcs_version;
370	enum bc_msg_type bcs_type;
371
372	/* Message buffering */
373	struct bfd_control_buffer bcs_bin;
374	struct bfd_control_buffer *bcs_bout;
375	};
376	TAILQ_HEAD(bcslist, bfd_control_socket);
377
378	int control_init(const char *path);
379	void control_shutdown(void);
380	int control_notify(struct bfd_session *bs);
381	int control_notify_config(const char op, struct bfd_session bs);
382	int control_accept(struct thread *t);
383
384
385	/*
386	* bfdd.c
387	*
388	* Daemon specific code.
389	*/
390	struct bfd_global {
391	int bg_shop;
392	int bg_mhop;
393	int bg_shop6;
394	int bg_mhop6;
395	int bg_echo;
2f11c53f	396	int bg_echov6;
e9e2c950 RZ	397	struct thread *bg_ev[6];
	398
	399	int bg_csock;
	400	struct thread *bg_csockev;
	401	struct bcslist bg_bcslist;
	402
	403	struct pllist bg_pllist;
	404	};
	405	extern struct bfd_global bglobal;
	406	extern struct bfd_diag_str_list diag_list[];
	407	extern struct bfd_state_str_list state_list[];
	408
	409	void socket_close(int *s);
	410
	411
	412	/*
	413	* config.c
	414	*
	415	* Contains the code related with loading/reloading configuration.
	416	*/
	417	int parse_config(const char *fname);
	418	int config_request_add(const char *jsonstr);
	419	int config_request_del(const char *jsonstr);
	420	char config_response(const char status, const char *error);
	421	char config_notify(struct bfd_session bs);
	422	char config_notify_config(const char op, struct bfd_session *bs);
	423
	424	typedef int (bpc_handle)(struct bfd_peer_cfg , void *arg);
	425	int config_notify_request(struct bfd_control_socket bcs, const char jsonstr,
	426	bpc_handle bh);
	427
	428	struct peer_label pl_new(const char label, struct bfd_session *bs);
	429	struct peer_label pl_find(const char label);
	430	void pl_free(struct peer_label *pl);
	431
	432
	433	/*
	434	* log.c
	435	*
	436	* Contains code that does the logging procedures. Might implement multiple
	437	* backends (e.g. zebra log, syslog or other logging lib).
	438	*/
	439	enum blog_level {
	440	/* level vs syslog equivalent */
	441	BLOG_DEBUG = 0, /* LOG_DEBUG */
	442	BLOG_INFO = 1, /* LOG_INFO */
	443	BLOG_WARNING = 2, /* LOG_WARNING */
	444	BLOG_ERROR = 3, /* LOG_ERR */
	445	BLOG_FATAL = 4, /* LOG_CRIT */
	446	};
	447
	448	void log_init(int foreground, enum blog_level level,
	449	struct frr_daemon_info *fdi);
	450	void log_info(const char *fmt, ...);
	451	void log_debug(const char *fmt, ...);
	452	void log_warning(const char *fmt, ...);
	453	void log_error(const char *fmt, ...);
	454	void log_fatal(const char *fmt, ...);
	455
e9e2c950 RZ	456
	457	/*
	458	* bfd_packet.c
	459	*
	460	* Contains the code related with receiving/seding, packing/unpacking BFD data.
	461	*/
6e01e275 RZ	462	int bp_set_ttlv6(int sd, uint8_t value);
	463	int bp_set_ttl(int sd, uint8_t value);
	464	int bp_set_tosv6(int sd, uint8_t value);
	465	int bp_set_tos(int sd, uint8_t value);
e9e2c950 RZ	466	int bp_bind_dev(int sd, const char *dev);
	467
	468	int bp_udp_shop(void);
	469	int bp_udp_mhop(void);
	470	int bp_udp6_shop(void);
	471	int bp_udp6_mhop(void);
	472	int bp_peer_socket(struct bfd_peer_cfg *bpc);
	473	int bp_peer_socketv6(struct bfd_peer_cfg *bpc);
2f11c53f RZ	474	int bp_echo_socket(void);
2f11c53f RZ	475	int bp_echov6_socket(void);
e9e2c950 RZ	476
	477	void ptm_bfd_snd(struct bfd_session *bfd, int fbit);
	478	void ptm_bfd_echo_snd(struct bfd_session *bfd);
	479
	480	int bfd_recv_cb(struct thread *t);
	481
e9e2c950 RZ	482
	483	/*
	484	* event.c
	485	*
	486	* Contains the code related with event loop.
	487	*/
	488	typedef void (bfd_ev_cb)(struct thread t);
	489
	490	void bfd_recvtimer_update(struct bfd_session *bs);
	491	void bfd_echo_recvtimer_update(struct bfd_session *bs);
	492	void bfd_xmttimer_update(struct bfd_session *bs, uint64_t jitter);
	493	void bfd_echo_xmttimer_update(struct bfd_session *bs, uint64_t jitter);
	494
	495	void bfd_xmttimer_delete(struct bfd_session *bs);
	496	void bfd_echo_xmttimer_delete(struct bfd_session *bs);
	497	void bfd_recvtimer_delete(struct bfd_session *bs);
	498	void bfd_echo_recvtimer_delete(struct bfd_session *bs);
	499
	500	void bfd_recvtimer_assign(struct bfd_session *bs, bfd_ev_cb cb, int sd);
	501	void bfd_echo_recvtimer_assign(struct bfd_session *bs, bfd_ev_cb cb, int sd);
	502	void bfd_xmttimer_assign(struct bfd_session *bs, bfd_ev_cb cb);
	503	void bfd_echo_xmttimer_assign(struct bfd_session *bs, bfd_ev_cb cb);
	504
	505
	506	/*
	507	* bfd.c
	508	*
	509	* BFD protocol specific code.
	510	*/
	511	struct bfd_session ptm_bfd_sess_new(struct bfd_peer_cfg bpc);
	512	int ptm_bfd_ses_del(struct bfd_peer_cfg *bpc);
	513	void ptm_bfd_ses_dn(struct bfd_session *bfd, uint8_t diag);
	514	void ptm_bfd_ses_up(struct bfd_session *bfd);
	515	void fetch_portname_from_ifindex(int ifindex, char *ifname, size_t ifnamelen);
	516	void ptm_bfd_echo_stop(struct bfd_session *bfd, int polling);
	517	void ptm_bfd_echo_start(struct bfd_session *bfd);
	518	void ptm_bfd_xmt_TO(struct bfd_session *bfd, int fbit);
	519	void ptm_bfd_start_xmt_timer(struct bfd_session *bfd, bool is_echo);
	520	struct bfd_session ptm_bfd_sess_find(struct bfd_pkt cp, char *port_name,
	521	struct sockaddr_any *peer,
	522	struct sockaddr_any *local,
	523	char *vrf_name, bool is_mhop);
	524
	525	struct bfd_session bs_peer_find(struct bfd_peer_cfg bpc);
	526	int bfd_session_update_label(struct bfd_session bs, const char nlabel);
d3f3a2c4	527	void bfd_set_polling(struct bfd_session *bs);
e9e2c950 RZ	528	const char satostr(struct sockaddr_any sa);
	529	const char *diag2str(uint8_t diag);
	530	int strtosa(const char addr, struct sockaddr_any sa);
	531	void integer2timestr(uint64_t time, char *buf, size_t buflen);
03e7f088	532	const char bs_to_string(struct bfd_session bs);
e9e2c950 RZ	533
	534	/* BFD hash data structures interface */
	535	void bfd_initialize(void);
	536	void bfd_shutdown(void);
	537	struct bfd_session *bfd_id_lookup(uint32_t id);
	538	struct bfd_session *bfd_shop_lookup(struct bfd_shop_key shop);
	539	struct bfd_session *bfd_mhop_lookup(struct bfd_mhop_key mhop);
	540	struct bfd_vrf *bfd_vrf_lookup(int vrf_id);
	541	struct bfd_iface bfd_iface_lookup(const char ifname);
	542
	543	struct bfd_session *bfd_id_delete(uint32_t id);
	544	struct bfd_session *bfd_shop_delete(struct bfd_shop_key shop);
	545	struct bfd_session *bfd_mhop_delete(struct bfd_mhop_key mhop);
	546	struct bfd_vrf *bfd_vrf_delete(int vrf_id);
	547	struct bfd_iface bfd_iface_delete(const char ifname);
	548
	549	bool bfd_id_insert(struct bfd_session *bs);
	550	bool bfd_shop_insert(struct bfd_session *bs);
	551	bool bfd_mhop_insert(struct bfd_session *bs);
	552	bool bfd_vrf_insert(struct bfd_vrf *vrf);
	553	bool bfd_iface_insert(struct bfd_iface *iface);
	554
	555	typedef void (hash_iter_func)(struct hash_backet hb, void *arg);
	556	void bfd_id_iterate(hash_iter_func hif, void *arg);
	557	void bfd_shop_iterate(hash_iter_func hif, void *arg);
	558	void bfd_mhop_iterate(hash_iter_func hif, void *arg);
	559	void bfd_vrf_iterate(hash_iter_func hif, void *arg);
	560	void bfd_iface_iterate(hash_iter_func hif, void *arg);
	561
	562	/* Export callback functions for `event.c`. */
	563	extern struct thread_master *master;
	564
	565	int bfd_recvtimer_cb(struct thread *t);
	566	int bfd_echo_recvtimer_cb(struct thread *t);
	567	int bfd_xmt_cb(struct thread *t);
	568	int bfd_echo_xmt_cb(struct thread *t);
	569
	570
c2f29cf3 RZ	571	/*
	572	* bfdd_vty.c
	573	*
	574	* BFD daemon vty shell commands.
	575	*/
	576	void bfdd_vty_init(void);
	577
	578
d3af6147 RZ	579	/*
	580	* ptm_adapter.c
	581	*/
	582	void bfdd_zclient_init(struct zebra_privs_t *bfdd_priv);
	583	void bfdd_zclient_stop(void);
	584
	585	int ptm_bfd_notify(struct bfd_session *bs);
	586
	587
e9e2c950 RZ	588	/*
	589	* OS compatibility functions.
	590	*/
e9e2c950 RZ	591	#if defined(BFD_LINUX) \|\| defined(BFD_BSD)
	592	int ptm_bfd_fetch_ifindex(const char *ifname);
	593	void ptm_bfd_fetch_local_mac(const char ifname, uint8_t mac);
	594	void fetch_portname_from_ifindex(int ifindex, char *ifname, size_t ifnamelen);
e9e2c950 RZ	595	#endif /* BFD_LINUX \|\| BFD_BSD */
e9e2c950 RZ	596
e9e2c950	597	#ifdef BFD_BSD
e9e2c950 RZ	598	ssize_t bsd_echo_sock_read(int sd, uint8_t buf, ssize_t buflen,
	599	struct sockaddr_storage ss, socklen_t sslen,
	600	uint8_t ttl, uint32_t id);
	601	#endif /* BFD_BSD */
	602
	603	#endif /* _BFD_H_ */