This commit was generated by cvs2svn to compensate for changes in r91799,

[FreeBSD/FreeBSD.git] / sys / net / bridge.c

/*
 * Copyright (c) 1998-2002 Luigi Rizzo
 *
 * Work partly supported by: Cisco Systems, Inc. - NSITE lab, RTP, NC
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 * $FreeBSD$
 */

/*
 * This code implements bridging in FreeBSD. It only acts on ethernet
 * interfaces, including VLANs (others are still usable for routing).
 * A FreeBSD host can implement multiple logical bridges, called
 * "clusters". Each cluster is made of a set of interfaces, and
 * identified by a "cluster-id" which is a number in the range 1..2^16-1.
 * 
 * Bridging is enabled by the sysctl variable
 *      net.link.ether.bridge
 * the grouping of interfaces into clusters is done with
 *      net.link.ether.bridge_cfg
 * containing a list of interfaces each optionally followed by
 * a colon and the cluster it belongs to (1 is the default).
 * Separators can be * spaces, commas or tabs, e.g.
 *      net.link.ether.bridge_cfg="fxp0:2 fxp1:2 dc0 dc1:1"
 * Optionally bridged packets can be passed through the firewall,
 * this is controlled by the variable
 *      net.link.ether.bridge_ipfw
 *
 * For each cluster there is a descriptor (cluster_softc) storing
 * the following data structures:
 * - a hash table with the MAC address and destination interface for each
 *   known node. The table is indexed using a hash of the source address.
 * - an array with the MAC addresses of the interfaces used in the cluster.
 *
 * Input packets are tapped near the beginning of ether_input(), and
 * analysed by bridge_in(). Depending on the result, the packet
 * can be forwarded to one or more output interfaces using bdg_forward(),
 * and/or sent to the upper layer (e.g. in case of multicast).
 *
 * Output packets are intercepted near the end of ether_output().
 * The correct destination is selected by bridge_dst_lookup(),
 * and then forwarding is done by bdg_forward().
 *
 * The arp code is also modified to let a machine answer to requests
 * irrespective of the port the request came from.
 *
 * In case of loops in the bridging topology, the bridge detects this
 * event and temporarily mutes output bridging on one of the ports.
 * Periodically, interfaces are unmuted by bdg_timeout().
 * Muting is only implemented as a safety measure, and also as
 * a mechanism to support a user-space implementation of the spanning
 * tree algorithm.
 *
 * To build a bridging kernel, use the following option
 *    option BRIDGE
 * and then at runtime set the sysctl variable to enable bridging.
 *
 * Only one interface per cluster is supposed to have addresses set (but
 * there are no substantial problems if you set addresses for none or
 * for more than one interface).
 * Bridging will act before routing, but nothing prevents a machine
 * from doing both (modulo bugs in the implementation...).
 *
 * THINGS TO REMEMBER
 *  - bridging is incompatible with multicast routing on the same
 *    machine. There is not an easy fix to this.
 *  - be very careful when bridging VLANs
 *  - loop detection is still not very robust.
 */

#include <sys/param.h>
#include <sys/mbuf.h>
#include <sys/malloc.h>
#include <sys/systm.h>
#include <sys/socket.h> /* for net/if.h */
#include <sys/ctype.h>  /* string functions */
#include <sys/kernel.h>
#include <sys/sysctl.h>

#include <net/if.h>
#include <net/if_types.h>

#include <netinet/in.h> /* for struct arpcom */
#include <netinet/in_systm.h>
#include <netinet/in_var.h>
#include <netinet/ip.h>
#include <netinet/if_ether.h> /* for struct arpcom */

#include <net/route.h>
#include <netinet/ip_fw.h>
#include <netinet/ip_dummynet.h>
#include <net/bridge.h>

/*--------------------*/

/*
 * For each cluster, source MAC addresses are stored into a hash
 * table which locates the port they reside on.
 */
#define HASH_SIZE 8192  /* Table size, must be a power of 2 */

typedef struct hash_table {             /* each entry.          */
    struct ifnet *      name;
    u_char              etheraddr[6];
    u_int16_t           used;           /* also, padding        */
} bdg_hash_table ;

/*
 * The hash function applied to MAC addresses. Out of the 6 bytes,
 * the last ones tend to vary more. Since we are on a little endian machine,
 * we have to do some gimmick...
 */
#define HASH_FN(addr)   (       \
    ntohs( ((u_int16_t *)addr)[1] ^ ((u_int16_t *)addr)[2] ) & (HASH_SIZE -1))

/*
 * This is the data structure where local addresses are stored.
 */
struct bdg_addr {
    u_char      etheraddr[6] ;
    u_int16_t   _padding ;
};

/*
 * The configuration of each cluster includes the cluster id, a pointer to
 * the hash table, and an array of local MAC addresses (of size "ports").
 */
