man/grml-bridge.8

   1 .TH grml-bridge 8
   2 .SH "NAME"
   3 grml-bridge \- set up your box as bridge
   4 .SH SYNOPSIS
   5 .B grml-bridge
   6 .RI " start|stop|restart|info "
   7 .SH DESCRIPTION
   8 This manual page documents briefly the
   9 .B grml-bridge
  10 command.
  11 .SH USAGE
  12 Configure setup via configuration file /etc/grml/routersetup.
  13 To specify which DEVICES should be bridged, use BRIDGE_DEVICES, e.g.
  14
  15   BRIDGE_DEVICES="eth0 eth2"
  16
  17 would bridge device eth0 and eth2.
  18 If unconfigured then 'eth0 eth1' is assumed as default.
  19 Note: The auto interface name is not allowed here!
  20
  21 To specify the name of the bridge, use BRIDGE_NAME, e.g.
  22
  23   BRIDGE_NAME="br0"
  24
  25 Note: this entry is optional, per default the name br0 is chosen.
  26
  27 If you want do disable Spanning Tree Protocol (STP) on your bridge, just set BRIDGE_STP to no, e.g.
  28
  29   BRIDGE_STP="no"
  30
  31 Per default STP is set to 'on'.
  32
  33 Example Configuration file:
  34
  35   ,----[ /etc/grml/routersetup ]
  36   | # Bridges eth0 and ath0 together
  37   | BRIDGE_DEVICES="eth0 ath0"
  38   |
  39   | # Bridge name is grml-bridge
  40   | BRIDGE_NAME="grml-bridge"
  41   |
  42   | # Disable stp
  43   | BRIDGE_STP="no"
  44   `----
  45
  46 Start the bridge:
  47
  48   ,----
  49   | # grml-bridge start
  50   `----
  51
  52 Now, your bridging device is up and running. Now you have to set the ip address of
  53 your bridged devices to 0.0.0.0. You can do this with following command:
  54
  55   ,----
  56   | source /etc/grml/routersetup
  57   | for i in $BRIDGED_DEVICES ; do ifconfig $i 0.0.0.0 ; done
  58   `----
  59
  60 Now your bridge is working. If you want that your bridge is reachable, please
  61 give your bridge an IP address. You can do this for example with
  62
  63   ,----
  64   | ifconfig grml-bridge 192.168.0.1
  65   `----
  66
  67 Stop the bridge:
  68
  69   ,----
  70   | # grml-bridge stop
  71   `----
  72
  73 Note, your devices do not have an ip address, so you have to give them an ip address. You can do this with
  74
  75   ,----
  76   | ifconfig eth1 $IP_ADDR
  77   `----
  78
  79 .SH SEE ALSO
  80 .BR grml-ap (8),
  81 .BR grml-router (8).
  82 .SH AUTHOR
  83 grml-bridge was written by Ulrich Dangel <mru@grml.org> and Michael Prokop <mika@grml.org>.
  84 .PP
  85 This manual page was written by Michael Prokop
  86 <mika@grml.org> for the Debian project (but may be used by others).