/* 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 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 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 OPTIONAL: Command -> $sudo ./compile_optional_apps [Step 3 - Installation] ----------------------- Command -> $sudo ./install OPTIONAL: 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 OPTIONAL: [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