[mirror_frr.git] / pimd / pim_igmp.h

/*
 * PIM for Quagga
 * Copyright (C) 2008  Everton da Silva Marques
 *
 * 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
 */

#ifndef PIM_IGMP_H
#define PIM_IGMP_H

#include <netinet/in.h>

#include <zebra.h>
#include "vty.h"
#include "linklist.h"
#include "pim_igmp_stats.h"
#include "pim_str.h"

/*
  The following sizes are likely to support
  any message sent within local MTU.
*/
#define PIM_IGMP_BUFSIZE_READ         (20000)
#define PIM_IGMP_BUFSIZE_WRITE        (20000)

#define PIM_IGMP_MEMBERSHIP_QUERY     (0x11)
#define PIM_IGMP_V1_MEMBERSHIP_REPORT (0x12)
#define PIM_IGMP_V2_MEMBERSHIP_REPORT (0x16)
#define PIM_IGMP_V2_LEAVE_GROUP       (0x17)
#define PIM_IGMP_MTRACE_RESPONSE      (0x1E)
#define PIM_IGMP_MTRACE_QUERY_REQUEST (0x1F)
#define PIM_IGMP_V3_MEMBERSHIP_REPORT (0x22)

#define IGMP_V3_REPORT_HEADER_SIZE    (8)
#define IGMP_V3_GROUP_RECORD_MIN_SIZE (8)
#define IGMP_V3_MSG_MIN_SIZE                                                   \
	(IGMP_V3_REPORT_HEADER_SIZE + IGMP_V3_GROUP_RECORD_MIN_SIZE)
#define IGMP_V12_MSG_SIZE             (8)

#define IGMP_V3_GROUP_RECORD_TYPE_OFFSET       (0)
#define IGMP_V3_GROUP_RECORD_AUXDATALEN_OFFSET (1)
#define IGMP_V3_GROUP_RECORD_NUMSOURCES_OFFSET (2)
#define IGMP_V3_GROUP_RECORD_GROUP_OFFSET      (4)
#define IGMP_V3_GROUP_RECORD_SOURCE_OFFSET     (8)
#define IGMP_CHECKSUM_OFFSET                   (2)

#define IGMP_DEFAULT_VERSION (3)

#define IGMP_GET_INT16(ptr, output)                                            \
	do {                                                                   \
		output = *(ptr) << 8;                                          \
		output |= *((ptr) + 1);                                        \
	} while (0)

struct gm_join {
	pim_addr group_addr;
	pim_addr source_addr;
	int sock_fd;
	time_t sock_creation;
};

struct gm_sock {
	int fd;
	struct interface *interface;
	pim_addr ifaddr;
	time_t sock_creation;

	struct thread *t_igmp_read; /* read: IGMP sockets */
	struct thread
		*t_igmp_query_timer; /* timer: issue IGMP general queries */
	struct thread *t_other_querier_timer; /* timer: other querier present */
	pim_addr querier_addr;		      /* IP address of the querier */
	int querier_query_interval;	   /* QQI */
	int querier_robustness_variable; /* QRV */
	int startup_query_count;

	bool mtrace_only;

	struct igmp_stats igmp_stats;
};

struct pim_interface;

#if PIM_IPV == 4
void pim_igmp_if_init(struct pim_interface *pim_ifp, struct interface *ifp);
void pim_igmp_if_reset(struct pim_interface *pim_ifp);
void pim_igmp_if_fini(struct pim_interface *pim_ifp);

struct gm_sock *pim_igmp_sock_lookup_ifaddr(struct list *igmp_sock_list,
					    struct in_addr ifaddr);
struct gm_sock *pim_igmp_sock_add(struct list *igmp_sock_list,
				  struct in_addr ifaddr, struct interface *ifp,
				  bool mtrace_only);
void igmp_sock_delete(struct gm_sock *igmp);
void igmp_sock_free(struct gm_sock *igmp);
void igmp_sock_delete_all(struct interface *ifp);
int pim_igmp_packet(struct gm_sock *igmp, char *buf, size_t len);
bool pim_igmp_verify_header(struct ip *ip_hdr, size_t len, size_t *ip_hlen);
void pim_igmp_general_query_on(struct gm_sock *igmp);
void pim_igmp_general_query_off(struct gm_sock *igmp);
void pim_igmp_other_querier_timer_on(struct gm_sock *igmp);
void pim_igmp_other_querier_timer_off(struct gm_sock *igmp);

int igmp_validate_checksum(char *igmp_msg, int igmp_msg_len);