struct cluster_softc {
    u_int16_t   cluster_id;
    u_int16_t   ports;
    bdg_hash_table *ht;
    struct bdg_addr     *my_macs;       /* local MAC addresses */
};


static int n_clusters;                          /* number of clusters */
static struct cluster_softc *clusters;

#define BDG_MUTED(ifp) (ifp2sc[ifp->if_index].flags & IFF_MUTE)
#define BDG_MUTE(ifp) ifp2sc[ifp->if_index].flags |= IFF_MUTE
#define BDG_CLUSTER(ifp) (ifp2sc[ifp->if_index].cluster)

#define BDG_SAMECLUSTER(ifp,src) \
        (src == NULL || BDG_CLUSTER(ifp) == BDG_CLUSTER(src) )

#ifdef __i386__
#define BDG_MATCH(a,b) ( \
    ((u_int16_t *)(a))[2] == ((u_int16_t *)(b))[2] && \
    *((u_int32_t *)(a)) == *((u_int32_t *)(b)) )
#define IS_ETHER_BROADCAST(a) ( \
        *((u_int32_t *)(a)) == 0xffffffff && \
        ((u_int16_t *)(a))[2] == 0xffff )
#else
/* for machines that do not support unaligned access */
#define BDG_MATCH(a,b)          (!bcmp(a, b, ETHER_ADDR_LEN) )
#define IS_ETHER_BROADCAST(a)   (!bcmp(a, "\377\377\377\377\377\377", 6))
#endif


/*
 * For timing-related debugging, you can use the following macros.
 * remember, rdtsc() only works on Pentium-class machines

    quad_t ticks;
    DDB(ticks = rdtsc();)
    ... interesting code ...
    DDB(bdg_fw_ticks += (u_long)(rdtsc() - ticks) ; bdg_fw_count++ ;)

 *
 */

#define DDB(x) x
#define DEB(x)

static int bdginit(void);
static void parse_bdg_cfg(void);

static int bdg_ipfw = 0 ;

#if 0 /* debugging only */
static char *bdg_dst_names[] = {
        "BDG_NULL    ",
        "BDG_BCAST   ",
        "BDG_MCAST   ",
        "BDG_LOCAL   ",
        "BDG_DROP    ",
        "BDG_UNKNOWN ",
        "BDG_IN      ",
        "BDG_OUT     ",
        "BDG_FORWARD " };
#endif
/*
 * System initialization
 */

static struct bdg_stats bdg_stats ;
static struct callout_handle bdg_timeout_h ;

/*
 * Add an interface to a cluster, possibly creating a new entry in
 * the cluster table. This requires reallocation of the table and
 * updating pointers in ifp2sc.
 */
static struct cluster_softc *
add_cluster(u_int16_t cluster_id, struct arpcom *ac)
{
    struct cluster_softc *c = NULL;
    int i;

    for (i = 0; i < n_clusters ; i++)
        if (clusters[i].cluster_id == cluster_id)
            goto found;

    /* Not found, need to reallocate */
    c = malloc((1+n_clusters) * sizeof (*c), M_IFADDR, M_DONTWAIT | M_ZERO);
    if (c == NULL) {/* malloc failure */
        printf("-- bridge: cannot add new cluster\n");
        return NULL;
    }
    c[n_clusters].ht = (struct hash_table *)
            malloc(HASH_SIZE * sizeof(struct hash_table),
                M_IFADDR, M_WAITOK | M_ZERO);
    if (c[n_clusters].ht == NULL) {
        printf("-- bridge: cannot allocate hash table for new cluster\n");
        free(c, M_IFADDR);
        return NULL;
    }
    c[n_clusters].my_macs = (struct bdg_addr *)
            malloc(BDG_MAX_PORTS * sizeof(struct bdg_addr),
                M_IFADDR, M_WAITOK | M_ZERO);
    if (c[n_clusters].my_macs == NULL) {
        printf("-- bridge: cannot allocate mac addr table for new cluster\n");
        free(c[n_clusters].ht, M_IFADDR);
        free(c, M_IFADDR);
        return NULL;
    }

    c[n_clusters].cluster_id = cluster_id;
    c[n_clusters].ports = 0;
    /*
     * now copy old descriptors here
     */
    if (n_clusters > 0) {
        for (i=0; i < n_clusters; i++)
            c[i] = clusters[i];
        /*
         * and finally update pointers in ifp2sc
         */
        for (i = 0 ; i < if_index && i < BDG_MAX_PORTS; i++)
            if (ifp2sc[i].cluster != NULL)
                ifp2sc[i].cluster = c + (ifp2sc[i].cluster - clusters);
        free(clusters, M_IFADDR);
    }
    clusters = c;
    i = n_clusters;             /* index of cluster entry */
    n_clusters++;
found:
    c = clusters + i;           /* the right cluster ... */
    bcopy(ac->ac_enaddr, &(c->my_macs[c->ports]), 6);
    c->ports++;
    return c;
}


