Skip to content

Latest commit

 

History

History
87 lines (50 loc) · 1.94 KB

README.md

File metadata and controls

87 lines (50 loc) · 1.94 KB
Raw

Allow2 modules for OpenWRT

This is a first build demonstrating one way to incorporate Allow2 into a router firmware.

This was built and tested with OpenWRT on a Netgear WNDR3700.

Architecture

The solution has been built with 3 primary components.

  1. allow2d - daemon process

    User-space daemon responsible for managing the cached settings via the allow2deviceAPI and responding to requests from the kernel module.

  2. allow2 - kernel module

    Kernel module responsible for intercepting packets and requesting directions from the userspace component

  3. liballow2

    (under development) - extracted library for leveraging the allow2 platform within other processes

To use the allow2 packages

  1. download and configure the OpenWrt Buildroot

    Follow the instructions:

    http://wiki.openwrt.org/doc/howto/build

    (This will be the <openWRTBuildroot> directory)

  2. clone this repo

    git clone https://github.com/Allow2/Allow2OpenWRT.git
into a suitable location outside of the openwrt home directory.

(This will be the &lt;Allow2OpenWRT> directory)
  1. link the allow2 packages into the openwrt/packages directory
      cd &lt;openWRTBuildroot>/Packages

      ln -s &lt;Allow2OpenWRT>/allow2/ .
      ln -s &lt;Allow2OpenWRT>/allow2d/ .
      ln -s &lt;Allow2OpenWRT>/liballow2/ .

  1. follow the instructions for building OpenWrt or individual packages

    Use "make menuconfig" to configure the allow2 packages to build:

    • Kernel Modules -> Netfilter Extensions -> kmod-allow2
    • Libraries -> liballow2
    • Utilities -> allow2d

    Alternately, making individual packages would be:

      make package/allow2/compile
      make package/allow2d/compile
  1. Install on your router
  1. install luci-allow2

TBA - write this bit

  1. add openWRT packages

  2. compile

make V=99

  1. install on your router