An open API service indexing awesome lists of open source software.

https://github.com/allow2/allow2openwrt

Allow2 enabled control plugin for openWRT
https://github.com/allow2/allow2openwrt

Last synced: 6 months ago
JSON representation

Allow2 enabled control plugin for openWRT

Awesome Lists containing this project

README

          

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

```sh
git clone https://github.com/Allow2/Allow2OpenWRT.git
```

into a suitable location outside of the openwrt home directory.

(This will be the <Allow2OpenWRT> directory)

3. link the allow2 packages into the openwrt/packages directory

```sh
cd <openWRTBuildroot>/Packages

ln -s <Allow2OpenWRT>/allow2/ .
ln -s <Allow2OpenWRT>/allow2d/ .
ln -s <Allow2OpenWRT>/liballow2/ .
```

4. 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:

```sh
make package/allow2/compile
make package/allow2d/compile
```

5. Install on your router

3) install luci-allow2

TBA - write this bit

4) add openWRT packages

5) compile

make V=99

6) install on your router