/*
 * Turn off bridging, by clearing promisc mode on the interface,
 * marking the interface as unused, and clearing the name in the
 * stats entry.
 * Also dispose the hash tables associated with the clusters.
 */
static void
bridge_off(void)
{
    struct ifnet *ifp ;
    int i, s;

    DEB(printf("bridge_off: n_clusters %d\n", n_clusters);)
    TAILQ_FOREACH(ifp, &ifnet, if_link) {
        struct bdg_softc *b;

        if (ifp->if_index >= BDG_MAX_PORTS)
            continue;   /* make sure we do not go beyond the end */
        b = &(ifp2sc[ifp->if_index]);

        if ( b->flags & IFF_BDG_PROMISC ) {
            s = splimp();
            ifpromisc(ifp, 0);
            splx(s);
            b->flags &= ~(IFF_BDG_PROMISC|IFF_MUTE) ;
            DEB(printf(">> now %s%d promisc OFF if_flags 0x%x bdg_flags 0x%x\n",
                    ifp->if_name, ifp->if_unit,
                    ifp->if_flags, b->flags);)
        }
        b->flags &= ~(IFF_USED) ;
        b->cluster = NULL;
        bdg_stats.s[ifp->if_index].name[0] = '\0';
    }
    /* flush_tables */

    s = splimp();
    for (i=0; i < n_clusters; i++) {
        free(clusters[i].ht, M_IFADDR);
        free(clusters[i].my_macs, M_IFADDR);
    }
    if (clusters != NULL)
        free(clusters, M_IFADDR);
    clusters = NULL;
    n_clusters =0;
    splx(s);
}

/*
 * set promisc mode on the interfaces we use.
 */
static void
bridge_on(void)
{
    struct ifnet *ifp ;
    int s ;

    TAILQ_FOREACH(ifp, &ifnet, if_link) {
        struct bdg_softc *b = &ifp2sc[ifp->if_index];

        if ( !(b->flags & IFF_USED) )
            continue ;
        if ( !( ifp->if_flags & IFF_UP) ) {
            s = splimp();
            if_up(ifp);
            splx(s);
        }
        if ( !(b->flags & IFF_BDG_PROMISC) ) {
            int ret ;
            s = splimp();
            ret = ifpromisc(ifp, 1);
            splx(s);
            b->flags |= IFF_BDG_PROMISC ;
            DEB(printf(">> now %s%d promisc ON if_flags 0x%x bdg_flags 0x%x\n",
                    ifp->if_name, ifp->if_unit,
                    ifp->if_flags, b->flags);)
        }
        if (b->flags & IFF_MUTE) {
            DEB(printf(">> unmuting %s%d\n", ifp->if_name, ifp->if_unit);)
            b->flags &= ~IFF_MUTE;
        }
    }
}

/**
 * reconfigure bridge.
 * This is also done every time we attach or detach an interface.
 * Main use is to make sure that we do not bridge on some old
 * (ejected) device. So, it would be really useful to have a
 * pointer to the modified device as an argument. Without it, we
 * have to scan all interfaces.
 */
static void
reconfigure_bridge(void)
{
    bridge_off();
    if (do_bridge) {
        if (if_index >= BDG_MAX_PORTS) {
            printf("-- sorry too many interfaces (%d, max is %d),"
                " disabling bridging\n", if_index, BDG_MAX_PORTS);
            do_bridge=0;
            return;
        }
        parse_bdg_cfg();
        bridge_on();
    }
}

static char bridge_cfg[1024] = { "" } ;

/*
 * parse the config string, set IFF_USED, name and cluster_id
 * for all interfaces found.
 * The config string is a list of "if[:cluster]" with
 * a number of possible separators (see "sep"). In particular the
 * use of the space lets you set bridge_cfg with the output from
 * "ifconfig -l"
 */
