xref: /linux-6.15/include/linux/igmp.h (revision ba6e8564)
1 /*
2  *	Linux NET3:	Internet Group Management Protocol  [IGMP]
3  *
4  *	Authors:
5  *		Alan Cox <[email protected]>
6  *
7  *	Extended to talk the BSD extended IGMP protocol of mrouted 3.6
8  *
9  *
10  *	This program is free software; you can redistribute it and/or
11  *	modify it under the terms of the GNU General Public License
12  *	as published by the Free Software Foundation; either version
13  *	2 of the License, or (at your option) any later version.
14  */
15 
16 #ifndef _LINUX_IGMP_H
17 #define _LINUX_IGMP_H
18 
19 #include <asm/byteorder.h>
20 
21 /*
22  *	IGMP protocol structures
23  */
24 
25 /*
26  *	Header in on cable format
27  */
28 
29 struct igmphdr
30 {
31 	__u8 type;
32 	__u8 code;		/* For newer IGMP */
33 	__sum16 csum;
34 	__be32 group;
35 };
36 
37 /* V3 group record types [grec_type] */
38 #define IGMPV3_MODE_IS_INCLUDE		1
39 #define IGMPV3_MODE_IS_EXCLUDE		2
40 #define IGMPV3_CHANGE_TO_INCLUDE	3
41 #define IGMPV3_CHANGE_TO_EXCLUDE	4
42 #define IGMPV3_ALLOW_NEW_SOURCES	5
43 #define IGMPV3_BLOCK_OLD_SOURCES	6
44 
45 struct igmpv3_grec {
46 	__u8	grec_type;
47 	__u8	grec_auxwords;
48 	__be16	grec_nsrcs;
49 	__be32	grec_mca;
50 	__be32	grec_src[0];
51 };
52 
53 struct igmpv3_report {
54 	__u8 type;
55 	__u8 resv1;
56 	__be16 csum;
57 	__be16 resv2;
58 	__be16 ngrec;
59 	struct igmpv3_grec grec[0];
60 };
61 
62 struct igmpv3_query {
63 	__u8 type;
64 	__u8 code;
65 	__be16 csum;
66 	__be32 group;
67 #if defined(__LITTLE_ENDIAN_BITFIELD)
68 	__u8 qrv:3,
69 	     suppress:1,
70 	     resv:4;
71 #elif defined(__BIG_ENDIAN_BITFIELD)
72 	__u8 resv:4,
73 	     suppress:1,
74 	     qrv:3;
75 #else
76 #error "Please fix <asm/byteorder.h>"
77 #endif
78 	__u8 qqic;
79 	__be16 nsrcs;
80 	__be32 srcs[0];
81 };
82 
83 #define IGMP_HOST_MEMBERSHIP_QUERY	0x11	/* From RFC1112 */
84 #define IGMP_HOST_MEMBERSHIP_REPORT	0x12	/* Ditto */
85 #define IGMP_DVMRP			0x13	/* DVMRP routing */
86 #define IGMP_PIM			0x14	/* PIM routing */
87 #define IGMP_TRACE			0x15
88 #define IGMPV2_HOST_MEMBERSHIP_REPORT	0x16	/* V2 version of 0x11 */
89 #define IGMP_HOST_LEAVE_MESSAGE 	0x17
90 #define IGMPV3_HOST_MEMBERSHIP_REPORT	0x22	/* V3 version of 0x11 */
91 
92 #define IGMP_MTRACE_RESP		0x1e
93 #define IGMP_MTRACE			0x1f
94 
95 
96 /*
97  *	Use the BSD names for these for compatibility
98  */
99 
100 #define IGMP_DELAYING_MEMBER		0x01
101 #define IGMP_IDLE_MEMBER		0x02
102 #define IGMP_LAZY_MEMBER		0x03
103 #define IGMP_SLEEPING_MEMBER		0x04
104 #define IGMP_AWAKENING_MEMBER		0x05
105 
106 #define IGMP_MINLEN			8
107 
108 #define IGMP_MAX_HOST_REPORT_DELAY	10	/* max delay for response to */
109 						/* query (in seconds)	*/
110 
111 #define IGMP_TIMER_SCALE		10	/* denotes that the igmphdr->timer field */
112 						/* specifies time in 10th of seconds	 */
113 
114 #define IGMP_AGE_THRESHOLD		400	/* If this host don't hear any IGMP V1	*/
115 						/* message in this period of time,	*/
116 						/* revert to IGMP v2 router.		*/
117 
118 #define IGMP_ALL_HOSTS		htonl(0xE0000001L)
119 #define IGMP_ALL_ROUTER 	htonl(0xE0000002L)
120 #define IGMPV3_ALL_MCR	 	htonl(0xE0000016L)
121 #define IGMP_LOCAL_GROUP	htonl(0xE0000000L)
122 #define IGMP_LOCAL_GROUP_MASK	htonl(0xFFFFFF00L)
123 
124 /*
125  * struct for keeping the multicast list in
126  */
127 
128 #ifdef __KERNEL__
129 #include <linux/skbuff.h>
130 #include <linux/timer.h>
131 #include <linux/in.h>
132 
133 extern int sysctl_igmp_max_memberships;
134 extern int sysctl_igmp_max_msf;
135 
136 struct ip_sf_socklist
137 {
138 	unsigned int		sl_max;
139 	unsigned int		sl_count;
140 	__be32			sl_addr[0];
141 };
142 
143 #define IP_SFLSIZE(count)	(sizeof(struct ip_sf_socklist) + \
144 	(count) * sizeof(__be32))
145 
146 #define IP_SFBLOCK	10	/* allocate this many at once */
147 
148 /* ip_mc_socklist is real list now. Speed is not argument;
149    this list never used in fast path code
150  */
151 
152 struct ip_mc_socklist
153 {
154 	struct ip_mc_socklist	*next;
155 	struct ip_mreqn		multi;
156 	unsigned int		sfmode;		/* MCAST_{INCLUDE,EXCLUDE} */
157 	struct ip_sf_socklist	*sflist;
158 };
159 
160 struct ip_sf_list
161 {
162 	struct ip_sf_list	*sf_next;
163 	__be32			sf_inaddr;
164 	unsigned long		sf_count[2];	/* include/exclude counts */
165 	unsigned char		sf_gsresp;	/* include in g & s response? */
166 	unsigned char		sf_oldin;	/* change state */
167 	unsigned char		sf_crcount;	/* retrans. left to send */
168 };
169 
170 struct ip_mc_list
171 {
172 	struct in_device	*interface;
173 	__be32			multiaddr;
174 	struct ip_sf_list	*sources;
175 	struct ip_sf_list	*tomb;
176 	unsigned int		sfmode;
177 	unsigned long		sfcount[2];
178 	struct ip_mc_list	*next;
179 	struct timer_list	timer;
180 	int			users;
181 	atomic_t		refcnt;
182 	spinlock_t		lock;
183 	char			tm_running;
184 	char			reporter;
185 	char			unsolicit_count;
186 	char			loaded;
187 	unsigned char		gsquery;	/* check source marks? */
188 	unsigned char		crcount;
189 };
190 
191 /* V3 exponential field decoding */
192 #define IGMPV3_MASK(value, nb) ((nb)>=32 ? (value) : ((1<<(nb))-1) & (value))
193 #define IGMPV3_EXP(thresh, nbmant, nbexp, value) \
194 	((value) < (thresh) ? (value) : \
195         ((IGMPV3_MASK(value, nbmant) | (1<<(nbmant))) << \
196          (IGMPV3_MASK((value) >> (nbmant), nbexp) + (nbexp))))
197 
198 #define IGMPV3_QQIC(value) IGMPV3_EXP(0x80, 4, 3, value)
199 #define IGMPV3_MRC(value) IGMPV3_EXP(0x80, 4, 3, value)
200 
201 extern int ip_check_mc(struct in_device *dev, __be32 mc_addr, __be32 src_addr, u16 proto);
202 extern int igmp_rcv(struct sk_buff *);
203 extern int ip_mc_join_group(struct sock *sk, struct ip_mreqn *imr);
204 extern int ip_mc_leave_group(struct sock *sk, struct ip_mreqn *imr);
205 extern void ip_mc_drop_socket(struct sock *sk);
206 extern int ip_mc_source(int add, int omode, struct sock *sk,
207 		struct ip_mreq_source *mreqs, int ifindex);
208 extern int ip_mc_msfilter(struct sock *sk, struct ip_msfilter *msf,int ifindex);
209 extern int ip_mc_msfget(struct sock *sk, struct ip_msfilter *msf,
210 		struct ip_msfilter __user *optval, int __user *optlen);
211 extern int ip_mc_gsfget(struct sock *sk, struct group_filter *gsf,
212 		struct group_filter __user *optval, int __user *optlen);
213 extern int ip_mc_sf_allow(struct sock *sk, __be32 local, __be32 rmt, int dif);
214 extern void ip_mr_init(void);
215 extern void ip_mc_init_dev(struct in_device *);
216 extern void ip_mc_destroy_dev(struct in_device *);
217 extern void ip_mc_up(struct in_device *);
218 extern void ip_mc_down(struct in_device *);
219 extern void ip_mc_dec_group(struct in_device *in_dev, __be32 addr);
220 extern void ip_mc_inc_group(struct in_device *in_dev, __be32 addr);
221 extern void ip_mc_rejoin_group(struct ip_mc_list *im);
222 
223 #endif
224 #endif
225