sys/net/if_bridgevar.h

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