static void
parse_bdg_cfg()
{
    char *p, *beg ;
    int l, cluster;
    static char *sep = ", \t";

    for (p = bridge_cfg; *p ; p++) {
        struct ifnet *ifp;
        int found = 0;
        char c;

        if (index(sep, *p))     /* skip separators */
            continue ;
        /* names are lowercase and digits */
        for ( beg = p ; islower(*p) || isdigit(*p) ; p++ )
            ;
        l = p - beg ;           /* length of name string */
        if (l == 0)             /* invalid name */
            break ;
        if ( *p != ':' )        /* no ':', assume default cluster 1 */
            cluster = 1 ;
        else                    /* fetch cluster */
            cluster = strtoul( p+1, &p, 10);
        c = *p;
        *p = '\0';
        /*
         * now search in interface list for a matching name
         */
        TAILQ_FOREACH(ifp, &ifnet, if_link) {
            char buf[32];

            sprintf(buf, "%s%d", ifp->if_name, ifp->if_unit);
            if (!strncmp(beg, buf, l)) {
                struct bdg_softc *b = &ifp2sc[ifp->if_index];
                if (ifp->if_type != IFT_ETHER && ifp->if_type != IFT_L2VLAN) {
                    printf("%s is not an ethernet, continue\n", buf);
                    continue;
                }
                if (b->flags & IFF_USED) {
                    printf("%s already used, skipping\n", buf);
                    break;
                }
                b->cluster = add_cluster(htons(cluster), (struct arpcom *)ifp);
                b->flags |= IFF_USED ;
                sprintf(bdg_stats.s[ifp->if_index].name,
                        "%s%d:%d", ifp->if_name, ifp->if_unit, cluster);

                DEB(printf("--++  found %s next c %d\n",
                    bdg_stats.s[ifp->if_index].name, c);)
                found = 1;
                break ;
            }
        }
        if (!found)
            printf("interface %s Not found in bridge\n", beg);
        *p = c;
        if (c == '\0')
            break; /* no more */
    }
}


/*
 * handler for net.link.ether.bridge
 */
static int
sysctl_bdg(SYSCTL_HANDLER_ARGS)
{
    int error, oldval = do_bridge ;

    error = sysctl_handle_int(oidp, oidp->oid_arg1, oidp->oid_arg2, req);
    DEB( printf("called sysctl for bridge name %s arg2 %d val %d->%d\n",
        oidp->oid_name, oidp->oid_arg2,
        oldval, do_bridge); )

    if (oldval != do_bridge)
        reconfigure_bridge();
    return error ;
}

/*
 * handler for net.link.ether.bridge_cfg
 */
static int
sysctl_bdg_cfg(SYSCTL_HANDLER_ARGS)
{
    int error = 0 ;
    char old_cfg[1024] ;

    strcpy(old_cfg, bridge_cfg) ;

    error = sysctl_handle_string(oidp, bridge_cfg, oidp->oid_arg2, req);
    DEB(
        printf("called sysctl for bridge name %s arg2 %d err %d val %s->%s\n",
                oidp->oid_name, oidp->oid_arg2,
                error,
                old_cfg, bridge_cfg);
        )
    if (strcmp(old_cfg, bridge_cfg))
        reconfigure_bridge();
    return error ;
}

static int
sysctl_refresh(SYSCTL_HANDLER_ARGS)
{
    if (req->newptr)
        reconfigure_bridge();
    
    return 0;
}


SYSCTL_DECL(_net_link_ether);
SYSCTL_PROC(_net_link_ether, OID_AUTO, bridge_cfg, CTLTYPE_STRING|CTLFLAG_RW,
            &bridge_cfg, sizeof(bridge_cfg), &sysctl_bdg_cfg, "A",
            "Bridge configuration");

SYSCTL_PROC(_net_link_ether, OID_AUTO, bridge, CTLTYPE_INT|CTLFLAG_RW,
            &do_bridge, 0, &sysctl_bdg, "I", "Bridging");

SYSCTL_INT(_net_link_ether, OID_AUTO, bridge_ipfw, CTLFLAG_RW,
            &bdg_ipfw,0,"Pass bridged pkts through firewall");

/*
 * The follow macro declares a variable, and maps it to
 * a SYSCTL_INT entry with the same name.
 */
#define SY(parent, var, comment)                        \
        static int var ;                                \
        SYSCTL_INT(parent, OID_AUTO, var, CTLFLAG_RW, &(var), 0, comment);

int bdg_ipfw_drops;
SYSCTL_INT(_net_link_ether, OID_AUTO, bridge_ipfw_drop,
        CTLFLAG_RW, &bdg_ipfw_drops,0,"");

int bdg_ipfw_colls;
SYSCTL_INT(_net_link_ether, OID_AUTO, bridge_ipfw_collisions,
        CTLFLAG_RW, &bdg_ipfw_colls,0,"");

SYSCTL_PROC(_net_link_ether, OID_AUTO, bridge_refresh, CTLTYPE_INT|CTLFLAG_WR,
            NULL, 0, &sysctl_refresh, "I", "iface refresh");

#if 1 /* diagnostic vars */

SY(_net_link_ether, verbose, "Be verbose");
SY(_net_link_ether, bdg_split_pkts, "Packets split in bdg_forward");

SY(_net_link_ether, bdg_thru, "Packets through bridge");

SY(_net_link_ether, bdg_copied, "Packets copied in bdg_forward");

SY(_net_link_ether, bdg_copy, "Force copy in bdg_forward");
SY(_net_link_ether, bdg_predict, "Correctly predicted header location");

SY(_net_link_ether, bdg_fw_avg, "Cycle counter avg");
SY(_net_link_ether, bdg_fw_ticks, "Cycle counter item");
SY(_net_link_ether, bdg_fw_count, "Cycle counter count");
#endif

