-.TH grml-bridge 8
-.SH "NAME"
-grml-bridge \- set up your box as bridge
-.SH SYNOPSIS
-.B grml-bridge
-.RI " start|stop|restart|info "
-.SH DESCRIPTION
-This manual page documents briefly the
-.B grml-bridge
-command.
-.SH USAGE
-Configure setup via configuration file /etc/grml/routersetup.
-To specify which DEVICES should be bridged, use BRIDGE_DEVICES, e.g.
-
- BRIDGE_DEVICES="eth0 eth1"
-
-would bridge device eth0 and eth1.
-Note: The auto interface name is not allowed here!
-
-To specify the name of the bridge, use BRIDGE_NAME, e.g.
-
- BRIDGE_NAME="br0"
-
-Note: this entry is optional, per default the name br0 is choosen.
-
-If you want do disable Spanning Tree Protocol (STP) on your bridge, just set BRIDGE_STP to no, e.g.
-
- BRIDGE_STP="no"
-
-Per default stp is on.
-
-Example Configuration file:
-
- ,----[ /etc/grml/routersetup ]
- | # Bridges eth0 and ath0 together
- | BRIDGE_DEVICES="eth0 ath0"
- |
- | # Bridge name is grml-bridge
- | BRIDGE_NAME="grml-bridge"
- |
- | # Disable stp
- | BRIDGE_STP="no"
- `----
-
-Start the bridge:
-
- ,----
- | # grml-bridge start
- `----
-
-Now, your bridging device is up and running. Now you have to set the ip address of
-your bridged devices to 0.0.0.0. You can do this with following command:
-
- ,----
- | source /etc/grml/routersetup
- | for i in $BRIDGED_DEVICES ; do ifconfig $i 0.0.0.0 ; done
- `----
-
-Now your bridge is working. If you want that your bridge is reachable, please
-give your bridge an ip adress. You can do this for example with
-
- ,----
- | ifconfig grml-bridge 192.168.0.1
- `----
-
-Stop the bridge:
-
- ,----
- | # grml-bridge stop
- `----
-
-Note, your devices do not have an ip address, so you have to give them an ip address. You can do this with
-
- ,----
- | ifconfig eth1 $IP_ADDR
- `----
-
-.SH SEE ALSO
-.BR grml-ap (8),
-.BR grml-router (8).
-.SH AUTHOR
-grml-bridge was written by Ulrich Dangel <schula@grml.org> and Michael Prokop <mika@grml.org>.
-.PP
-This manual page was written by Michael Prokop
-<mika@grml.org> for the Debian project (but may be used by others).