A flexible ad hoc networking solution for transient environments.
C Java Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Project: LifeNet - A Platform to Build Customized MANET's
Developers: Hrushikesh Mehendale, Ashwin Paranjpe, Santosh Vempala
Georgia Institute of Technology, Atlanta, USA

Last updated - 27 Jun 2011

1. Description of code

    LifeNet --> applications/ - this directory contains 7 applications (Sniffer, Injector, Network visualization, Communicator, File Transfer, ArpUpdater, PathTraceLogger)
        --> config/       - this directory contains configuration information that is generated during installation
        --> firewall/     - this directory contains iptables scripts for automated gateway configuration
        --> src/          - this directory contains the code for LifeNet Kernel Module
        --> scripts/      - this directory contains executable scripts that are used to start and stop LifeNet and its applications
        --> openwrt/      - this directory contains the source and configuration files required for compilation on and installation on OpenWRT platform
        --> configure
            - this executable script is used for configuring LifeNet before compilation and installation
        --> compile
            - this executable script is used for compiling LifeNet after configuration and before installation
        --> compile_optional_apps
            - this optional executable script is used for compiling additional LifeNet applications
        --> install
            - this executable script is used to install LifeNet after configuration and compilation
        --> install_optional_apps
            - this optional executable script is used to install additional LifeNet applications
        --> clean
            - This script clears the build artifacts of the core Lifenet code
        --> clean_additional_apps
            - This script clears the build artifacts of the additional Lifenet applications' code
2. Compatibility

LifeNet supports and has been fully tested on the following operating systems:

- Ubuntu Linux distributions including and after 8.04
*NOTE: We have not tested Lifenet on latest Ubuntu versions running a 3.0+ kernel.

- Kubuntu Linux distributions including and after 8.04
*NOTE: We have not tested Lifenet on latest Kubuntu versions running a 3.0+ kernel.

LifeNet can also work on other Linux distributions. However, the developers haven't yet fully tested LifeNet onto Linux distros other than those mentioned above. Please feel free to try it out on other Linux distributions that you may have and email your feedback to any of the following with 'LifeNet feedback' as your email subject:
- hrushi@gatech.edu
- ashwin.p@gatech.edu
- vempala@cc.gatech.edu

3. Installation guide

You need to know the following information before you start the installation:
a. Name of your Wifi network interface
b. Name of your Ethernet network interface

[Step 1 - Configuration]

	Command -> $sudo ./configure

[Step 2 - Compilation]

	Command -> $sudo ./compile

	Command -> $sudo ./compile_optional_apps

[Step 3 - Installation]

	Command -> $sudo ./install

	Command -> $sudo ./install_optional_apps

[Step 4 - LifeNet commands]
Once the above mentioned 3 steps are successfully executed, you can use the following commands: 

[Starting LifeNet]
	Command -> $lifenet_start

[Stopping Lifenet]
	Command -> $lifenet_stop

[Starting Network Visualization]
	Command -> $lifenet_visualize

[Starting LifeNet Communicator]
	Command -> $lifenet_chat

[Starting File Transfer Client]
	Command -> $lifenet_ftp

4. Known issues

a. LifeNet requires the Wifi network adapters to function in ad-hoc mode. It may be possible that your machine uses proprietary drivers for Wifi network adapters that do not support adhoc functionality. In that case, LifeNet will not function on your machine. LifeNet has been successfully tested with the following WiFi network drivers:
- iwl family like iwl3945
- madwifi