======================
OPT_BCRELAY 0.4
======================

Einfhrung
==========

bcrelay ist ein Tool, was in einem internen Netz an bestimmten Ports
lauscht und dort empfangene Broadcast-Pakete auf andere Interfaces
kopiert.

Es ist vor allem in einem VPN ntzlich, da dort oft Broadcasts auf-
treten, um andere Rechner zu "entdecken". Dadurch dass Broadcasts in 
einem VPN nicht weitergeleitet werden, "finden" sich manche Programme 
nicht von alleine und da einige davon keine Mglichkeit bieten direkt 
eine IP anzugeben, ist bcrelay hier die Lsung.

Dieses OPT baut auf einem c't-Artikel (22/02 S. 222 *g*) und einigen
Beitrgen aus der Fli4l.games-Newsgroup auf und ist alles in allem nur
eine Zusammenstellung vorhandener Tools mit einem minimalen Skript fr
besseren Komfort.

Folgende Software wurde erfolgreich getestet:
* Warcraft III - Reign Of Chaos
* Quake III

Nicht viel, aber prinzipiell, sollte BCRELAY auch mit anderen Program-
men funktionieren.

bcrelay luft ab Fli4l 2.0.x , es funktioniert auch unter dem z.Zt.
aktuellen 2.0.8 einwandfrei.

Anleitung
=========

Mit OPT_BCRELAY=yes wird das OPT auf dem Router installiert (es bentigt
ca. 8 Kilobyte)

BCRELAY_INTERNALNET gibt das interne Netz an welches mit den ppp-
Interfaces die Broadcasts austauscht. Standardmig ist hier eth0
vorgegeben, was in 99% aller Flle auch richtig sein sollte.

BCRELAY_ISDNHACK schaltet die ISDN-Untersttzung ein bzw. aus...
Hintergund ist der, dass bei einem ISDN-Router (also ein Router, der
ber
ISDN ins Internet geht) vermutlich der erste VPN-Benutzer ppp0 als
Interface bekommt, wohingegen bei DSL das ppp1 wre... Ich kann das
nicht
berprfen, denn ich hab kein ISDN.
Fazit: Wer einen ISDN-Router mit einem VPN betreibt, sollte hier yes
angeben, ansonsten bei no (ist auch der Standard) belassen.

BCRELAY_PORT_1='6112'	# Relaying to enable Warcraft3
BCRELAY_PORT_2='27960'	# Relaying to enable Quake3
BCRELAY_PORT_3='137'	# Relaying NetBIOS Name Service (nbname) 
BCRELAY_PORT_4='138'	# Relaying NetBIOS Datagram Service (nbdatagram)

Die Anzahl der entsprechenden Ports muss dann in BCRELAY_PORT_N gemacht
werden (so z.B. wenn obige Ports relayed werden sollen dann 4)

Ich habe Warcraft3 in einem VPN (mittels OPT_VPN) getestet und es klappt
bei mir problemlos (mittels dem "fwrules-Trick" siehe unten).

History
=======
0.1  erstes Release (naja... fr mich :))
0.2beta variables internes Netzwerkinterfaces und "ISDN-Support"
   erstes offizielles Release
0.3beta beliebige Ports zum relayen einstellbar dank Lutz Lisseck
0.3 endlich verffentlicht und customs hinzugefgt
    Source fr BCRELAY hinzugefgt; liegt unter src
    gewisse Statusinformationen werden beim Booten angezeigt
0.4 Fehler im rc-Skript beseitigt, der eine ordnungsgeme
    Funktion von BCRELAY_PORT_n verhinderte (Danke an Lutz...)

to-do
=====
* englische Doku... bin immer noch zu faul.
* webinterface fr mini_httpd (kommt...)

FAQ
===
F:Es klappt nicht.
A:Fgen Sie
"ipchains -I forward -s 192.168.0.0/24 -d 192.168.0.0/24 -j ACCEPT"
als letzte Zeile (OHNE Anfhrungsstriche) in die Datei 
opt/etc/rc.d/fwrules ein, BEVOR sie die Fli4l-Diskette erstellen.

F:Spiel/Software X funktioniert bei mir nicht, knnen Sie den Support
bei der nchsten Version von OPT_BCRELAY einbauen?
A:Wenn ein Spiel/Software mit fli4l nicht funktioniert, kann das sehr
sehr viele Grnde haben. BCRELAY bringt nur etwas, wenn mangelnde
Broadcasts die Ursache sind. Mit anderen Worten, wenn sie in Ihrer
Software/Spiel keinerlei Mglichkeit haben, direkt eine IP-Adresse
einzugeben, dann knnte bcrelay helfen.

Bugs & Kontakt
==============
Allzu viele Bugs sollten aufgrund der unglaublichen Einfachheit des
Skripts ja nicht auftreten, aber man weiss ja nie... Wer Fragen &
Verbesserungsvorschlge hat, der mge mir eine email an
christian.ulbrich@gmx.de schicken.