====== Running Roofnet ======

===== Building from sources =====

This tutorial assumes that you have an Atheros-based wireless interface and the [[http://madwifi.org/|madiwifi]] drivers properly installed and configured. Roofnet sources are currently available as part of the [[http://www.read.cs.ucla.edu/click|Click]] modular router. Click sources are maintained in a [[http://git.or.cz/|git]] repository. Git is a distributed source control management system. 

First, download and install git (ready-to-install packages are available for the most common Linux distributions). Then use the following command to fetch the Click sources from the repository into a local directory called //src// inside your home directory (~): 
sr2.click
  git clone git://read.cs.ucla.edu/git/click ~/src/click

To fetch the Click packages:

  git clone git://read.cs.ucla.edu/git/click-packages ~/src/click-packages

Create a link to the roofnet package in the click/elements:

  ln -s ~/src/click-packages/roofnet/ ~/src/click/elements/

Enter the Click directory and run the configure script:

  cd ~/src/click
  ./configure --enable-wifi --enable-roofnet --disable-linuxmodule --enable-userlevel

Finally run make:

  make

After the compilation process has been completed, you can install it with

  make install
===== Running Roofnet =====

As ''root'' user, run the Roofnet configuration script:

  cd conf/wifi
  sudo ./gen_config_roofnet.sh | click -

At this point running ''/sbin/ifconfig'' should show a new tap interfaces called ''srcr2'', which is configured as 6.X.X.X and uses multi-hop routing.