[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"

/*
  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_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)

/* RFC 3376: 8.1. Robustness Variable - Default: 2 */
#define IGMP_DEFAULT_ROBUSTNESS_VARIABLE           (2)

/* RFC 3376: 8.2. Query Interval - Default: 125 seconds */
#define IGMP_GENERAL_QUERY_INTERVAL                (125)

/* RFC 3376: 8.3. Query Response Interval - Default: 100 deciseconds */
#define IGMP_QUERY_MAX_RESPONSE_TIME_DSEC          (100)

/* RFC 3376: 8.8. Last Member Query Interval - Default: 10 deciseconds */
#define IGMP_SPECIFIC_QUERY_MAX_RESPONSE_TIME_DSEC (10)

#define IGMP_DEFAULT_VERSION (3)

struct igmp_join {
	struct in_addr group_addr;
	struct in_addr source_addr;
	int sock_fd;
	time_t sock_creation;
};

struct igmp_sock {
	int fd;
	struct interface *interface;
	struct in_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 */

	int querier_query_interval;      /* QQI */
	int querier_robustness_variable; /* QRV */
	int startup_query_count;

	struct list *igmp_group_list; /* list of struct igmp_group */
	struct hash *igmp_group_hash;
};

struct igmp_sock *pim_igmp_sock_lookup_ifaddr(struct list *igmp_sock_list,
					      struct in_addr ifaddr);
struct igmp_sock *igmp_sock_lookup_by_fd(struct list *igmp_sock_list, int fd);
struct igmp_sock *pim_igmp_sock_add(struct list *igmp_sock_list,
				    struct in_addr ifaddr,
				    struct interface *ifp);
void igmp_sock_delete(struct igmp_sock *igmp);
void igmp_sock_free(struct igmp_sock *igmp);
void igmp_sock_delete_all(struct interface *ifp);
int pim_igmp_packet(struct igmp_sock *igmp, char *buf, size_t len);

void pim_igmp_general_query_on(struct igmp_sock *igmp);
void pim_igmp_general_query_off(struct igmp_sock *igmp);
void pim_igmp_other_querier_timer_on(struct igmp_sock *igmp);
void pim_igmp_other_querier_timer_off(struct igmp_sock *igmp);

#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 igmp_source {
	struct in_addr source_addr;
	struct thread *t_source_timer;
	struct igmp_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 igmp_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;

	struct in_addr group_addr;
	int group_filtermode_isexcl;    /* 0=INCLUDE, 1=EXCLUDE */
	struct list *group_source_list; /* list of struct igmp_source */
	time_t group_creation;
	struct igmp_sock *group_igmp_sock; /* back pointer */
	int64_t last_igmp_v1_report_dsec;
	int64_t last_igmp_v2_report_dsec;
};

struct igmp_group *find_group_by_addr(struct igmp_sock *igmp,
				      struct in_addr group_addr);
struct igmp_group *igmp_add_group_by_addr(struct igmp_sock *igmp,
					  struct in_addr group_addr);

void igmp_group_delete_empty_include(struct igmp_group *group);

void igmp_startup_mode_on(struct igmp_sock *igmp);

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

struct igmp_source *source_new(struct igmp_group *group,
			       struct in_addr src_addr);

void igmp_send_query(int igmp_version, struct igmp_group *group, int fd,
		     const char *ifname, 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,
		     uint8_t querier_robustness_variable,
		     uint16_t querier_query_interval);
#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"
	28
	29	/*
	30	The following sizes are likely to support
	31	any message sent within local MTU.
	32	*/
	33	#define PIM_IGMP_BUFSIZE_READ (20000)
	34	#define PIM_IGMP_BUFSIZE_WRITE (20000)
	35
	36	#define PIM_IGMP_MEMBERSHIP_QUERY (0x11)
	37	#define PIM_IGMP_V1_MEMBERSHIP_REPORT (0x12)
	38	#define PIM_IGMP_V2_MEMBERSHIP_REPORT (0x16)
	39	#define PIM_IGMP_V2_LEAVE_GROUP (0x17)
	40	#define PIM_IGMP_V3_MEMBERSHIP_REPORT (0x22)
	41
	42	#define IGMP_V3_REPORT_HEADER_SIZE (8)
	43	#define IGMP_V3_GROUP_RECORD_MIN_SIZE (8)