#else /* PIM_IPV != 4 */
static inline void pim_igmp_if_init(struct pim_interface *pim_ifp,
				    struct interface *ifp)
{
}

static inline void pim_igmp_if_fini(struct pim_interface *pim_ifp)
{
}

static inline void pim_igmp_general_query_on(struct gm_sock *igmp)
{
}

static inline void pim_igmp_general_query_off(struct gm_sock *igmp)
{
}

static inline void pim_igmp_other_querier_timer_on(struct gm_sock *igmp)
{
}

static inline void pim_igmp_other_querier_timer_off(struct gm_sock *igmp)
{
}
#endif /* PIM_IPV == 4 */

#define IGMP_SOURCE_MASK_FORWARDING        (1 << 0)
#define IGMP_SOURCE_MASK_DELETE            (1 << 1)
#define IGMP_SOURCE_MASK_SEND              (1 << 2)
#define IGMP_SOURCE_TEST_FORWARDING(flags) ((flags) & IGMP_SOURCE_MASK_FORWARDING)
#define IGMP_SOURCE_TEST_DELETE(flags)     ((flags) & IGMP_SOURCE_MASK_DELETE)
#define IGMP_SOURCE_TEST_SEND(flags)       ((flags) & IGMP_SOURCE_MASK_SEND)
#define IGMP_SOURCE_DO_FORWARDING(flags)   ((flags) |= IGMP_SOURCE_MASK_FORWARDING)
#define IGMP_SOURCE_DO_DELETE(flags)       ((flags) |= IGMP_SOURCE_MASK_DELETE)
#define IGMP_SOURCE_DO_SEND(flags)         ((flags) |= IGMP_SOURCE_MASK_SEND)
#define IGMP_SOURCE_DONT_FORWARDING(flags) ((flags) &= ~IGMP_SOURCE_MASK_FORWARDING)
#define IGMP_SOURCE_DONT_DELETE(flags)     ((flags) &= ~IGMP_SOURCE_MASK_DELETE)
#define IGMP_SOURCE_DONT_SEND(flags)       ((flags) &= ~IGMP_SOURCE_MASK_SEND)

struct gm_source {
	pim_addr source_addr;
	struct thread *t_source_timer;
	struct gm_group *source_group; /* back pointer */
	time_t source_creation;
	uint32_t source_flags;
	struct channel_oil *source_channel_oil;

	/*
	  RFC 3376: 6.6.3.2. Building and Sending Group and Source Specific
	  Queries
	*/
	int source_query_retransmit_count;
};

struct gm_group {
	/*
	  RFC 3376: 6.2.2. Definition of Group Timers

	  The group timer is only used when a group is in EXCLUDE mode and it
	  represents the time for the *filter-mode* of the group to expire and
	  switch to INCLUDE mode.
	*/
	struct thread *t_group_timer;

	/* Shared between group-specific and
	   group-and-source-specific retransmissions */
	struct thread *t_group_query_retransmit_timer;

	/* Counter exclusive for group-specific retransmissions
	   (not used by group-and-source-specific retransmissions,
	   since sources have their counters) */
	int group_specific_query_retransmit_count;

	/* compatibility mode - igmp v1, v2 or v3 */
	int igmp_version;
	pim_addr group_addr;
	int group_filtermode_isexcl;    /* 0=INCLUDE, 1=EXCLUDE */
	struct list *group_source_list; /* list of struct gm_source */
	time_t group_creation;
	struct interface *interface;
	int64_t last_igmp_v1_report_dsec;
	int64_t last_igmp_v2_report_dsec;
};

#if PIM_IPV == 4
struct pim_instance;

void igmp_anysource_forward_start(struct pim_instance *pim,
				  struct gm_group *group);
void igmp_anysource_forward_stop(struct gm_group *group);

void igmp_source_forward_start(struct pim_instance *pim,
			       struct gm_source *source);
void igmp_source_forward_stop(struct gm_source *source);
void igmp_source_forward_reevaluate_all(struct pim_instance *pim);

struct gm_group *find_group_by_addr(struct gm_sock *igmp,
				    struct in_addr group_addr);
struct gm_group *igmp_add_group_by_addr(struct gm_sock *igmp,
					struct in_addr group_addr);

struct gm_source *igmp_get_source_by_addr(struct gm_group *group,
					  struct in_addr src_addr,
					  bool *created);

void igmp_group_delete_empty_include(struct gm_group *group);

void igmp_startup_mode_on(struct gm_sock *igmp);

void igmp_group_timer_on(struct gm_group *group, long interval_msec,
			 const char *ifname);

