---------------------------------------------------------------------
QUAGGA PLUGIN FOR OLSRD
by Immo 'FaUl' Wehrenberg <immo@chaostreff-dortmund.de>

addittions by:	Sven-Ola Tuecke <sven-ola-aet-gmx.de>
	 	Vasilis Tsiligiannis <acinonyxs@yahoo.gr>
---------------------------------------------------------------------

This is the Quagga Plugin for OLSRd.
It allows OLSRd to redistribute from various quagga-protocols
as well as to export olsr-routes to quagga so that they can be
redistributed by the quagga-routing-daemons.

You also need a source distribution of quagga-0.98.6 or quagga-0.99.21.
The quagga source tree needs to be patched with quagga-0.98.6.diff or
quagga-0.99.21.diff, respectively, compiled and installed via
'make install'.

---------------------------------------------------------------------
PLUGIN PARAMETERS (PlParam)
---------------------------------------------------------------------

PlParam "Redistribute" "<protocol>"
	where protocol is one of the following:
	system, kernel, connect, static, rip, ripng, ospf, ospf6,
	isis, bgp, hsls
	May be used more then once

PlParam "ExportRoutes" "<only/additional>"
	exports olsr-routes to quagga only, or to quagga and kernel
	no routes are exported to quagga (normal behaviour) if not set.

PlParam "LocalPref" "<true/false>"
        sets the Zebra SELECTED-flag on the routes exported to zebra
	which means these routes are prefered in any case.

PlParam "Distance" "0-255"
        allows to set the administrative distance to routes exported 
	to zebra.

PlParam "SockPath" "<path>"
        sets the path to zebra socket
	defaults to "/var/run/quagga/zserv.api" if not set.

PlParam "Port" "<port>"
        sets the port on which zebra is listening
	overrides 'SockPath' parameter if set.

PlParam "Version" "<version>"
        sets the version of packet format to communicate with zebra.
	use:
	   "0" for Quagga 0.98.x
	   "1" for Quagga 0.99.17 up to 0.99.20.1
	   "2" for Quagga 0.99.21 and above
	defaults to "0".

---------------------------------------------------------------------
SAMPLE CONFIG
---------------------------------------------------------------------

add in /etc/olsrd/olsrd.conf:

LoadPlugin "olsrd_quagga.so.0.2.2"
{
	PlParam "Redistribute" "ospf"
	PlParam "Redistribute" "bgp"
	PlParam "ExportRoutes" "only"
	PlParam "Distance" "125" 
	PlParam "LocalPref" "false"
	PlParam "SockPath" "/var/run/zserv.api"
	PlParam "Version" "2"
}


---------------------------------------------------------------------
EOF / 31.05.2012