SYSCTL_STRUCT(_net_link_ether, PF_BDG, bdgstats,
        CTLFLAG_RD, &bdg_stats , bdg_stats, "bridge statistics");

static int bdg_loops ;

/*
 * called periodically to flush entries etc.
 */
static void
bdg_timeout(void *dummy)
{
    static int slowtimer = 0 ;

    if (do_bridge) {
        static int age_index = 0 ; /* index of table position to age */
        int l = age_index + HASH_SIZE/4 ;
        int i;
        /*
         * age entries in the forwarding table.
         */
        if (l > HASH_SIZE)
            l = HASH_SIZE ;

    for (i=0; i<n_clusters; i++) {
        bdg_hash_table *bdg_table = clusters[i].ht;
        for (; age_index < l ; age_index++)
            if (bdg_table[age_index].used)
                bdg_table[age_index].used = 0 ;
            else if (bdg_table[age_index].name) {
                /* printf("xx flushing stale entry %d\n", age_index); */
                bdg_table[age_index].name = NULL ;
            }
    }
        if (age_index >= HASH_SIZE)
            age_index = 0 ;

        if (--slowtimer <= 0 ) {
            slowtimer = 5 ;

            bridge_on() ; /* we just need unmute, really */
            bdg_loops = 0 ;
        }
    }
    bdg_timeout_h = timeout(bdg_timeout, NULL, 2*hz );
}

/*
 * Find the right pkt destination:
 *      BDG_BCAST       is a broadcast
 *      BDG_MCAST       is a multicast
 *      BDG_LOCAL       is for a local address
 *      BDG_DROP        must be dropped
 *      other           ifp of the dest. interface (incl.self)
 *
 * We assume this is only called for interfaces for which bridging
 * is enabled, i.e. BDG_USED(ifp) is true.
 */
static __inline
struct ifnet *
bridge_dst_lookup(struct ether_header *eh, struct cluster_softc *c)
{
    struct ifnet *dst ;
    int index ;
    struct bdg_addr *p ;
    bdg_hash_table *bt;         /* pointer to entry in hash table */

    if (IS_ETHER_BROADCAST(eh->ether_dhost))
        return BDG_BCAST ;
    if (eh->ether_dhost[0] & 1)
        return BDG_MCAST ;
    /*
     * Lookup local addresses in case one matches.
     */
    for (index = c->ports, p = c->my_macs; index ; index--, p++ )
        if (BDG_MATCH(p->etheraddr, eh->ether_dhost) )
            return BDG_LOCAL ;
    /*
     * Look for a possible destination in table
     */
    index= HASH_FN( eh->ether_dhost );
    bt = &(c->ht[index]);
    dst = bt->name;
    if ( dst && BDG_MATCH( bt->etheraddr, eh->ether_dhost) )
        return dst ;
    else
        return BDG_UNKNOWN ;
}

/**
 * bridge_in() is invoked to perform bridging decision on input packets.
 *
 * On Input:
 *   eh         Ethernet header of the incoming packet.
 *   ifp        interface the packet is coming from.
 *
 * On Return: destination of packet, one of
 *   BDG_BCAST  broadcast
 *   BDG_MCAST  multicast
 *   BDG_LOCAL  is only for a local address (do not forward)
 *   BDG_DROP   drop the packet
 *   ifp        ifp of the destination interface.
 *
 * Forwarding is not done directly to give a chance to some drivers
 * to fetch more of the packet, or simply drop it completely.
 */

