share/man/man4/bridge.4

   1 .\"
   2 .\" $FreeBSD$
   3 .\"
   4 .Dd Sep 28, 1998
   5 .Dt BRIDGE 4
   6 .Os
   7 .Sh NAME
   8 .Nm bridge
   9 .Nd Bridging support
  10 .Sh DESCRIPTION
  11 Starting from version 2.2.8, FreeBSD supports bridging on ethernet-type
  12 interfaces. This is achieved using the following option
  13 .Bd -literal
  14     options BRIDGE
  15 .Ed
  16
  17 in the kernel config file, and is controlled by two
  18 .Nm sysctl
  19 variables:
  20 .Bd -literal
  21     net.link.ether.bridge
  22 .Ed
  23
  24 Set to 1 to enable bridging, set to 0 to disable it
  25 .Bd -literal
  26     net.link.ether.bridge_ipfw
  27 .Ed
  28
  29 Set to 1 to enable
  30 .Nm ipfw
  31 filtering on bridged packets. Note that
  32 .Nm ipfw
  33 rules only apply
  34 to IP packets. Non-IP packets are subject to the default
  35 .Nm ipfw
  36 rule
  37 .Pq number 65535
  38 which must be an
  39 .Ar allow
  40 rule if we want ARP and other non-IP packets to flow through the
  41 bridge.
  42
  43
  44 .Sh BUGS
  45 .Pp
  46 Care must be taken not to construct loops in the bridge topology.
  47 The kernel supports only a primitive form of loop detection, by disabling
  48 some interfaces when a loop is detected. No support for a daemon running the
  49 spanning tree algorithm is currently provided.
  50 .Pp
  51 With bridging active, interfaces are in promiscuous mode,
  52 thus causing some load on the system to receive and filter
  53 out undesired traffic.
  54 .Pp
  55 Extended functionality to enable bridging selectively on clusters
  56 of interfaces is still in the works.
  57 .Pp
  58 Not all interface support bridging -- at the moment it works for
  59 .Dq ed ,
  60 .Dq de ,
  61 .Dq ep ,
  62 .Dq fe ,
  63 .Dq fxp ,
  64 .Dq lnc ,
  65 .Dq mx ,
  66 .Dq tx ,
  67 and
  68 .Dq xl
  69 interfaces.
  70 .Sh SEE ALSO
  71 .Xr ip 4 ,
  72 .Xr ipfw 8 ,
  73 .Xr sysctl 8 .
  74 .Sh HISTORY
  75 .Nm
  76 bridging was introduced in FreeBSD 2.2.8
  77 by
  78 .An Luigi Rizzo Aq luigi@iet.unipi.it .