Switch branches/tags
Nothing to show
Find file History
Pull request Compare This branch is even with develop.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
.gitignore
GPL2
Makefile
README.md
authenticator.c
authenticator.h
create_authorized_host_db.sh
fdb.c
fdb.h
iptables.sh
libpathresolver.c
libpathresolver.h
port.c
port.h
redirectable_routing_switch.c
redirectable_routing_switch.conf
redirectable_routing_switch.h
redirectable_routing_switch_null.conf
redirector.c
redirector.h

README.md

Redirectable routing switch

REDIRECTABLE ROUTING SWITCH IS AN EXPERIMENTAL IMPLEMENTATION AND MAY NOT BE FULLY FUNCTIONAL. IF YOU ARE NOT FAMILIAR WITH C AND SQL, WE STRONGLY DO NOT RECOMMEND YOU TO RUN THIS APPLICATION.

What's this?

This directory includes an OpenFlow controller that emulates a single large layer 2 switch consists of arbitrary number of OpenFlow switches with a redirection function. The redirection function allows us to redirect traffic coming from unauthorized hosts to controller's local IP protocol stack. By redirecting traffic, for example, you can direct any HTTP requests from authorized host to a specific web server by combining this application and iptables.

How to build

Get Trema and Apps

    $ sudo gem install trema
    $ git clone git://github.com/trema/apps.git apps

Build topology

    $ cd ./apps/topology
    $ make
    $ cd ../..

Build redirectable routing switch and create authorized host database

    $ cd ./apps/redirectable_routing_switch
    $ make
    $ ./create_authorized_host_db.sh
    $ sqlite3 ./authorized_host.db

Add authorized hosts (mac address and description pairs) manually

    sqlite> insert into authorized_host values (1,"alice's PC");
    sqlite> insert into authorized_host values (2,"bob's PC");
    sqlite> .quit

How to run

    $ sudo trema run -c ./redirectable_routing_switch.conf

License & Terms

Copyright (C) 2008-2013 NEC Corporation

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Terms

Terms of Contributing to Trema program ("Program")

Please read the following terms before you submit to the Trema project ("Project") any original works of corrections, modifications, additions, patches and so forth to the Program ("Contribution"). By submitting the Contribution, you are agreeing to be bound by the following terms. If you do not or cannot agree to any of the terms, please do not submit the Contribution:

  1. You hereby grant to any person or entity receiving or distributing the Program through the Project a worldwide, perpetual, non-exclusive, royalty free license to use, reproduce, modify, prepare derivative works of, display, perform, sublicense, and distribute the Contribution and such derivative works.

  2. You warrant that you have all rights necessary to submit the Contribution and, to the best of your knowledge, the Contribution does not infringe copyright, patent, trademark, trade secret, or other intellectual property rights of any third parties.

  3. In the event that the Contribution is combined with third parties' programs, you notify to Project maintainers including NEC Corporation ("Maintainers") the author, the license condition, and the name of such third parties' programs.

  4. In the event that the Maintainers incorporates the Contribution into the Program, your name will not be indicated in the copyright notice of the Program, but will be indicated in the contributor list on the Project website.