void igmp_send_query(int igmp_version, struct gm_group *group, char *query_buf,
		     int query_buf_size, int num_sources,
		     struct in_addr dst_addr, struct in_addr group_addr,
		     int query_max_response_time_dsec, uint8_t s_flag,
		     struct gm_sock *igmp);
void igmp_group_delete(struct gm_group *group);

void igmp_send_query_on_intf(struct interface *ifp, int igmp_ver);

#else /* PIM_IPV != 4 */
static inline void igmp_startup_mode_on(struct gm_sock *igmp)
{
}
#endif /* PIM_IPV != 4 */

#endif /* PIM_IGMP_H */
Commit	Line	Data
12e41d03	1	/*
896014f4 DL	2	* PIM for Quagga
	3	* Copyright (C) 2008 Everton da Silva Marques
	4	*
	5	* This program is free software; you can redistribute it and/or modify
	6	* it under the terms of the GNU General Public License as published by
	7	* the Free Software Foundation; either version 2 of the License, or
	8	* (at your option) any later version.
	9	*
	10	* This program is distributed in the hope that it will be useful, but
	11	* WITHOUT ANY WARRANTY; without even the implied warranty of
	12	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	13	* General Public License for more details.
	14	*
	15	* You should have received a copy of the GNU General Public License along
	16	* with this program; see the file COPYING; if not, write to the Free Software
	17	* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
	18	*/
12e41d03 DL	19
	20	#ifndef PIM_IGMP_H
	21	#define PIM_IGMP_H
	22
	23	#include <netinet/in.h>
	24
	25	#include <zebra.h>
	26	#include "vty.h"
	27	#include "linklist.h"
21313cbf	28	#include "pim_igmp_stats.h"
5e8d3f4f	29	#include "pim_str.h"
12e41d03 DL	30
	31	/*
	32	The following sizes are likely to support
	33	any message sent within local MTU.
	34	*/
	35	#define PIM_IGMP_BUFSIZE_READ (20000)
	36	#define PIM_IGMP_BUFSIZE_WRITE (20000)
	37
	38	#define PIM_IGMP_MEMBERSHIP_QUERY (0x11)
	39	#define PIM_IGMP_V1_MEMBERSHIP_REPORT (0x12)
	40	#define PIM_IGMP_V2_MEMBERSHIP_REPORT (0x16)
	41	#define PIM_IGMP_V2_LEAVE_GROUP (0x17)
4d9ad5dc MS	42	#define PIM_IGMP_MTRACE_RESPONSE (0x1E)
4d9ad5dc MS	43	#define PIM_IGMP_MTRACE_QUERY_REQUEST (0x1F)
12e41d03 DL	44	#define PIM_IGMP_V3_MEMBERSHIP_REPORT (0x22)
	45
	46	#define IGMP_V3_REPORT_HEADER_SIZE (8)
	47	#define IGMP_V3_GROUP_RECORD_MIN_SIZE (8)
d62a17ae	48	#define IGMP_V3_MSG_MIN_SIZE \
d62a17ae	49	(IGMP_V3_REPORT_HEADER_SIZE + IGMP_V3_GROUP_RECORD_MIN_SIZE)
12e41d03 DL	50	#define IGMP_V12_MSG_SIZE (8)
	51
	52	#define IGMP_V3_GROUP_RECORD_TYPE_OFFSET (0)
	53	#define IGMP_V3_GROUP_RECORD_AUXDATALEN_OFFSET (1)
	54	#define IGMP_V3_GROUP_RECORD_NUMSOURCES_OFFSET (2)
	55	#define IGMP_V3_GROUP_RECORD_GROUP_OFFSET (4)
	56	#define IGMP_V3_GROUP_RECORD_SOURCE_OFFSET (8)
b05b72e8	57	#define IGMP_CHECKSUM_OFFSET (2)
12e41d03	58
b05b72e8 DW	59	#define IGMP_DEFAULT_VERSION (3)
b05b72e8 DW	60
9041c30a MR	61	#define IGMP_GET_INT16(ptr, output) \
	62	do { \
	63	output = *(ptr) << 8; \
	64	output \|= *((ptr) + 1); \
	65	} while (0)
	66
