mld6.c revision 151539
1/*	$FreeBSD: head/sys/netinet6/mld6.c 151539 2005-10-21 16:23:01Z suz $	*/
2/*	$KAME: mld6.c,v 1.27 2001/04/04 05:17:30 itojun Exp $	*/
3
4/*-
5 * Copyright (C) 1998 WIDE Project.
6 * All rights reserved.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
11 * 1. Redistributions of source code must retain the above copyright
12 *    notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 *    notice, this list of conditions and the following disclaimer in the
15 *    documentation and/or other materials provided with the distribution.
16 * 3. Neither the name of the project nor the names of its contributors
17 *    may be used to endorse or promote products derived from this software
18 *    without specific prior written permission.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
21 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 * ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
24 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30 * SUCH DAMAGE.
31 */
32
33/*-
34 * Copyright (c) 1988 Stephen Deering.
35 * Copyright (c) 1992, 1993
36 *	The Regents of the University of California.  All rights reserved.
37 *
38 * This code is derived from software contributed to Berkeley by
39 * Stephen Deering of Stanford University.
40 *
41 * Redistribution and use in source and binary forms, with or without
42 * modification, are permitted provided that the following conditions
43 * are met:
44 * 1. Redistributions of source code must retain the above copyright
45 *    notice, this list of conditions and the following disclaimer.
46 * 2. Redistributions in binary form must reproduce the above copyright
47 *    notice, this list of conditions and the following disclaimer in the
48 *    documentation and/or other materials provided with the distribution.
49 * 4. Neither the name of the University nor the names of its contributors
50 *    may be used to endorse or promote products derived from this software
51 *    without specific prior written permission.
52 *
53 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
54 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
55 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
56 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
57 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
58 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
59 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
60 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
61 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
62 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
63 * SUCH DAMAGE.
64 *
65 *	@(#)igmp.c	8.1 (Berkeley) 7/19/93
66 */
67
68#include "opt_inet.h"
69#include "opt_inet6.h"
70
71#include <sys/param.h>
72#include <sys/systm.h>
73#include <sys/mbuf.h>
74#include <sys/socket.h>
75#include <sys/protosw.h>
76#include <sys/syslog.h>
77#include <sys/kernel.h>
78#include <sys/callout.h>
79#include <sys/malloc.h>
80
81#include <net/if.h>
82
83#include <netinet/in.h>
84#include <netinet/in_var.h>
85#include <netinet6/in6_var.h>
86#include <netinet/ip6.h>
87#include <netinet6/ip6_var.h>
88#include <netinet6/scope6_var.h>
89#include <netinet/icmp6.h>
90#include <netinet6/mld6_var.h>
91
92#include <net/net_osdep.h>
93
94/*
95 * Protocol constants
96 */
97
98/* denotes that the MLD max response delay field specifies time in milliseconds */
99#define MLD_TIMER_SCALE	1000
100/*
101 * time between repetitions of a node's initial report of interest in a
102 * multicast address(in seconds)
103 */
104#define MLD_UNSOLICITED_REPORT_INTERVAL	10
105
106static struct ip6_pktopts ip6_opts;
107
108static void mld6_sendpkt(struct in6_multi *, int, const struct in6_addr *);
109static void mld_starttimer(struct in6_multi *);
110static void mld_stoptimer(struct in6_multi *);
111static void mld_timeo(struct in6_multi *);
112static u_long mld_timerresid(struct in6_multi *);
113
114void
115mld6_init()
116{
117	static u_int8_t hbh_buf[8];
118	struct ip6_hbh *hbh = (struct ip6_hbh *)hbh_buf;
119	u_int16_t rtalert_code = htons((u_int16_t)IP6OPT_RTALERT_MLD);
120
121	/* ip6h_nxt will be fill in later */
122	hbh->ip6h_len = 0;	/* (8 >> 3) - 1 */
123
124	/* XXX: grotty hard coding... */
125	hbh_buf[2] = IP6OPT_PADN;	/* 2 byte padding */
126	hbh_buf[3] = 0;
127	hbh_buf[4] = IP6OPT_ROUTER_ALERT;
128	hbh_buf[5] = IP6OPT_RTALERT_LEN - 2;
129	bcopy((caddr_t)&rtalert_code, &hbh_buf[6], sizeof(u_int16_t));
130
131	ip6_initpktopts(&ip6_opts);
132	ip6_opts.ip6po_hbh = hbh;
133}
134
135static void
136mld_starttimer(in6m)
137	struct in6_multi *in6m;
138{
139	struct timeval now;
140
141	microtime(&now);
142	in6m->in6m_timer_expire.tv_sec = now.tv_sec + in6m->in6m_timer / hz;
143	in6m->in6m_timer_expire.tv_usec = now.tv_usec +
144	    (in6m->in6m_timer % hz) * (1000000 / hz);
145	if (in6m->in6m_timer_expire.tv_usec > 1000000) {
146		in6m->in6m_timer_expire.tv_sec++;
147		in6m->in6m_timer_expire.tv_usec -= 1000000;
148	}
149
150	/* start or restart the timer */
151	callout_reset(in6m->in6m_timer_ch, in6m->in6m_timer,
152	    (void (*) __P((void *)))mld_timeo, in6m);
153}
154
155static void
156mld_stoptimer(in6m)
157	struct in6_multi *in6m;
158{
159	if (in6m->in6m_timer == IN6M_TIMER_UNDEF)
160		return;
161
162	callout_stop(in6m->in6m_timer_ch);
163	in6m->in6m_timer = IN6M_TIMER_UNDEF;
164}
165
166static void
167mld_timeo(in6m)
168	struct in6_multi *in6m;
169{
170	int s = splnet();
171
172	in6m->in6m_timer = IN6M_TIMER_UNDEF;
173
174	callout_stop(in6m->in6m_timer_ch);
175
176	switch (in6m->in6m_state) {
177	case MLD_REPORTPENDING:
178		mld6_start_listening(in6m);
179		break;
180	default:
181		mld6_sendpkt(in6m, MLD_LISTENER_REPORT, NULL);
182		break;
183	}
184
185	splx(s);
186}
187
188static u_long
189mld_timerresid(in6m)
190	struct in6_multi *in6m;
191{
192	struct timeval now, diff;
193
194	microtime(&now);
195
196	if (now.tv_sec > in6m->in6m_timer_expire.tv_sec ||
197	    (now.tv_sec == in6m->in6m_timer_expire.tv_sec &&
198	    now.tv_usec > in6m->in6m_timer_expire.tv_usec)) {
199		return (0);
200	}
201	diff = in6m->in6m_timer_expire;
202	diff.tv_sec -= now.tv_sec;
203	diff.tv_usec -= now.tv_usec;
204	if (diff.tv_usec < 0) {
205		diff.tv_sec--;
206		diff.tv_usec += 1000000;
207	}
208
209	/* return the remaining time in milliseconds */
210	return (((u_long)(diff.tv_sec * 1000000 + diff.tv_usec)) / 1000);
211}
212
213void
214mld6_start_listening(in6m)
215	struct in6_multi *in6m;
216{
217	struct in6_addr all_in6;
218	int s = splnet();
219
220	/*
221	 * RFC2710 page 10:
222	 * The node never sends a Report or Done for the link-scope all-nodes
223	 * address.
224	 * MLD messages are never sent for multicast addresses whose scope is 0
225	 * (reserved) or 1 (node-local).
226	 */
227	all_in6 = in6addr_linklocal_allnodes;
228	if (in6_setscope(&all_in6, in6m->in6m_ifp, NULL)) {
229		/* XXX: this should not happen! */
230		in6m->in6m_timer = 0;
231		in6m->in6m_state = MLD_OTHERLISTENER;
232	}
233	if (IN6_ARE_ADDR_EQUAL(&in6m->in6m_addr, &all_in6) ||
234	    IPV6_ADDR_MC_SCOPE(&in6m->in6m_addr) <
235	    IPV6_ADDR_SCOPE_LINKLOCAL) {
236		in6m->in6m_timer = 0;
237		in6m->in6m_state = MLD_OTHERLISTENER;
238	} else {
239		mld6_sendpkt(in6m, MLD_LISTENER_REPORT, NULL);
240		in6m->in6m_timer = arc4random() %
241			MLD_UNSOLICITED_REPORT_INTERVAL * hz;
242		in6m->in6m_state = MLD_IREPORTEDLAST;
243
244		mld_starttimer(in6m);
245	}
246	splx(s);
247}
248
249void
250mld6_stop_listening(in6m)
251	struct in6_multi *in6m;
252{
253	struct in6_addr allnode, allrouter;
254
255	allnode = in6addr_linklocal_allnodes;
256	if (in6_setscope(&allnode, in6m->in6m_ifp, NULL)) {
257		/* XXX: this should not happen! */
258		return;
259	}
260	allrouter = in6addr_linklocal_allrouters;
261	if (in6_setscope(&allrouter, in6m->in6m_ifp, NULL)) {
262		/* XXX impossible */
263		return;
264	}
265	if (in6m->in6m_state == MLD_IREPORTEDLAST &&
266	    !IN6_ARE_ADDR_EQUAL(&in6m->in6m_addr, &allnode) &&
267	    IPV6_ADDR_MC_SCOPE(&in6m->in6m_addr) >
268	    IPV6_ADDR_SCOPE_INTFACELOCAL) {
269		mld6_sendpkt(in6m, MLD_LISTENER_DONE, &allrouter);
270	}
271}
272
273void
274mld6_input(m, off)
275	struct mbuf *m;
276	int off;
277{
278	struct ip6_hdr *ip6 = mtod(m, struct ip6_hdr *);
279	struct mld_hdr *mldh;
280	struct ifnet *ifp = m->m_pkthdr.rcvif;
281	struct in6_multi *in6m;
282	struct in6_addr mld_addr, all_in6;
283	struct in6_ifaddr *ia;
284	struct ifmultiaddr *ifma;
285	int timer;		/* timer value in the MLD query header */
286
287#ifndef PULLDOWN_TEST
288	IP6_EXTHDR_CHECK(m, off, sizeof(*mldh),);
289	mldh = (struct mld_hdr *)(mtod(m, caddr_t) + off);
290#else
291	IP6_EXTHDR_GET(mldh, struct mld_hdr *, m, off, sizeof(*mldh));
292	if (mldh == NULL) {
293		icmp6stat.icp6s_tooshort++;
294		return;
295	}
296#endif
297
298	/* source address validation */
299	ip6 = mtod(m, struct ip6_hdr *); /* in case mpullup */
300	if (!IN6_IS_ADDR_LINKLOCAL(&ip6->ip6_src)) {
301		log(LOG_ERR,
302		    "mld6_input: src %s is not link-local (grp=%s)\n",
303		    ip6_sprintf(&ip6->ip6_src),
304		    ip6_sprintf(&mldh->mld_addr));
305		/*
306		 * spec (RFC2710) does not explicitly
307		 * specify to discard the packet from a non link-local
308		 * source address. But we believe it's expected to do so.
309		 * XXX: do we have to allow :: as source?
310		 */
311		m_freem(m);
312		return;
313	}
314
315	/*
316	 * make a copy for local work (in6_setscope() may modify the 1st arg)
317	 */
318	mld_addr = mldh->mld_addr;
319	if (in6_setscope(&mld_addr, ifp, NULL)) {
320		/* XXX: this should not happen! */
321		m_free(m);
322		return;
323	}
324
325	/*
326	 * In the MLD6 specification, there are 3 states and a flag.
327	 *
328	 * In Non-Listener state, we simply don't have a membership record.
329	 * In Delaying Listener state, our timer is running (in6m->in6m_timer)
330	 * In Idle Listener state, our timer is not running (in6m->in6m_timer==0)
331	 *
332	 * The flag is in6m->in6m_state, it is set to MLD_OTHERLISTENER if
333	 * we have heard a report from another member, or MLD_IREPORTEDLAST
334	 * if we sent the last report.
335	 */
336	switch(mldh->mld_type) {
337	case MLD_LISTENER_QUERY:
338		if (ifp->if_flags & IFF_LOOPBACK)
339			break;
340
341		if (!IN6_IS_ADDR_UNSPECIFIED(&mld_addr) &&
342		    !IN6_IS_ADDR_MULTICAST(&mld_addr))
343			break;	/* print error or log stat? */
344
345		all_in6 = in6addr_linklocal_allnodes;
346		if (in6_setscope(&all_in6, ifp, NULL)) {
347			/* XXX: this should not happen! */
348			break;
349		}
350
351		/*
352		 * - Start the timers in all of our membership records
353		 *   that the query applies to for the interface on
354		 *   which the query arrived excl. those that belong
355		 *   to the "all-nodes" group (ff02::1).
356		 * - Restart any timer that is already running but has
357		 *   A value longer than the requested timeout.
358		 * - Use the value specified in the query message as
359		 *   the maximum timeout.
360		 */
361		timer = ntohs(mldh->mld_maxdelay);
362
363		IFP_TO_IA6(ifp, ia);
364		if (ia == NULL)
365			break;
366
367		/*
368		 * XXX: System timer resolution is too low to handle Max
369		 * Response Delay, so set 1 to the internal timer even if
370		 * the calculated value equals to zero when Max Response
371		 * Delay is positive.
372		 */
373		timer = ntohs(mldh->mld_maxdelay) * PR_FASTHZ / MLD_TIMER_SCALE;
374		if (timer == 0 && mldh->mld_maxdelay)
375			timer = 1;
376
377		IF_ADDR_LOCK(ifp);
378		TAILQ_FOREACH(ifma, &ifp->if_multiaddrs, ifma_link) {
379			if (ifma->ifma_addr->sa_family != AF_INET6)
380				continue;
381			in6m = (struct in6_multi *)ifma->ifma_protospec;
382
383			if (IN6_ARE_ADDR_EQUAL(&in6m->in6m_addr, &all_in6) ||
384			    IPV6_ADDR_MC_SCOPE(&in6m->in6m_addr) <
385			    IPV6_ADDR_SCOPE_LINKLOCAL)
386				continue;
387
388			if (IN6_IS_ADDR_UNSPECIFIED(&mld_addr) ||
389			    IN6_ARE_ADDR_EQUAL(&mld_addr, &in6m->in6m_addr)) {
390				if (timer == 0) {
391					/* send a report immediately */
392					mld_stoptimer(in6m);
393					mld6_sendpkt(in6m, MLD_LISTENER_REPORT,
394						NULL);
395					in6m->in6m_timer = 0; /* reset timer */
396					in6m->in6m_state = MLD_IREPORTEDLAST;
397				}
398				else if (in6m->in6m_timer == 0 || /*idle state*/
399				    mld_timerresid(in6m) > (u_long)timer) {
400					in6m->in6m_timer = arc4random() %
401					    (int)((long)(timer * hz) / 1000);
402					mld_starttimer(in6m);
403				}
404			}
405		}
406		IF_ADDR_UNLOCK(ifp);
407		break;
408
409	case MLD_LISTENER_REPORT:
410		/*
411		 * For fast leave to work, we have to know that we are the
412		 * last person to send a report for this group.  Reports
413		 * can potentially get looped back if we are a multicast
414		 * router, so discard reports sourced by me.
415		 * Note that it is impossible to check IFF_LOOPBACK flag of
416		 * ifp for this purpose, since ip6_mloopback pass the physical
417		 * interface to looutput.
418		 */
419		if (m->m_flags & M_LOOP) /* XXX: grotty flag, but efficient */
420			break;
421
422		if (!IN6_IS_ADDR_MULTICAST(&mld_addr))
423			break;
424
425		/*
426		 * If we belong to the group being reported, stop
427		 * our timer for that group.
428		 */
429		IN6_LOOKUP_MULTI(mld_addr, ifp, in6m);
430		if (in6m) {
431			in6m->in6m_timer = 0; /* transit to idle state */
432			in6m->in6m_state = MLD_OTHERLISTENER; /* clear flag */
433		}
434		break;
435	default:		/* this is impossible */
436		log(LOG_ERR, "mld6_input: illegal type(%d)", mldh->mld_type);
437		break;
438	}
439
440	m_freem(m);
441}
442
443static void
444mld6_sendpkt(in6m, type, dst)
445	struct in6_multi *in6m;
446	int type;
447	const struct in6_addr *dst;
448{
449	struct mbuf *mh, *md;
450	struct mld_hdr *mldh;
451	struct ip6_hdr *ip6;
452	struct ip6_moptions im6o;
453	struct in6_ifaddr *ia;
454	struct ifnet *ifp = in6m->in6m_ifp;
455	struct ifnet *outif = NULL;
456
457	/*
458	 * At first, find a link local address on the outgoing interface
459	 * to use as the source address of the MLD packet.
460	 */
461	if ((ia = in6ifa_ifpforlinklocal(ifp, IN6_IFF_NOTREADY|IN6_IFF_ANYCAST))
462	    == NULL)
463		return;
464
465	/*
466	 * Allocate mbufs to store ip6 header and MLD header.
467	 * We allocate 2 mbufs and make chain in advance because
468	 * it is more convenient when inserting the hop-by-hop option later.
469	 */
470	MGETHDR(mh, M_DONTWAIT, MT_HEADER);
471	if (mh == NULL)
472		return;
473	MGET(md, M_DONTWAIT, MT_DATA);
474	if (md == NULL) {
475		m_free(mh);
476		return;
477	}
478	mh->m_next = md;
479
480	mh->m_pkthdr.rcvif = NULL;
481	mh->m_pkthdr.len = sizeof(struct ip6_hdr) + sizeof(struct mld_hdr);
482	mh->m_len = sizeof(struct ip6_hdr);
483	MH_ALIGN(mh, sizeof(struct ip6_hdr));
484
485	/* fill in the ip6 header */
486	ip6 = mtod(mh, struct ip6_hdr *);
487	ip6->ip6_flow = 0;
488	ip6->ip6_vfc &= ~IPV6_VERSION_MASK;
489	ip6->ip6_vfc |= IPV6_VERSION;
490	/* ip6_plen will be set later */
491	ip6->ip6_nxt = IPPROTO_ICMPV6;
492	/* ip6_hlim will be set by im6o.im6o_multicast_hlim */
493	ip6->ip6_src = ia->ia_addr.sin6_addr;
494	ip6->ip6_dst = dst ? *dst : in6m->in6m_addr;
495
496	/* fill in the MLD header */
497	md->m_len = sizeof(struct mld_hdr);
498	mldh = mtod(md, struct mld_hdr *);
499	mldh->mld_type = type;
500	mldh->mld_code = 0;
501	mldh->mld_cksum = 0;
502	/* XXX: we assume the function will not be called for query messages */
503	mldh->mld_maxdelay = 0;
504	mldh->mld_reserved = 0;
505	mldh->mld_addr = in6m->in6m_addr;
506	in6_clearscope(&mldh->mld_addr); /* XXX */
507	mldh->mld_cksum = in6_cksum(mh, IPPROTO_ICMPV6, sizeof(struct ip6_hdr),
508				    sizeof(struct mld_hdr));
509
510	/* construct multicast option */
511	bzero(&im6o, sizeof(im6o));
512	im6o.im6o_multicast_ifp = ifp;
513	im6o.im6o_multicast_hlim = 1;
514
515	/*
516	 * Request loopback of the report if we are acting as a multicast
517	 * router, so that the process-level routing daemon can hear it.
518	 */
519	im6o.im6o_multicast_loop = (ip6_mrouter != NULL);
520
521	/* increment output statictics */
522	icmp6stat.icp6s_outhist[type]++;
523
524	ip6_output(mh, &ip6_opts, NULL, 0, &im6o, &outif, NULL);
525	if (outif) {
526		icmp6_ifstat_inc(outif, ifs6_out_msg);
527		switch (type) {
528		case MLD_LISTENER_QUERY:
529			icmp6_ifstat_inc(outif, ifs6_out_mldquery);
530			break;
531		case MLD_LISTENER_REPORT:
532			icmp6_ifstat_inc(outif, ifs6_out_mldreport);
533			break;
534		case MLD_LISTENER_DONE:
535			icmp6_ifstat_inc(outif, ifs6_out_mlddone);
536			break;
537		}
538	}
539}
540
541/*
542 * Add an address to the list of IP6 multicast addresses for a given interface.
543 * Add source addresses to the list also, if upstream router is MLDv2 capable
544 * and the number of source is not 0.
545 */
546struct	in6_multi *
547in6_addmulti(maddr6, ifp, errorp, delay)
548	struct in6_addr *maddr6;
549	struct ifnet *ifp;
550	int *errorp, delay;
551{
552	struct in6_multi *in6m;
553	struct ifmultiaddr *ifma;
554	struct sockaddr_in6 sa6;
555	int	s = splnet();
556
557	*errorp = 0;
558
559	/*
560	 * Call generic routine to add membership or increment
561	 * refcount.  It wants addresses in the form of a sockaddr,
562	 * so we build one here (being careful to zero the unused bytes).
563	 */
564	bzero(&sa6, sizeof(sa6));
565	sa6.sin6_family = AF_INET6;
566	sa6.sin6_len = sizeof(struct sockaddr_in6);
567	sa6.sin6_addr = *maddr6;
568	*errorp = if_addmulti(ifp, (struct sockaddr *)&sa6, &ifma);
569	if (*errorp) {
570		splx(s);
571		return 0;
572	}
573
574	/*
575	 * If ifma->ifma_protospec is null, then if_addmulti() created
576	 * a new record.  Otherwise, we are done.
577	 */
578	if (ifma->ifma_protospec != NULL) {
579		splx(s);
580		return ifma->ifma_protospec;
581	}
582
583	/* XXX - if_addmulti uses M_WAITOK.  Can this really be called
584	   at interrupt time?  If so, need to fix if_addmulti. XXX */
585	in6m = (struct in6_multi *)malloc(sizeof(*in6m), M_IP6MADDR, M_NOWAIT);
586	if (in6m == NULL) {
587		splx(s);
588		return (NULL);
589	}
590
591	bzero(in6m, sizeof *in6m);
592	in6m->in6m_addr = *maddr6;
593	in6m->in6m_ifp = ifp;
594	in6m->in6m_refcount = 1;
595	in6m->in6m_ifma = ifma;
596	ifma->ifma_protospec = in6m;
597	in6m->in6m_timer_ch = malloc(sizeof(*in6m->in6m_timer_ch), M_IP6MADDR,
598	    M_NOWAIT);
599	if (in6m->in6m_timer_ch == NULL) {
600		free(in6m, M_IP6MADDR);
601		splx(s);
602		return (NULL);
603	}
604	LIST_INSERT_HEAD(&in6_multihead, in6m, in6m_entry);
605
606	callout_init(in6m->in6m_timer_ch, 0);
607	in6m->in6m_timer = delay;
608	if (in6m->in6m_timer > 0) {
609		in6m->in6m_state = MLD_REPORTPENDING;
610		mld_starttimer(in6m);
611
612		splx(s);
613		return (in6m);
614	}
615
616	/*
617	 * Let MLD6 know that we have joined a new IPv6 multicast
618	 * group.
619	 */
620	mld6_start_listening(in6m);
621	splx(s);
622	return (in6m);
623}
624
625/*
626 * Delete a multicast address record.
627 */
628void
629in6_delmulti(in6m)
630	struct in6_multi *in6m;
631{
632	struct ifmultiaddr *ifma = in6m->in6m_ifma;
633	int	s = splnet();
634
635	if (ifma->ifma_refcount == 1) {
636		/*
637		 * No remaining claims to this record; let MLD6 know
638		 * that we are leaving the multicast group.
639		 */
640		mld6_stop_listening(in6m);
641		ifma->ifma_protospec = NULL;
642		LIST_REMOVE(in6m, in6m_entry);
643		free(in6m->in6m_timer_ch, M_IP6MADDR);
644		free(in6m, M_IP6MADDR);
645	}
646	/* XXX - should be separate API for when we have an ifma? */
647	if_delmulti(ifma->ifma_ifp, ifma->ifma_addr);
648	splx(s);
649}
650