sys/netinet6/mld6_var.h

   1 /*-
   2  * Copyright (c) 2009 Bruce Simpson.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  * 1. Redistributions of source code must retain the above copyright
   8  *    notice, this list of conditions and the following disclaimer.
   9  * 2. Redistributions in binary form must reproduce the above copyright
  10  *    notice, this list of conditions and the following disclaimer in the
  11  *    documentation and/or other materials provided with the distribution.
  12  * 3. The name of the author may not be used to endorse or promote
  13  *    products derived from this software without specific prior written
  14  *    permission.
  15  *
  16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26  * SUCH DAMAGE.
  27  *
  28  * $FreeBSD$
  29  */
  30 #ifndef _NETINET6_MLD6_VAR_H_
  31 #define _NETINET6_MLD6_VAR_H_
  32
  33 /*
  34  * Multicast Listener Discovery (MLD)
  35  * implementation-specific definitions.
  36  */
  37
  38 #ifdef _KERNEL
  39
  40 /*
  41  * Per-link MLD state.
  42  */
  43 struct mld_ifinfo {
  44         LIST_ENTRY(mld_ifinfo) mli_link;
  45         struct ifnet *mli_ifp;  /* interface this instance belongs to */
  46         uint32_t mli_version;   /* MLDv1 Host Compatibility Mode */
  47         uint32_t mli_v1_timer;  /* MLDv1 Querier Present timer (s) */
  48         uint32_t mli_v2_timer;  /* MLDv2 General Query (interface) timer (s)*/
  49         uint32_t mli_flags;     /* MLD per-interface flags */
  50         uint32_t mli_rv;        /* MLDv2 Robustness Variable */
  51         uint32_t mli_qi;        /* MLDv2 Query Interval (s) */
  52         uint32_t mli_qri;       /* MLDv2 Query Response Interval (s) */
  53         uint32_t mli_uri;       /* MLDv2 Unsolicited Report Interval (s) */
  54         SLIST_HEAD(,in6_multi)  mli_relinmhead; /* released groups */
  55         struct ifqueue   mli_gq;        /* queue of general query responses */
  56 };
  57 #define MLIF_SILENT     0x00000001      /* Do not use MLD on this ifp */
  58 #define MLIF_USEALLOW   0x00000002      /* Use ALLOW/BLOCK for joins/leaves */
  59
  60 #define MLD_RANDOM_DELAY(X)             (arc4random() % (X) + 1)
  61 #define MLD_MAX_STATE_CHANGES           24 /* Max pending changes per group */
  62
  63 /*
  64  * MLD per-group states.
  65  */
  66 #define MLD_NOT_MEMBER                  0 /* Can garbage collect group */
  67 #define MLD_SILENT_MEMBER               1 /* Do not perform MLD for group */
  68 #define MLD_REPORTING_MEMBER            2 /* MLDv1 we are reporter */
  69 #define MLD_IDLE_MEMBER                 3 /* MLDv1 we reported last */
  70 #define MLD_LAZY_MEMBER                 4 /* MLDv1 other member reporting */
  71 #define MLD_SLEEPING_MEMBER             5 /* MLDv1 start query response */
  72 #define MLD_AWAKENING_MEMBER            6 /* MLDv1 group timer will start */
  73 #define MLD_G_QUERY_PENDING_MEMBER      7 /* MLDv2 group query pending */
  74 #define MLD_SG_QUERY_PENDING_MEMBER     8 /* MLDv2 source query pending */
  75 #define MLD_LEAVING_MEMBER              9 /* MLDv2 dying gasp (pending last */
  76                                           /* retransmission of INCLUDE {}) */
  77
  78 /*
  79  * MLD version tag.
  80  */
  81 #define MLD_VERSION_NONE                0 /* Invalid */
  82 #define MLD_VERSION_1                   1
  83 #define MLD_VERSION_2                   2 /* Default */
  84
  85 /*
  86  * MLDv2 protocol control variables.
  87  */
  88 #define MLD_RV_INIT             2       /* Robustness Variable */
  89 #define MLD_RV_MIN              1
  90 #define MLD_RV_MAX              7
  91
  92 #define MLD_QI_INIT             125     /* Query Interval (s) */
  93 #define MLD_QI_MIN              1
  94 #define MLD_QI_MAX              255
  95
  96 #define MLD_QRI_INIT            10      /* Query Response Interval (s) */
  97 #define MLD_QRI_MIN             1
  98 #define MLD_QRI_MAX             255
  99
 100 #define MLD_URI_INIT            3       /* Unsolicited Report Interval (s) */
 101 #define MLD_URI_MIN             0
 102 #define MLD_URI_MAX             10
 103
 104 #define MLD_MAX_GS_SOURCES              256 /* # of sources in rx GS query */
 105 #define MLD_MAX_G_GS_PACKETS            8 /* # of packets to answer G/GS */
 106 #define MLD_MAX_STATE_CHANGE_PACKETS    8 /* # of packets per state change */
 107 #define MLD_MAX_RESPONSE_PACKETS        16 /* # of packets for general query */
 108 #define MLD_MAX_RESPONSE_BURST          4 /* # of responses to send at once */
 109 #define MLD_RESPONSE_BURST_INTERVAL     (PR_FASTHZ / 2) /* 500ms */
 110
 111 /*
 112  * MLD-specific mbuf flags.
 113  */
 114 #define M_MLDV1         M_PROTO1        /* Packet is MLDv1 */
 115 #define M_GROUPREC      M_PROTO3        /* mbuf chain is a group record */
 116
 117 /*
 118  * Leading space for MLDv2 reports inside MTU.
 119  *
 120  * NOTE: This differs from IGMPv3 significantly. KAME IPv6 requires
 121  * that a fully formed mbuf chain *without* the Router Alert option
 122  * is passed to ip6_output(), however we must account for it in the
 123  * MTU if we need to split an MLDv2 report into several packets.
 124  *
 125  * We now put the MLDv2 report header in the initial mbuf containing
 126  * the IPv6 header.
 127  */
 128 #define MLD_MTUSPACE    (sizeof(struct ip6_hdr) + sizeof(struct mld_raopt) + \
 129                          sizeof(struct icmp6_hdr))
 130
 131 /*
 132  * Subsystem lock macros.
 133  * The MLD lock is only taken with MLD. Currently it is system-wide.
 134  * VIMAGE: The lock could be pushed to per-VIMAGE granularity in future.
 135  */
 136 #define MLD_LOCK_INIT() mtx_init(&mld_mtx, "mld_mtx", NULL, MTX_DEF)
 137 #define MLD_LOCK_DESTROY()      mtx_destroy(&mld_mtx)
 138 #define MLD_LOCK()              mtx_lock(&mld_mtx)
 139 #define MLD_LOCK_ASSERT()       mtx_assert(&mld_mtx, MA_OWNED)
 140 #define MLD_UNLOCK()            mtx_unlock(&mld_mtx)
 141 #define MLD_UNLOCK_ASSERT()     mtx_assert(&mld_mtx, MA_NOTOWNED)
 142
 143 /*
 144  * Per-link MLD context.
 145  */
 146 #define MLD_IFINFO(ifp) \
 147         (((struct in6_ifextra *)(ifp)->if_afdata[AF_INET6])->mld_ifinfo)
 148
 149 int     mld_change_state(struct in6_multi *, const int);
 150 struct mld_ifinfo *
 151         mld_domifattach(struct ifnet *);
 152 void    mld_domifdetach(struct ifnet *);
 153 void    mld_fasttimo(void);
 154 void    mld_ifdetach(struct ifnet *);
 155 int     mld_input(struct mbuf *, int, int);
 156 void    mld_slowtimo(void);
 157
 158 #ifdef SYSCTL_DECL
 159 SYSCTL_DECL(_net_inet6_mld);
 160 #endif
 161
 162 #endif /* _KERNEL */
 163
 164 #endif /* _NETINET6_MLD6_VAR_H_ */