7caa9451	67	struct gm_join {
5e8d3f4f MR	68	pim_addr group_addr;
5e8d3f4f MR	69	pim_addr source_addr;
d62a17ae	70	int sock_fd;
d62a17ae	71	time_t sock_creation;
12e41d03 DL	72	};
12e41d03 DL	73
c5f76fad	74	struct gm_sock {
d62a17ae	75	int fd;
d62a17ae	76	struct interface *interface;
ca7613e2	77	pim_addr ifaddr;
d62a17ae	78	time_t sock_creation;
	79
	80	struct thread t_igmp_read; / read: IGMP sockets */
	81	struct thread
	82	t_igmp_query_timer; / timer: issue IGMP general queries */
	83	struct thread t_other_querier_timer; / timer: other querier present */
ca7613e2	84	pim_addr querier_addr; /* IP address of the querier */
9a7cee26	85	int querier_query_interval; /* QQI */
d62a17ae	86	int querier_robustness_variable; /* QRV */
	87	int startup_query_count;
	88
f83f3966 MS	89	bool mtrace_only;
f83f3966 MS	90
f2058cb4	91	struct igmp_stats igmp_stats;
12e41d03 DL	92	};
12e41d03 DL	93
dda4d23c DL	94	struct pim_interface;
dda4d23c DL	95
5a46a3de	96	#if PIM_IPV == 4
dda4d23c DL	97	void pim_igmp_if_init(struct pim_interface pim_ifp, struct interface ifp);
	98	void pim_igmp_if_reset(struct pim_interface *pim_ifp);
	99	void pim_igmp_if_fini(struct pim_interface *pim_ifp);
	100
c5f76fad SG	101	struct gm_sock pim_igmp_sock_lookup_ifaddr(struct list igmp_sock_list,
	102	struct in_addr ifaddr);
	103	struct gm_sock pim_igmp_sock_add(struct list igmp_sock_list,
	104	struct in_addr ifaddr, struct interface *ifp,
	105	bool mtrace_only);
	106	void igmp_sock_delete(struct gm_sock *igmp);
	107	void igmp_sock_free(struct gm_sock *igmp);
d62a17ae	108	void igmp_sock_delete_all(struct interface *ifp);
c5f76fad	109	int pim_igmp_packet(struct gm_sock igmp, char buf, size_t len);
88ea79ad	110	bool pim_igmp_verify_header(struct ip ip_hdr, size_t len, size_t ip_hlen);
c5f76fad SG	111	void pim_igmp_general_query_on(struct gm_sock *igmp);
	112	void pim_igmp_general_query_off(struct gm_sock *igmp);
	113	void pim_igmp_other_querier_timer_on(struct gm_sock *igmp);
	114	void pim_igmp_other_querier_timer_off(struct gm_sock *igmp);
12e41d03	115
9041c30a MR	116	int igmp_validate_checksum(char *igmp_msg, int igmp_msg_len);
9041c30a MR	117
5a46a3de	118	#else /* PIM_IPV != 4 */
97feb13f DL	119	static inline void pim_igmp_if_init(struct pim_interface *pim_ifp,
	120	struct interface *ifp)
	121	{
	122	}
	123
	124	static inline void pim_igmp_if_fini(struct pim_interface *pim_ifp)
	125	{
	126	}
	127
5a46a3de DL	128	static inline void pim_igmp_general_query_on(struct gm_sock *igmp)
	129	{
	130	}
	131
	132	static inline void pim_igmp_general_query_off(struct gm_sock *igmp)
	133	{
	134	}
	135
	136	static inline void pim_igmp_other_querier_timer_on(struct gm_sock *igmp)
	137	{
	138	}
	139
	140	static inline void pim_igmp_other_querier_timer_off(struct gm_sock *igmp)
	141	{
	142	}
	143	#endif /* PIM_IPV == 4 */
	144
12e41d03 DL	145	#define IGMP_SOURCE_MASK_FORWARDING (1 << 0)
	146	#define IGMP_SOURCE_MASK_DELETE (1 << 1)
	147	#define IGMP_SOURCE_MASK_SEND (1 << 2)
	148	#define IGMP_SOURCE_TEST_FORWARDING(flags) ((flags) & IGMP_SOURCE_MASK_FORWARDING)
	149	#define IGMP_SOURCE_TEST_DELETE(flags) ((flags) & IGMP_SOURCE_MASK_DELETE)
	150	#define IGMP_SOURCE_TEST_SEND(flags) ((flags) & IGMP_SOURCE_MASK_SEND)
	151	#define IGMP_SOURCE_DO_FORWARDING(flags) ((flags) \|= IGMP_SOURCE_MASK_FORWARDING)
	152	#define IGMP_SOURCE_DO_DELETE(flags) ((flags) \|= IGMP_SOURCE_MASK_DELETE)
	153	#define IGMP_SOURCE_DO_SEND(flags) ((flags) \|= IGMP_SOURCE_MASK_SEND)
	154	#define IGMP_SOURCE_DONT_FORWARDING(flags) ((flags) &= ~IGMP_SOURCE_MASK_FORWARDING)
	155	#define IGMP_SOURCE_DONT_DELETE(flags) ((flags) &= ~IGMP_SOURCE_MASK_DELETE)
	156	#define IGMP_SOURCE_DONT_SEND(flags) ((flags) &= ~IGMP_SOURCE_MASK_SEND)
	157
