sys/net/if_bridgevar.h

   1 /*      $NetBSD: if_bridgevar.h,v 1.4 2003/07/08 07:13:50 itojun Exp $  */
   2
   3 /*
   4  * Copyright 2001 Wasabi Systems, Inc.
   5  * All rights reserved.
   6  *
   7  * Written by Jason R. Thorpe for Wasabi Systems, Inc.
   8  *
   9  * Redistribution and use in source and binary forms, with or without
  10  * modification, are permitted provided that the following conditions
  11  * are met:
  12  * 1. Redistributions of source code must retain the above copyright
  13  *    notice, this list of conditions and the following disclaimer.
  14  * 2. Redistributions in binary form must reproduce the above copyright
  15  *    notice, this list of conditions and the following disclaimer in the
  16  *    documentation and/or other materials provided with the distribution.
  17  * 3. All advertising materials mentioning features or use of this software
  18  *    must display the following acknowledgement:
  19  *      This product includes software developed for the NetBSD Project by
  20  *      Wasabi Systems, Inc.
  21  * 4. The name of Wasabi Systems, Inc. may not be used to endorse
  22  *    or promote products derived from this software without specific prior
  23  *    written permission.
  24  *
  25  * THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
  26  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  27  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  28  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL WASABI SYSTEMS, INC
  29  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  30  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  31  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  32  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  33  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  34  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  35  * POSSIBILITY OF SUCH DAMAGE.
  36  */
  37
  38 /*
  39  * Copyright (c) 1999, 2000 Jason L. Wright (jason@thought.net)
  40  * All rights reserved.
  41  *
  42  * Redistribution and use in source and binary forms, with or without
  43  * modification, are permitted provided that the following conditions
  44  * are met:
  45  * 1. Redistributions of source code must retain the above copyright
  46  *    notice, this list of conditions and the following disclaimer.
  47  * 2. Redistributions in binary form must reproduce the above copyright
  48  *    notice, this list of conditions and the following disclaimer in the
  49  *    documentation and/or other materials provided with the distribution.
  50  * 3. All advertising materials mentioning features or use of this software
  51  *    must display the following acknowledgement:
  52  *      This product includes software developed by Jason L. Wright
  53  * 4. The name of the author may not be used to endorse or promote products
  54  *    derived from this software without specific prior written permission.
  55  *
  56  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  57  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  58  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  59  * DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
  60  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  61  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  62  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  63  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  64  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  65  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  66  * POSSIBILITY OF SUCH DAMAGE.
  67  *
  68  * OpenBSD: if_bridge.h,v 1.14 2001/03/22 03:48:29 jason Exp
  69  *
  70  * $FreeBSD$
  71  */
  72
  73 /*
  74  * Data structure and control definitions for bridge interfaces.
  75  */
  76
  77 #include <sys/callout.h>
  78 #include <sys/queue.h>
  79 #include <sys/condvar.h>
  80
  81 /*
  82  * Commands used in the SIOCSDRVSPEC ioctl.  Note the lookup of the
  83  * bridge interface itself is keyed off the ifdrv structure.
  84  */
  85 #define BRDGADD                 0       /* add bridge member (ifbreq) */
  86 #define BRDGDEL                 1       /* delete bridge member (ifbreq) */
  87 #define BRDGGIFFLGS             2       /* get member if flags (ifbreq) */
  88 #define BRDGSIFFLGS             3       /* set member if flags (ifbreq) */
  89 #define BRDGSCACHE              4       /* set cache size (ifbrparam) */
  90 #define BRDGGCACHE              5       /* get cache size (ifbrparam) */
  91 #define BRDGGIFS                6       /* get member list (ifbifconf) */
  92 #define BRDGRTS                 7       /* get address list (ifbaconf) */
  93 #define BRDGSADDR               8       /* set static address (ifbareq) */
  94 #define BRDGSTO                 9       /* set cache timeout (ifbrparam) */
  95 #define BRDGGTO                 10      /* get cache timeout (ifbrparam) */
  96 #define BRDGDADDR               11      /* delete address (ifbareq) */
  97 #define BRDGFLUSH               12      /* flush address cache (ifbreq) */
  98
  99 #define BRDGGPRI                13      /* get priority (ifbrparam) */
 100 #define BRDGSPRI                14      /* set priority (ifbrparam) */
 101 #define BRDGGHT                 15      /* get hello time (ifbrparam) */
 102 #define BRDGSHT                 16      /* set hello time (ifbrparam) */
 103 #define BRDGGFD                 17      /* get forward delay (ifbrparam) */
 104 #define BRDGSFD                 18      /* set forward delay (ifbrparam) */
 105 #define BRDGGMA                 19      /* get max age (ifbrparam) */
 106 #define BRDGSMA                 20      /* set max age (ifbrparam) */
 107 #define BRDGSIFPRIO             21      /* set if priority (ifbreq) */
 108 #define BRDGSIFCOST             22      /* set if path cost (ifbreq) */
 109 #define BRDGADDS                23      /* add bridge span member (ifbreq) */
 110 #define BRDGDELS                24      /* delete bridge span member (ifbreq) */
 111 #define BRDGPARAM               25      /* get bridge STP params (ifbropreq) */
 112 #define BRDGGRTE                26      /* get cache drops (ifbrparam) */
 113 #define BRDGGIFSSTP             27      /* get member STP params list
 114                                          * (ifbpstpconf) */
 115
 116 /*
 117  * Generic bridge control request.
 118  */
 119 struct ifbreq {
 120         char            ifbr_ifsname[IFNAMSIZ]; /* member if name */
 121         uint32_t        ifbr_ifsflags;          /* member if flags */
 122         uint8_t         ifbr_state;             /* member if STP state */
 123         uint8_t         ifbr_priority;          /* member if STP priority */
 124         uint8_t         ifbr_path_cost;         /* member if STP cost */
 125         uint8_t         ifbr_portno;            /* member if port number */
 126 };
 127
 128 /* BRDGGIFFLAGS, BRDGSIFFLAGS */
 129 #define IFBIF_LEARNING          0x01    /* if can learn */
 130 #define IFBIF_DISCOVER          0x02    /* if sends packets w/ unknown dest. */
 131 #define IFBIF_STP               0x04    /* if participates in spanning tree */
 132 #define IFBIF_SPAN              0x08    /* if is a span port */
 133
 134 #define IFBIFBITS       "\020\1LEARNING\2DISCOVER\3STP\4SPAN"
 135
 136 /* BRDGFLUSH */
 137 #define IFBF_FLUSHDYN           0x00    /* flush learned addresses only */
 138 #define IFBF_FLUSHALL           0x01    /* flush all addresses */
 139
 140 /*
 141  * Interface list structure.
 142  */
 143 struct ifbifconf {
 144         uint32_t        ifbic_len;      /* buffer size */
 145         union {
 146                 caddr_t ifbicu_buf;
 147                 struct ifbreq *ifbicu_req;
 148         } ifbic_ifbicu;
 149 #define ifbic_buf       ifbic_ifbicu.ifbicu_buf
 150 #define ifbic_req       ifbic_ifbicu.ifbicu_req
 151 };
 152
 153 /*
 154  * Bridge address request.
 155  */
 156 struct ifbareq {
 157         char            ifba_ifsname[IFNAMSIZ]; /* member if name */
 158         unsigned long   ifba_expire;            /* address expire time */
 159         uint8_t         ifba_flags;             /* address flags */
 160         uint8_t         ifba_dst[ETHER_ADDR_LEN];/* destination address */
 161 };
 162
 163 #define IFBAF_TYPEMASK  0x03    /* address type mask */
 164 #define IFBAF_DYNAMIC   0x00    /* dynamically learned address */
 165 #define IFBAF_STATIC    0x01    /* static address */
 166
 167 #define IFBAFBITS       "\020\1STATIC"
 168
 169 /*
 170  * Address list structure.
 171  */
 172 struct ifbaconf {
 173         uint32_t        ifbac_len;      /* buffer size */
 174         union {
 175                 caddr_t ifbacu_buf;
 176                 struct ifbareq *ifbacu_req;
 177         } ifbac_ifbacu;
 178 #define ifbac_buf       ifbac_ifbacu.ifbacu_buf
 179 #define ifbac_req       ifbac_ifbacu.ifbacu_req
 180 };
 181
 182 /*
 183  * Bridge parameter structure.
 184  */
 185 struct ifbrparam {
 186         union {
 187                 uint32_t ifbrpu_int32;
 188                 uint16_t ifbrpu_int16;
 189                 uint8_t ifbrpu_int8;
 190         } ifbrp_ifbrpu;
 191 };
 192 #define ifbrp_csize     ifbrp_ifbrpu.ifbrpu_int32       /* cache size */
 193 #define ifbrp_ctime     ifbrp_ifbrpu.ifbrpu_int32       /* cache time (sec) */
 194 #define ifbrp_prio      ifbrp_ifbrpu.ifbrpu_int16       /* bridge priority */
 195 #define ifbrp_hellotime ifbrp_ifbrpu.ifbrpu_int8        /* hello time (sec) */
 196 #define ifbrp_fwddelay  ifbrp_ifbrpu.ifbrpu_int8        /* fwd time (sec) */
 197 #define ifbrp_maxage    ifbrp_ifbrpu.ifbrpu_int8        /* max age (sec) */
 198 #define ifbrp_cexceeded ifbrp_ifbrpu.ifbrpu_int32       /* # of cache dropped
 199                                                          * adresses */
 200 /*
 201  * Bridge current operational parameters structure.
 202  */
 203 struct ifbropreq {
 204         uint8_t         ifbop_maxage;
 205         uint8_t         ifbop_hellotime;
 206         uint8_t         ifbop_fwddelay;
 207         uint16_t        ifbop_root_port;
 208         uint32_t        ifbop_root_path_cost;
 209         uint64_t        ifbop_designated_root;
 210         struct timeval  ifbop_last_tc_time;
 211 };
 212
 213 /*
 214  * Bridge member operational STP params structure.
 215  */
 216 struct ifbpstpreq {
 217         uint8_t         ifbp_portno;            /* bp STP port number */
 218         uint32_t        ifbp_fwd_trans;         /* bp STP fwd transitions */
 219         uint32_t        ifbp_design_cost;       /* bp STP designated cost */
 220         uint32_t        ifbp_design_port;       /* bp STP designated port */
 221         uint64_t        ifbp_design_bridge;     /* bp STP designated bridge */
 222         uint64_t        ifbp_design_root;       /* bp STP designated root */
 223 };
 224
 225 /*
 226  * Bridge STP ports list structure.
 227  */
 228 struct ifbpstpconf {
 229         uint32_t        ifbpstp_len;    /* buffer size */
 230         union {
 231                 caddr_t ifbpstpu_buf;
 232                 struct ifbpstpreq *ifbpstpu_req;
 233         } ifbpstp_ifbpstpu;
 234 #define ifbpstp_buf     ifbpstp_ifbpstpu.ifbpstpu_buf
 235 #define ifbpstp_req     ifbpstp_ifbpstpu.ifbpstpu_req
 236 };
 237
 238 #ifdef _KERNEL
 239
 240 #define BRIDGE_LOCK_INIT(_sc)           do {                    \
 241         mtx_init(&(_sc)->sc_mtx, "if_bridge", NULL, MTX_DEF);   \
 242         cv_init(&(_sc)->sc_cv, "if_bridge_cv");                 \
 243 } while (0)
 244 #define BRIDGE_LOCK_DESTROY(_sc)        do {    \
 245         mtx_destroy(&(_sc)->sc_mtx);            \
 246         cv_destroy(&(_sc)->sc_cv);              \
 247 } while (0)
 248 #define BRIDGE_LOCK(_sc)                mtx_lock(&(_sc)->sc_mtx)
 249 #define BRIDGE_UNLOCK(_sc)              mtx_unlock(&(_sc)->sc_mtx)
 250 #define BRIDGE_LOCKED(_sc)              mtx_owned(&(_sc)->sc_mtx)
 251 #define BRIDGE_LOCK_ASSERT(_sc)         mtx_assert(&(_sc)->sc_mtx, MA_OWNED)
 252 #define BRIDGE_LOCK2REF(_sc, _err)      do {    \
 253         mtx_assert(&(_sc)->sc_mtx, MA_OWNED);   \
 254         if ((_sc)->sc_iflist_xcnt > 0)          \
 255                 (_err) = EBUSY;                 \
 256         else                                    \
 257                 (_sc)->sc_iflist_ref++;         \
 258         mtx_unlock(&(_sc)->sc_mtx);             \
 259 } while (0)
 260 #define BRIDGE_UNREF(_sc)               do {                            \
 261         mtx_lock(&(_sc)->sc_mtx);                                       \
 262         (_sc)->sc_iflist_ref--;                                         \
 263         if (((_sc)->sc_iflist_xcnt > 0) && ((_sc)->sc_iflist_ref == 0)) \
 264                 cv_broadcast(&(_sc)->sc_cv);                            \
 265         mtx_unlock(&(_sc)->sc_mtx);                                     \
 266 } while (0)
 267 #define BRIDGE_XLOCK(_sc)               do {            \
 268         mtx_assert(&(_sc)->sc_mtx, MA_OWNED);           \
 269         (_sc)->sc_iflist_xcnt++;                        \
 270         while ((_sc)->sc_iflist_ref > 0)                \
 271                 cv_wait(&(_sc)->sc_cv, &(_sc)->sc_mtx); \
 272 } while (0)
 273 #define BRIDGE_XDROP(_sc)               do {    \
 274         mtx_assert(&(_sc)->sc_mtx, MA_OWNED);   \
 275         (_sc)->sc_iflist_xcnt--;                \
 276 } while (0)
 277
 278 #define BRIDGE_INPUT(_ifp, _m)          do {            \
 279         KASSERT(bridge_input_p != NULL,                 \
 280             ("%s: if_bridge not loaded!", __func__));   \
 281         _m = (*bridge_input_p)(_ifp, _m);               \
 282         if (_m != NULL)                                 \
 283                 _ifp = _m->m_pkthdr.rcvif;              \
 284 } while (0)
 285
 286 #define BRIDGE_OUTPUT(_ifp, _m, _err)   do {                    \
 287         KASSERT(bridge_output_p != NULL,                        \
 288             ("%s: if_bridge not loaded!", __func__));           \
 289         _err = (*bridge_output_p)(_ifp, _m, NULL, NULL);        \
 290 } while (0)
 291
 292 extern  struct mbuf *(*bridge_input_p)(struct ifnet *, struct mbuf *);
 293 extern  int (*bridge_output_p)(struct ifnet *, struct mbuf *,
 294                 struct sockaddr *, struct rtentry *);
 295 extern  void (*bridge_dn_p)(struct mbuf *, struct ifnet *);
 296
 297 #endif /* _KERNEL */