d62a17ae	44	#define IGMP_V3_MSG_MIN_SIZE \
d62a17ae	45	(IGMP_V3_REPORT_HEADER_SIZE + IGMP_V3_GROUP_RECORD_MIN_SIZE)
12e41d03 DL	46	#define IGMP_V12_MSG_SIZE (8)
	47
	48	#define IGMP_V3_GROUP_RECORD_TYPE_OFFSET (0)
	49	#define IGMP_V3_GROUP_RECORD_AUXDATALEN_OFFSET (1)
	50	#define IGMP_V3_GROUP_RECORD_NUMSOURCES_OFFSET (2)
	51	#define IGMP_V3_GROUP_RECORD_GROUP_OFFSET (4)
	52	#define IGMP_V3_GROUP_RECORD_SOURCE_OFFSET (8)
b05b72e8	53	#define IGMP_CHECKSUM_OFFSET (2)
12e41d03 DL	54
	55	/* RFC 3376: 8.1. Robustness Variable - Default: 2 */
	56	#define IGMP_DEFAULT_ROBUSTNESS_VARIABLE (2)
	57
	58	/* RFC 3376: 8.2. Query Interval - Default: 125 seconds */
	59	#define IGMP_GENERAL_QUERY_INTERVAL (125)
	60
	61	/* RFC 3376: 8.3. Query Response Interval - Default: 100 deciseconds */
	62	#define IGMP_QUERY_MAX_RESPONSE_TIME_DSEC (100)
	63
	64	/* RFC 3376: 8.8. Last Member Query Interval - Default: 10 deciseconds */
	65	#define IGMP_SPECIFIC_QUERY_MAX_RESPONSE_TIME_DSEC (10)
	66
b05b72e8 DW	67	#define IGMP_DEFAULT_VERSION (3)
b05b72e8 DW	68
12e41d03	69	struct igmp_join {
d62a17ae	70	struct in_addr group_addr;
	71	struct in_addr source_addr;
	72	int sock_fd;
	73	time_t sock_creation;
12e41d03 DL	74	};
	75
	76	struct igmp_sock {
d62a17ae	77	int fd;
	78	struct interface *interface;
	79	struct in_addr ifaddr;
	80	time_t sock_creation;
	81
	82	struct thread t_igmp_read; / read: IGMP sockets */
	83	struct thread
	84	t_igmp_query_timer; / timer: issue IGMP general queries */
	85	struct thread t_other_querier_timer; / timer: other querier present */
	86
	87	int querier_query_interval; /* QQI */
	88	int querier_robustness_variable; /* QRV */
	89	int startup_query_count;
	90
	91	struct list igmp_group_list; / list of struct igmp_group */
	92	struct hash *igmp_group_hash;
12e41d03 DL	93	};
	94
	95	struct igmp_sock pim_igmp_sock_lookup_ifaddr(struct list igmp_sock_list,
	96	struct in_addr ifaddr);
d62a17ae	97	struct igmp_sock igmp_sock_lookup_by_fd(struct list igmp_sock_list, int fd);
12e41d03 DL	98	struct igmp_sock pim_igmp_sock_add(struct list igmp_sock_list,
	99	struct in_addr ifaddr,
	100	struct interface *ifp);
	101	void igmp_sock_delete(struct igmp_sock *igmp);
	102	void igmp_sock_free(struct igmp_sock *igmp);