51700107	158	struct gm_source {
b050b030	159	pim_addr source_addr;
d62a17ae	160	struct thread *t_source_timer;
a16db099	161	struct gm_group source_group; / back pointer */
d62a17ae	162	time_t source_creation;
	163	uint32_t source_flags;
	164	struct channel_oil *source_channel_oil;
	165
	166	/*
	167	RFC 3376: 6.6.3.2. Building and Sending Group and Source Specific
	168	Queries
	169	*/
	170	int source_query_retransmit_count;
12e41d03 DL	171	};
12e41d03 DL	172
a16db099	173	struct gm_group {
d62a17ae	174	/*
	175	RFC 3376: 6.2.2. Definition of Group Timers
	176
	177	The group timer is only used when a group is in EXCLUDE mode and it
	178	represents the time for the filter-mode of the group to expire and
	179	switch to INCLUDE mode.
	180	*/
	181	struct thread *t_group_timer;
	182
	183	/* Shared between group-specific and
	184	group-and-source-specific retransmissions */
	185	struct thread *t_group_query_retransmit_timer;
	186
	187	/* Counter exclusive for group-specific retransmissions
	188	(not used by group-and-source-specific retransmissions,
	189	since sources have their counters) */
	190	int group_specific_query_retransmit_count;
	191
	192	/* compatibility mode - igmp v1, v2 or v3 */
	193	int igmp_version;
d1257ae9	194	pim_addr group_addr;
d62a17ae	195	int group_filtermode_isexcl; /* 0=INCLUDE, 1=EXCLUDE */
51700107	196	struct list group_source_list; / list of struct gm_source */
d62a17ae	197	time_t group_creation;
dda4d23c	198	struct interface *interface;
d62a17ae	199	int64_t last_igmp_v1_report_dsec;
d62a17ae	200	int64_t last_igmp_v2_report_dsec;
12e41d03 DL	201	};
12e41d03 DL	202
5a46a3de	203	#if PIM_IPV == 4
cd6d2858 DL	204	struct pim_instance;
	205
	206	void igmp_anysource_forward_start(struct pim_instance *pim,
	207	struct gm_group *group);
	208	void igmp_anysource_forward_stop(struct gm_group *group);
	209
	210	void igmp_source_forward_start(struct pim_instance *pim,
	211	struct gm_source *source);
	212	void igmp_source_forward_stop(struct gm_source *source);
	213	void igmp_source_forward_reevaluate_all(struct pim_instance *pim);
	214
c5f76fad	215	struct gm_group find_group_by_addr(struct gm_sock igmp,
a16db099	216	struct in_addr group_addr);
c5f76fad	217	struct gm_group igmp_add_group_by_addr(struct gm_sock igmp,
a16db099	218	struct in_addr group_addr);
12e41d03	219
a16db099 SG	220	struct gm_source igmp_get_source_by_addr(struct gm_group group,
	221	struct in_addr src_addr,
	222	bool *created);
5421bf8f	223
a16db099	224	void igmp_group_delete_empty_include(struct gm_group *group);
12e41d03	225
c5f76fad	226	void igmp_startup_mode_on(struct gm_sock *igmp);
12e41d03	227
a16db099	228	void igmp_group_timer_on(struct gm_group *group, long interval_msec,
d62a17ae	229	const char *ifname);
d62a17ae	230
278912ea DA	231	void igmp_send_query(int igmp_version, struct gm_group group, char query_buf,
	232	int query_buf_size, int num_sources,
	233	struct in_addr dst_addr, struct in_addr group_addr,
d62a17ae	234	int query_max_response_time_dsec, uint8_t s_flag,
278912ea	235	struct gm_sock *igmp);
a16db099	236	void igmp_group_delete(struct gm_group *group);
6741a5bb	237
6741a5bb	238	void igmp_send_query_on_intf(struct interface *ifp, int igmp_ver);
5a46a3de DL	239
	240	#else /* PIM_IPV != 4 */
	241	static inline void igmp_startup_mode_on(struct gm_sock *igmp)
	242	{
	243	}
	244	#endif /* PIM_IPV != 4 */
	245
12e41d03	246	#endif /* PIM_IGMP_H */