README.external

BATMAN-ADV external module
--------------------------

The  batman-adv  module  is  shipped  as part of the Linux kernel
and as external module. The external  module   allows   to    get
new    features without  upgrading  to  a  newer  kernel  version
and to get batman-adv specific bugfixes  for  kernels  that   are
not   supported   anymore.  It compiles  against  and should work
with Linux 2.6.29 -   3.12.  Supporting  older  versions  is  not
planned,  but it's probably easy to backport it. If you work on a
backport, feel free to contact us.  :-)

COMPILE
-------

To compile against your currently installed  kernel, just type:

# make

if you want to compile against some other kernel, use:

# make KERNELPATH=/path/to/kernel

if you want to install this module:

# sudo make install

DKMS
----
To simplify rebuilding of the  module after a kernel upgrade, the
DKMS (Dynamic Kernel Module Support) system can be used.

For Debian/Ubuntu:
# apt-get install linux-headers dkms
# git clone https://github.com/freifunk-gluon/batman-adv-legacy /usr/src/batman-adv-legacy-2013.4.0
# dkms add -m batman-adv-legacy -v 2013.4.0
# dkms build -m batman-adv-legacy -v 2013.4.0 && dkms install -m batman-adv-legacy -v 2013.4.0 --force

The  last line must  be run  whenever a  kernel upgrade  has been
installed. It  can also be added to  something like /etc/rc.local
so that it is executed on every reboot. It doesn't do anything if
the module is already built and installed for the current kernel.

To remove module from DKMS:
# dkms remove -m batman-adv-legacy -v 2013.4.0 --all

CONFIGURATION
-------------

The     in-kernel    module    can    be    configured    through
menuconfig.   When  compiling outside  of the kernel tree,  it is
necessary  to  configure  it  using    the   make  options.  Each
option  can be set to to y (enabled), n (disabled) or m (build as
module).  Available  options  and  their    possible   values are
(default marked with an "*")

 * CONFIG_BATMAN_ADV_DEBUG=[y|n*] (B.A.T.M.A.N. debugging)
 * CONFIG_BATMAN_ADV_BLA=[y*|n] (B.A.T.M.A.N. bridge loop avoidance)
 * CONFIG_BATMAN_ADV_DAT=[y*|n] (B.A.T.M.A.N. Distributed ARP Table)
 * CONFIG_BATMAN_ADV_NC=[y|n*] (B.A.T.M.A.N. Network Coding)

e.g., debugging can be enabled by

# make CONFIG_BATMAN_ADV_DEBUG=y

Keep  in  mind  that  all  options  must  also  be added to "make
install" call.