static struct ifnet *
bridge_in(struct ifnet *ifp, struct ether_header *eh)
{
    int index;
    struct ifnet *dst , *old ;
    bdg_hash_table *bt;                 /* location in hash table */
    int dropit = BDG_MUTED(ifp) ;

    /*
     * hash the source address
     */
    index= HASH_FN(eh->ether_shost);
    bt = &(ifp2sc[ifp->if_index].cluster->ht[index]);
    bt->used = 1 ;
    old = bt->name ;
    if ( old ) { /* the entry is valid. */
        if (!BDG_MATCH( eh->ether_shost, bt->etheraddr) ) {
            bdg_ipfw_colls++ ;
            bt->name = NULL ;
        } else if (old != ifp) {
            /*
             * Found a loop. Either a machine has moved, or there
             * is a misconfiguration/reconfiguration of the network.
             * First, do not forward this packet!
             * Record the relocation anyways; then, if loops persist,
             * suspect a reconfiguration and disable forwarding
             * from the old interface.
             */
            bt->name = ifp ; /* relocate address */
            printf("-- loop (%d) %6D to %s%d from %s%d (%s)\n",
                        bdg_loops, eh->ether_shost, ".",
                        ifp->if_name, ifp->if_unit,
                        old->if_name, old->if_unit,
                        BDG_MUTED(old) ? "muted":"active");
            dropit = 1 ;
            if ( !BDG_MUTED(old) ) {
                if (++bdg_loops > 10)
                    BDG_MUTE(old) ;
            }
        }
    }

    /*
     * now write the source address into the table
     */
    if (bt->name == NULL) {
        DEB(printf("new addr %6D at %d for %s%d\n",
            eh->ether_shost, ".", index, ifp->if_name, ifp->if_unit);)
        bcopy(eh->ether_shost, bt->etheraddr, 6);
        bt->name = ifp ;
    }
    dst = bridge_dst_lookup(eh, ifp2sc[ifp->if_index].cluster);
    /*
     * bridge_dst_lookup can return the following values:
     *   BDG_BCAST, BDG_MCAST, BDG_LOCAL, BDG_UNKNOWN, BDG_DROP, ifp.
     * For muted interfaces, or when we detect a loop, the first 3 are
     * changed in BDG_LOCAL (we still listen to incoming traffic),
     * and others to BDG_DROP (no use for the local host).
     * Also, for incoming packets, ifp is changed to BDG_DROP if ifp == src.
     * These changes are not necessary for outgoing packets from ether_output().
     */
    BDG_STAT(ifp, BDG_IN);
    switch ((uintptr_t)dst) {
    case (uintptr_t)BDG_BCAST:
    case (uintptr_t)BDG_MCAST:
    case (uintptr_t)BDG_LOCAL:
    case (uintptr_t)BDG_UNKNOWN:
    case (uintptr_t)BDG_DROP:
        BDG_STAT(ifp, dst);
        break ;
    default :
        if (dst == ifp || dropit)
            BDG_STAT(ifp, BDG_DROP);
        else
            BDG_STAT(ifp, BDG_FORWARD);
        break ;
    }

    if ( dropit ) {
        if (dst == BDG_BCAST || dst == BDG_MCAST || dst == BDG_LOCAL)
            dst = BDG_LOCAL ;
        else
            dst = BDG_DROP ;
    } else {
        if (dst == ifp)
            dst = BDG_DROP;
    }
    DEB(printf("bridge_in %6D ->%6D ty 0x%04x dst %s%d\n",
        eh->ether_shost, ".",
        eh->ether_dhost, ".",
        ntohs(eh->ether_type),
        (dst <= BDG_FORWARD) ? bdg_dst_names[(int)dst] :
                dst->if_name,
        (dst <= BDG_FORWARD) ? 0 : dst->if_unit); )

    return dst ;
}

/*
 * Forward a packet to dst -- which can be a single interface or
 * an entire cluster. The src port and muted interfaces are excluded.
 *
 * If src == NULL, the pkt comes from ether_output, and dst is the real
 * interface the packet is originally sent to. In this case, we must forward
 * it to the whole cluster.
 * We never call bdg_forward from ether_output on interfaces which are
 * not part of a cluster.
 *
 * If possible (i.e. we can determine that the caller does not need
 * a copy), the packet is consumed here, and bdg_forward returns NULL.
 * Otherwise, a pointer to a copy of the packet is returned.
 *
 * XXX be careful with eh, it can be a pointer into *m
 */