d62a17ae	103	void igmp_sock_delete_all(struct interface *ifp);
12e41d03 DL	104	int pim_igmp_packet(struct igmp_sock igmp, char buf, size_t len);
	105
	106	void pim_igmp_general_query_on(struct igmp_sock *igmp);
	107	void pim_igmp_general_query_off(struct igmp_sock *igmp);
	108	void pim_igmp_other_querier_timer_on(struct igmp_sock *igmp);
	109	void pim_igmp_other_querier_timer_off(struct igmp_sock *igmp);
	110
	111	#define IGMP_SOURCE_MASK_FORWARDING (1 << 0)
	112	#define IGMP_SOURCE_MASK_DELETE (1 << 1)
	113	#define IGMP_SOURCE_MASK_SEND (1 << 2)
	114	#define IGMP_SOURCE_TEST_FORWARDING(flags) ((flags) & IGMP_SOURCE_MASK_FORWARDING)
	115	#define IGMP_SOURCE_TEST_DELETE(flags) ((flags) & IGMP_SOURCE_MASK_DELETE)
	116	#define IGMP_SOURCE_TEST_SEND(flags) ((flags) & IGMP_SOURCE_MASK_SEND)
	117	#define IGMP_SOURCE_DO_FORWARDING(flags) ((flags) \|= IGMP_SOURCE_MASK_FORWARDING)
	118	#define IGMP_SOURCE_DO_DELETE(flags) ((flags) \|= IGMP_SOURCE_MASK_DELETE)
	119	#define IGMP_SOURCE_DO_SEND(flags) ((flags) \|= IGMP_SOURCE_MASK_SEND)
	120	#define IGMP_SOURCE_DONT_FORWARDING(flags) ((flags) &= ~IGMP_SOURCE_MASK_FORWARDING)
	121	#define IGMP_SOURCE_DONT_DELETE(flags) ((flags) &= ~IGMP_SOURCE_MASK_DELETE)
	122	#define IGMP_SOURCE_DONT_SEND(flags) ((flags) &= ~IGMP_SOURCE_MASK_SEND)
	123
	124	struct igmp_source {
d62a17ae	125	struct in_addr source_addr;
	126	struct thread *t_source_timer;
	127	struct igmp_group source_group; / back pointer */
	128	time_t source_creation;
	129	uint32_t source_flags;
	130	struct channel_oil *source_channel_oil;
	131
	132	/*
	133	RFC 3376: 6.6.3.2. Building and Sending Group and Source Specific
	134	Queries
	135	*/
	136	int source_query_retransmit_count;
12e41d03 DL	137	};
	138
	139	struct igmp_group {
d62a17ae	140	/*
	141	RFC 3376: 6.2.2. Definition of Group Timers
	142
	143	The group timer is only used when a group is in EXCLUDE mode and it
	144	represents the time for the filter-mode of the group to expire and
	145	switch to INCLUDE mode.
	146	*/
	147	struct thread *t_group_timer;
	148
	149	/* Shared between group-specific and
	150	group-and-source-specific retransmissions */
	151	struct thread *t_group_query_retransmit_timer;
	152
	153	/* Counter exclusive for group-specific retransmissions
	154	(not used by group-and-source-specific retransmissions,
	155	since sources have their counters) */
	156	int group_specific_query_retransmit_count;
	157
	158	/* compatibility mode - igmp v1, v2 or v3 */
	159	int igmp_version;
	160
	161	struct in_addr group_addr;
	162	int group_filtermode_isexcl; /* 0=INCLUDE, 1=EXCLUDE */
	163	struct list group_source_list; / list of struct igmp_source */
	164	time_t group_creation;
	165	struct igmp_sock group_igmp_sock; / back pointer */
	166	int64_t last_igmp_v1_report_dsec;
	167	int64_t last_igmp_v2_report_dsec;
12e41d03 DL	168	};
12e41d03 DL	169
d62a17ae	170	struct igmp_group find_group_by_addr(struct igmp_sock igmp,
d62a17ae	171	struct in_addr group_addr);
12e41d03	172	struct igmp_group igmp_add_group_by_addr(struct igmp_sock igmp,
915c13b3	173	struct in_addr group_addr);
12e41d03 DL	174
	175	void igmp_group_delete_empty_include(struct igmp_group *group);
	176
	177	void igmp_startup_mode_on(struct igmp_sock *igmp);
	178
d62a17ae	179	void igmp_group_timer_on(struct igmp_group *group, long interval_msec,
	180	const char *ifname);
	181
	182	struct igmp_source source_new(struct igmp_group group,
	183	struct in_addr src_addr);
	184
	185	void igmp_send_query(int igmp_version, struct igmp_group *group, int fd,
	186	const char ifname, char query_buf, int query_buf_size,
	187	int num_sources, struct in_addr dst_addr,
	188	struct in_addr group_addr,
	189	int query_max_response_time_dsec, uint8_t s_flag,
	190	uint8_t querier_robustness_variable,
	191	uint16_t querier_query_interval);
12e41d03	192	#endif /* PIM_IGMP_H */