static struct mbuf *
bdg_forward(struct mbuf *m0, struct ether_header *const eh, struct ifnet *dst)
{
    struct ifnet *src = m0->m_pkthdr.rcvif; /* NULL when called by *_output */
    struct ifnet *ifp, *last = NULL ;
    int shared = bdg_copy ; /* someone else is using the mbuf */
    int once = 0;      /* loop only once */
    struct ifnet *real_dst = dst ; /* real dst from ether_output */
    struct ip_fw *rule = NULL ; /* did we match a firewall rule ? */

    /*
     * XXX eh is usually a pointer within the mbuf (some ethernet drivers
     * do that), so we better copy it before doing anything with the mbuf,
     * or we might corrupt the header.
     */
    struct ether_header save_eh = *eh ;

    DEB(quad_t ticks; ticks = rdtsc();)

    if (m0->m_type == MT_DUMMYNET) {
        /* extract info from dummynet header */
        rule = (struct ip_fw *)(m0->m_data) ;
        m0 = m0->m_next ;
        src = m0->m_pkthdr.rcvif;
        shared = 0 ; /* For sure this is our own mbuf. */
    } else
        bdg_thru++; /* count packet, only once */

    if (src == NULL) /* packet from ether_output */
        dst = bridge_dst_lookup(eh, ifp2sc[real_dst->if_index].cluster);

    if (dst == BDG_DROP) { /* this should not happen */
        printf("xx bdg_forward for BDG_DROP\n");
        m_freem(m0);
        return NULL;
    }
    if (dst == BDG_LOCAL) { /* this should not happen as well */
        printf("xx ouch, bdg_forward for local pkt\n");
        return m0;
    }
    if (dst == BDG_BCAST || dst == BDG_MCAST || dst == BDG_UNKNOWN) {
        ifp = TAILQ_FIRST(&ifnet) ; /* scan all ports */
        once = 0 ;
        if (dst != BDG_UNKNOWN) /* need a copy for the local stack */
            shared = 1 ;
    } else {
        ifp = dst ;
        once = 1 ;
    }
    if ( (u_int)(ifp) <= (u_int)BDG_FORWARD )
        panic("bdg_forward: bad dst");

    /*
     * Do filtering in a very similar way to what is done in ip_output.
     * Only if firewall is loaded, enabled, and the packet is not
     * from ether_output() (src==NULL, or we would filter it twice).
     * Additional restrictions may apply e.g. non-IP, short packets,
     * and pkts already gone through a pipe.
     */
    if (IPFW_LOADED && bdg_ipfw != 0 && src != NULL) {
        struct ip *ip ;
        int i;

        if (rule != NULL) /* dummynet packet, already partially processed */
            goto forward; /* HACK! I should obey the fw_one_pass */
        if (ntohs(save_eh.ether_type) != ETHERTYPE_IP)
            goto forward ; /* not an IP packet, ipfw is not appropriate */
        if (m0->m_pkthdr.len < sizeof(struct ip) )
            goto forward ; /* header too short for an IP pkt, cannot filter */
        /*
         * i need some amt of data to be contiguous, and in case others need
         * the packet (shared==1) also better be in the first mbuf.
         */
        i = min(m0->m_pkthdr.len, max_protohdr) ;
        if ( shared || m0->m_len < i) {
            m0 = m_pullup(m0, i) ;
            if (m0 == NULL) {
                printf("-- bdg: pullup failed.\n") ;
                return NULL ;
            }
        }

        /*
         * before calling the firewall, swap fields the same as IP does.
         * here we assume the pkt is an IP one and the header is contiguous
         */
        ip = mtod(m0, struct ip *);
        ip->ip_len = ntohs(ip->ip_len);
        ip->ip_off = ntohs(ip->ip_off);

        /*
         * The third parameter to the firewall code is the dst. interface.
         * Since we apply checks only on input pkts we use NULL.
         * The firewall knows this is a bridged packet as the cookie ptr
         * is NULL.
         */
        i = ip_fw_chk_ptr(&ip, 0, NULL, NULL /* cookie */, &m0, &rule, NULL);
        if ( (i & IP_FW_PORT_DENY_FLAG) || m0 == NULL) /* drop */
            return m0 ;
        /*
         * If we get here, the firewall has passed the pkt, but the mbuf
         * pointer might have changed. Restore ip and the fields ntohs()'d.
         */
        ip = mtod(m0, struct ip *);
        ip->ip_len = htons(ip->ip_len);
        ip->ip_off = htons(ip->ip_off);

        if (i == 0) /* a PASS rule.  */
            goto forward ;
        if (DUMMYNET_LOADED && (i & IP_FW_PORT_DYNT_FLAG)) {
            /*
             * Pass the pkt to dummynet, which consumes it.
             * If shared, make a copy and keep the original.
             * Need to prepend the ethernet header, optimize the common
             * case of eh pointing already into the original mbuf.
             */
            struct mbuf *m ;
            if (shared) {
                m = m_copypacket(m0, M_DONTWAIT);
                if (m == NULL) {
                    printf("bdg_fwd: copy(1) failed\n");
                    return m0;
                }
            } else {
                m = m0 ; /* pass the original to dummynet */
                m0 = NULL ; /* and nothing back to the caller */
            }
            if ( (void *)(eh + 1) == (void *)m->m_data) {
                m->m_data -= ETHER_HDR_LEN ;
                m->m_len += ETHER_HDR_LEN ;
                m->m_pkthdr.len += ETHER_HDR_LEN ;
                bdg_predict++;
            } else {
                M_PREPEND(m, ETHER_HDR_LEN, M_DONTWAIT);
                if (!m && verbose)
                    printf("M_PREPEND failed\n");
                if (m == NULL) /* nope... */
                    return m0 ;
                bcopy(&save_eh, mtod(m, struct ether_header *), ETHER_HDR_LEN);
            }
            ip_dn_io_ptr((i & 0xffff),DN_TO_BDG_FWD,m,real_dst,NULL,0,rule,0);
            return m0 ;
        }
        /*
         * XXX add divert/forward actions...
         */
        /* if none of the above matches, we have to drop the pkt */
        bdg_ipfw_drops++ ;
        printf("bdg_forward: No rules match, so dropping packet!\n");
        return m0 ;
    }
forward:
    /*
     * Again, bring up the headers in case of shared bufs to avoid
     * corruptions in the future.
     */
    if ( shared ) {
        int i = min(m0->m_pkthdr.len, max_protohdr) ;

        m0 = m_pullup(m0, i) ;
        if (m0 == NULL) {
            printf("-- bdg: pullup2 failed.\n") ;
            return NULL ;
        }
    }
    /* now real_dst is used to determine the cluster where to forward */
    if (src != NULL) /* pkt comes from ether_input */
        real_dst = src ;
    for (;;) {
        if (last) { /* need to forward packet leftover from previous loop */
            struct mbuf *m ;
            if (shared == 0 && once ) { /* no need to copy */
                m = m0 ;
                m0 = NULL ; /* original is gone */
            } else {
                m = m_copypacket(m0, M_DONTWAIT);
                if (m == NULL) {
                    printf("bdg_forward: sorry, m_copypacket failed!\n");
                    return m0 ; /* the original is still there... */
                }
            }
            /*
             * Add header (optimized for the common case of eh pointing
             * already into the mbuf) and execute last part of ether_output:
             * queue pkt and start output if interface not yet active.
             */
            if ( (void *)(eh + 1) == (void *)m->m_data) {
                m->m_data -= ETHER_HDR_LEN ;
                m->m_len += ETHER_HDR_LEN ;
                m->m_pkthdr.len += ETHER_HDR_LEN ;
                bdg_predict++;
            } else {
                M_PREPEND(m, ETHER_HDR_LEN, M_DONTWAIT);
                if (!m && verbose)
                    printf("M_PREPEND failed\n");
                if (m == NULL)
                    return m0;
                bcopy(&save_eh, mtod(m, struct ether_header *), ETHER_HDR_LEN);
            }
            if (!IF_HANDOFF(&last->if_snd, m, last)) {
#if 0
                BDG_MUTE(last); /* should I also mute ? */
#endif
            }
            BDG_STAT(last, BDG_OUT);
            last = NULL ;
            if (once)
                break ;
        }
        if (ifp == NULL)
            break ;
        /*
         * If the interface is used for bridging, not muted, not full,
         * up and running, is not the source interface, and belongs to
         * the same cluster as the 'real_dst', then send here.
         */
        if ( BDG_USED(ifp) && !BDG_MUTED(ifp) && !_IF_QFULL(&ifp->if_snd)  &&
             (ifp->if_flags & (IFF_UP|IFF_RUNNING)) == (IFF_UP|IFF_RUNNING) &&
             ifp != src && BDG_SAMECLUSTER(ifp, real_dst) )
            last = ifp ;
        ifp = TAILQ_NEXT(ifp, if_link) ;
        if (ifp == NULL)
            once = 1 ;
    }
    DEB(bdg_fw_ticks += (u_long)(rdtsc() - ticks) ; bdg_fw_count++ ;
        if (bdg_fw_count != 0) bdg_fw_avg = bdg_fw_ticks/bdg_fw_count; )
    return m0 ;
}

/*
 * initialization of bridge code.
 */
static int
bdginit(void)
{
    printf("BRIDGE 020214 loaded\n");

    ifp2sc = malloc(BDG_MAX_PORTS * sizeof(struct bdg_softc),
                M_IFADDR, M_WAITOK | M_ZERO );
    if (ifp2sc == NULL)
        return ENOMEM ;

    bridge_in_ptr = bridge_in;
    bdg_forward_ptr = bdg_forward;
    bdgtakeifaces_ptr = reconfigure_bridge;

    n_clusters = 0;
    clusters = NULL;
    do_bridge=0;

    bzero(&bdg_stats, sizeof(bdg_stats) );
    bdgtakeifaces_ptr();
    bdg_timeout(0);
    return 0 ;
}

/*
 * initialization code, both for static and dynamic loading.
 */
static int
bridge_modevent(module_t mod, int type, void *unused)
{
        int s;
        int err = 0 ;

        switch (type) {
        case MOD_LOAD:
                if (BDG_LOADED) {
                        err = EEXIST;
                        break ;
                }
                s = splimp();
                err = bdginit();
                splx(s);
                break;
        case MOD_UNLOAD:
#if !defined(KLD_MODULE)
                printf("bridge statically compiled, cannot unload\n");
                err = EINVAL ;
#else
                s = splimp();
                do_bridge = 0;
                bridge_in_ptr = NULL;
                bdg_forward_ptr = NULL;
                bdgtakeifaces_ptr = NULL;
                untimeout(bdg_timeout, NULL, bdg_timeout_h);
                bridge_off();
                if (clusters)
                    free(clusters, M_IFADDR);
                free(ifp2sc, M_IFADDR);
                ifp2sc = NULL ;
                splx(s);
#endif
                break;
        default:
                err = EINVAL ;
                break;
        }
        return err;
}

static moduledata_t bridge_mod = {
        "bridge",
        bridge_modevent,
        0
};

DECLARE_MODULE(bridge, bridge_mod, SI_SUB_PSEUDO, SI_ORDER_ANY);
MODULE_VERSION(bridge, 1);